Siebel助手
用
戶
手
冊
黃福強/Johnny Huang
版本號：V2.0 Beta版
序 言
該軟件是基於Microsoft .NETFramework開發的一個針對Siebel CRM的工具,使用Siebel提供的標準API，對Siebel對象進行操作。
目前實現的功能有：
【地址信息助手】可以按項目管理地址信息，應用地址信息可以直接使用IE或默認瀏覽器打開，數據庫地址信息可以生成tnsnames.ora，操作系統地址信息可以直接打開遠程桌面進行連接。
【被鎖對象查詢助手】可以查看當前所有被鎖住的對象，可以設定多條件查詢，如果發現有鎖住對象的顧問已經不在場，可以強制解鎖該對象，支持批量解鎖對象。
【腳本查詢助手】對於技術負責人，需要對項目上的代碼進行Review，該功能可以按開發人員、時間、對象名進行Review；對於技術顧問，基本上在每個項目都要寫很多代碼，該功能可以方便收集項目上的代碼，並以Excel或者文件形式進行歸檔。也可通過多個條件組合快速查詢代碼。
【查詢助手】 該功能可以選擇同一個BC下的ListApplet和Form Applet上面的字段，導出數據。並可設置查詢條件，獲取執行SQL，避免了打開Tools進行Debug的繁瑣，可設置無數據的查詢條件快速獲取查詢SQL。
【數據導入工具】該功能可以實現數據的導入，操作簡單，錯誤信息比較明瞭，可以進行增加，修改，刪除，查詢功能，並可選擇事務操作，多用戶執行。用戶只需在首次使用時進行簡單的配置,即可進行數據導入。
【嚮導生成配置文件】該功能可以通過界面配置的形式，生成導入工具所需要的配置文件和數據模板。
文檔部分內容未及時更新請見諒。下載地址：http://download.csdn.net/detail/hfq_1991/9407700
如果您在使用該軟件遇到問題，請您Email:[email protected]
版本更新
版本：1.0 時間：2013-12-20
其主要功能有：
Ø 對任何單個BC或者多層結構的BC進行數據新建。
Ø 對任何單個BC或者多層結構的BC進行數據更新或者新建。
Ø 對任何單個BC或者多層結構的BC進行數據更新。
Ø 對任何單個BC或者多層結構的BC進行數據刪除。
Ø 對任何單個BC或者多層結構的BC進行數據查詢。
Ø 對查詢數來的數據，或者處理以後的數據保存爲Excel、Html、XML內容。
Ø EAI事務的處理，多用戶處理，相當於多個用戶同時登陸
Ø 對導入過程的實時監控
版本1.1 時間2014-04-30
更新記錄：
A. 新增功能:界面嚮導生成導入所需的配置文件和數據模板
B. 新增功能：可以根據界面上的字段生成所需的數據，包括List Applet和Form Applet
C. 修復數據混亂照成的數據丟失問題
D. 時間條點擊彈出平均速度，預計剩餘時間。進度條點擊彈出導入進度
E. 數據導入情況界面添加導出錯誤數據，統計未操作數據
F. 修復多次導入不同數據文件，列混亂的情況
G. 修復導入Excel數據，數字較大時，產生科學計數法問題
H. 增加非事務操作，可根據定義來執行
I. 修復查詢數據帶有單引號出現錯誤但是未顯示爲錯誤信息
J. 優化查詢助手，嚮導生成配置文件選擇下拉框更加流暢
K. 支持導入xlsx格式的數據
版本1.2 時間2014-06-14
更新記錄：
A. 新增功能：腳本查詢助手，可以直接把項目上的代碼導出成Excel格式和文件格式。方便管理、收集項目上的代碼
B. 界面多種風格切換，優化界面提示信息
C. 修復極個別情況導入第一列無法被識別爲標題行
D. 打開界面默認出現類似Excel的界面
E. 導入結束默認只顯示失敗數據，可以切換顯示數據模式
版本1.3 時間2014-07-07
A. 新增功能：被鎖對象查詢助手，可以查看當前所有被鎖住的對象，可以設定多條件查詢，如果發現有鎖住對象的顧問已經不在場，可以強制解鎖該對象，支持批量解鎖對象。
B. 美化表格控件，增加右鍵菜單選擇
C. 修復數據文件載入失敗，計時器沒有停止
D. 修復沒有安裝Siebel Tools直接要求退出的情況
版本2.0 時間2014-07-17
A. 更新頁面風格
B. 腳本助手列可以拖動，並增加查看腳本功能，該功能可以非常清晰的對代碼格式進行檢查
C. 查詢助手添加查看執行SQL功能，免去打開Tools進行Debug的繁瑣，可以設置空查詢快速獲取SQL。
D. 數據導入情況增加錯誤信息彙總視圖
E. 添加地址信息助手，可以按項目維護應用地址信息，數據地址信息等
軟件安裝與初始化
軟件下載地址：
l 下載軟件安裝包,然後點擊安裝即可。
l 安裝過程如果提示需要.Net3.5，可以在上面地址找到安裝文件，Win7下自帶.Net3.5，無需該步；window2008可直接在【服務器管理-功能】添加.Net3.5。
l 安裝完成，可看到界面如下
操作說明
【地址信息助手】
該功能主要可以按項目管理常用的地址信息，包括Siebel應用地址、數據庫地址信息、操作系統地址、SVN地址等。在記錄上右擊可以看到菜單，應用地址信息可以直接使用IE或默認瀏覽器打開，數據庫地址信息可以生成tnsnames.ora，操作系統地址信息可以直接打開遠程桌面進行連接。
通過【地址信息助手】打開，可以看到如下界面。默認會把最新修改過的項目排在最前面，可自行點擊列進行排序。如果需要備份或遷移，可以拷貝【安裝路徑：/ Siebel助手/Data/ SystemInfo.db】到相同目錄下即可。
【被鎖對象查詢工具】
該功能主要可以直觀展現目前項目上被鎖住的對象，瞭解目前每個顧問正在操作的對象，按鎖住時間倒序，還可以設定多條件查詢，如果發現有鎖住對象的顧問已經不在場，可以強制解鎖該對象，支持批量解鎖對象。
從【被鎖對象查詢助手】打開，可以看到如下界面，該數據庫連接信息在整個系統是共用的，維護後點擊保存到本地可以方便以後使用。
關鍵信息說明：
該界面的信息可以參考本地Oracle客戶端下tnsnames.ora文件。
名稱：本地數據連接名稱，方便自己識別即可
數據庫IP：對應tnsnames.ora裏面的HOST
數據庫端口：對應tnsnames.ora裏面的PORT
數據庫名：對應tnsnames.ora裏面的SERVICE_NAME
用戶名/密碼：有權限能夠訪問SIEBEL用戶對應對象的數據庫用戶名密碼
點擊加載數據，如果加載成功則會在後臺查詢數據，看到如下界面。
該界面共有六個字段：序號、對象名稱、對象類型、語言、操作用戶、對象被鎖時間。默認是按對象被鎖時間排序的，可以通過點擊列名進行排序。可以設定多個字段組合查詢，設置完查詢條件後除了可以通過查詢按鈕查詢，還可以直接在文本框內進行回車查詢。
如果由於某些原因，需要強制解鎖某些對象，可以直接選中這些對象，通過點擊‘強制解鎖’按鈕或者右鍵選擇‘強制解鎖’菜單進行強制解鎖。該操作會導致操作對象的顧問不能正常的Check In，請謹慎操作。
如果需要返回重新設置連接信息，可以右鍵選擇‘設置連接’菜單。
【腳本查詢助手】
對於技術顧問，基本上在每個項目都要寫很多代碼，該功能可以方便收集項目上的代碼，並以Excel或者文件形式進行歸檔。也可通過多個條件組合快速查詢代碼。
從【腳本查詢助手】打開，可以看到如下界面，該數據庫連接信息在整個系統是共用的，維護後點擊保存到本地可以方便以後使用。
點擊加載數據，如果加載成功則會在後臺查詢腳本數據，默認顯示一年內有修改的腳本，看到如下界面。
該界面共有九個字段：序號、對象名稱、對象類型、最後更新時間、創建時間、最後更新用戶、創建用戶、方法名稱、腳本。默認是按最後更新時間排序的，可以通過點擊列名進行排序，可以拖寬行查看腳本具體內容。下圖是查詢‘腳本內容帶有Johnny Huang 並且是2014年五一之後創建’的腳本。設置完查詢條件後除了可以通過查詢按鈕查詢，也可以直接在文本框內按回車查詢。
查詢到結果後，可以直接右擊一條記錄，選擇查看腳本，該功能對間距進行放大，可以非常直觀看出代碼格式是否規範，對於那些用空格而沒有用Tab對齊的代碼可以非常清楚的看出差別；該功能可以方便技術負責人進行代碼的Review。
Tools下查看的效果：
對於查詢結果，還可以點擊導出Excel或文件歸檔，把腳本導出。
【查詢助手】
例子I-員工
如果業務顧問需要導出界面上的數據，可以通過【查詢助手】實現。可以選擇List Applet和Form Applet上面的字段，進行導出操作。
例如：在員工界面，我們想導出List Applet上面的姓氏、名稱、用戶ID、職位；FormApplet上面的辦公電話號碼，電子郵件。
第一步：選擇數據庫連接，加載數據
從【查詢助手】打開，可以看到如下界面
1. 該數據庫連接信息在整個系統是共用的，維護後點擊保存到本地可以方便以後使用。
2. 點擊加載數據源，判斷數據源是否加載成功，並加載後續數據信息
3. 如果加載成功，點擊下一步
第二步：選擇要查詢的Applet對應的BO，BC，然後選擇List Applet和Form Applet，獲取字段
1. 該步驟選擇BO後，會列出該BO下的BC；選擇BC後，會列出所有基於該BC的List Applet和Form Applet。選擇完後，點擊獲取字段，就可以看到界面上的字段。如下圖：
2. 如果只需要選擇一個Applet，另一個不要選擇即可。
3. 如果字段太多，不能快速定位，可以通過下面的搜索框實現快速查找記錄
4. 如果查找之後發現存在相同顯示值的記錄，例如搜索職位發現有兩個職位，可以點擊字段名，查看顯示值對應的字段名。
5. 添加完所需要字段，點擊下一步
第三步：設置EAI的連接信息
該EAI連接信息在整個系統是共用的。
1. 填寫好配置文件信息後，可以保存到本地，方便下次使用
2. 點擊測試連接按鈕，查看測試連接是否成功
3. 連接成功後，點擊下一步
第四步：查看查詢結果，導出Excel
查詢後發現有4162條記錄，到員工界面進行計數統計，結果數量一致，導出爲Excel。
第五步：查看執行SQL
點擊查看執行SQL，可以查看本次查詢使用的SQL語句。設置一個無數據的查詢條件，可以快速獲取查詢SQL語句，免去打開Tools進行Debug的漫長等待，
【嚮導生成配置文件】
例子I-職位
如果是第一次導入，需要進行配置文件的生成，然後在生成的Excel模板維護好數據，即可進行導入操作。導入操作可見【數據導入工具】。配置文件是導入必須的文件，該文件存儲了要配置的對象，對象之間的關係，服務器EAI的連接信息等。
例如：導入職位(BO：Position，BC：Position)，需要導入的字段
l 職位名字(Field：Name直接導入)
l 部門(Field：Division，動態picklist，通過部門名稱Name進行搜索)
l 姓氏(Field：Last Name，MVG,通過員工的登陸名Login Name來搜索)
第一步：選擇數據庫連接，加載數據
從【嚮導生成配置文件】打開，可以看到如下界面，該界面可以維護數據庫連接的信息，該信息可以保存在本地，方便下次操作直接選擇。
1. 該數據庫連接信息在整個系統是共用的，維護後點擊保存到本地可以方便以後使用。
2. 點擊加載數據，如果提示“加載成功，進行後續操作”則繼續，否則說明數據庫連接信息有錯誤。
3. 選擇要導入的對象對應的BO名稱，比如選擇Position
4. 選擇要導入的對象對應的BC名稱，比如選擇Position，該操作只能選擇到上一步選擇的BO下維護的BC。
5. 維護完成點擊下一步
第二步：選擇本次操作要使用到的字段
如果字段太多，可以通過搜索框進行搜索，快速選擇到需要的字段。例如本次操作需要用到的字段有：職位名字Name、部門Division、主要聯繫人姓氏Last Name，選擇完所需要的數據後，點擊下一步
第三步：選擇本次操作要用到的單值字段
上一步選擇完要操作的字段後，對於單值字段、動態picklist字段、mvg字段處理方式不一樣，所以需要分開進行選擇；該步選擇本次操作用到的單值字段，如果是需要進行修改、查詢或刪除操作，則需要指定具體根據那幾個字段來作爲查詢條件。
第四步：選擇本次操作要用到的PickList字段
對於要導入的PickList字段，需要選擇該字段的查詢條件，通過查詢條件查詢後，選擇滿足條件的記錄，該查詢條件得到的結果最好只有一條，多條的話也只能選擇第一條，例如部門這個字段，我們利用部門BC的Name字段(名稱)來進行查詢。
1. 可以利用多個字段一起查詢，最多支持四個參數的查詢。
2. 設置完成點擊下一步
第五步：選擇本次操作要用到的MVG字段
對於要導入的MVG字段，需要選擇該字段的查詢條件，通過查詢條件進行查詢，對查詢結果進行操作。例如主要員工這個MVG，我們利用員工BC的Login Name字段(用戶ID)來進行查詢。
1. 對於每個MVG字段，可以利用多個字段一起查詢，最多支持四個參數的查詢。
2. 可以設置是否設爲主要
3. 可以設置是否刪除其他，對於查詢條件得到的結果如果不止一條，該字段不要設爲Y，否則刪除其他的操作得到的結果只有一條
4. 設置完成點擊下一步
第六步：設置EAI的連接信息
該EAI連接信息在整個系統是共用的。
1. 填寫好配置文件信息後，可以保存到本地，方便下次使用
2. 點擊測試連接按鈕，查看測試連接是否成功
3. 連接成功後，點擊下一步
關鍵字段說明
名稱：本地的EAI數據連接名稱，方便自己識別即可
連接地址：Siebel Server所在服務器IP
端口：EAI的端口
Enterprise：EnterpriseServer名稱
組件別名：所要導入的組件名稱
用戶數量：該數量也可以導入的時候，在菜單【編輯-設置用戶數量】進行設置，如果設置多個用戶，就相當於登陸多個用戶進行操作。如果導入數據量較大，可以把用戶數量設大點，但是要考慮服務器所能承受的最大任務數。
第七步：修改數據模板，生成配置模板
最後一步，我們要維護導入的數據模板，左邊列是要導入的字段名，右邊列是導入字段在Excel裏面對應的列名。該列名最好跟已經整理好的數據的列名一致，以免後續需要再次修改。
修改之後如下圖，對於BC的Name(職位)字段，直接把Excel裏列爲職位名稱的數據寫入；對於Division：Name(部門)字段，會先在部門BC利用Name字段進行搜索匹配，匹配條件爲‘Name={Excel裏列爲部門的數據}’；如果條件不止一個，比如部門是通過部門名稱和部門類型進行匹配的話，那還會有一列Division：Type(類型)，然後也需要維護對應Excel的列名。
修改之後點擊下一步，生成如下兩個文件
l Position_Config.ini爲配置文件
l Position.xlx爲數據模板
具體內容可看附件1
附件1
說明
1. 如果需要修改已經生成的配置文件，MVGField1對應的第一個Y/N表示是否設爲主要，第二個Y/N表示是否刪除其他。如下：
MVGField1=Organization,Y,N,Name,所屬組織;Position,N,Y,LoginName,銷售人員;
2. 對於選擇操作字段後的字段的分類是這樣的：BC上Field對應的PickList如果是動態的PickList，該字段爲PickList字段；如果該字段是MVF，則爲MVG字段。如果需要做一些特殊處理(如MVF的字段要當做單值字段，直接寫入值)，可以生成配置文件後手動修改配置文件。
【數據導入工具】
該功能在維也納項目上進行測試，維也納項目大部分數據都是使用該功能進行導入，其中數據量最大的客戶及協議達到35萬。對於沒有過多MVG和PickList字段的導入操作會比較快，決策人每分鐘大概2000條，企業客戶和協議每分鐘大概1000條。
修改界面風格
在界面的右上角，可以通過點擊風格下拉框，切換界面的風格，目前支持9種風格，可以根據個人喜歡切換不同的界面風格。
隱藏功能區
在界面的右上角，可以通過切換顯示和隱藏按鈕來控制菜單欄的狀態。
例子I-職位
生成配置文件和數據模板後，只需要維護數據文件的內容，添加三條數據用於測試
第一步：打開配置文件
可以利用嚮導生成，具體步驟看【生成配置文件和數據模板】
第二步：打開數據文件，打開後界面如下
第三步：測試連接，只有測試通過才能進行導入操作
選擇完配置文件和數據文件後，需要進行測試連接，判斷是否能夠成功連接，才能進行後續操作
如果在10秒內連接失敗，會提示連接超時，查看是否網絡或服務器未啓動等原因，再次點擊測試連接進行測試即可
第四步：選擇要執行的操作【編輯-新建數據】，根據列“導入是否成功”判斷數據是否導入。
執行操作前可以設置執行的用戶數量，該數量可以在菜單【編輯-設置用戶數量定義執行計劃】進行設置，如果設置多個用戶，就相當於登陸多個用戶進行操作。如果導入數據量較多，可以把用戶數量設大點，可以提升導入的速度，但是要考慮服務器所能承受的最大任務數。
導入成功的情況：導入完成默認只顯示失敗數據，可以在【數據-數據顯示】顯示所有數據
導入失敗的情況：可在菜單【數據-導出錯誤數據】後，處理數據在進行導入
l 如果需要查看導入的進行的情況，可以通過菜單【編輯-導入情況】查看導入過程，也可以通過雙擊導入進度條右邊導入的百分比進行查看；
第五步：提交事務或回滾事務
第六步：到界面或數據庫上查看導入的數據
結果跟預期的一樣。
導出數據
對於導入結果，可以導出爲Excel格式，CSV格式，Html格式，XML格式。
注：如果在導入過程發生錯誤，可以利用導出錯誤數據把沒導入成功的導出來，然後對這部分數據處理完後，再進行導入。導出的單元格均爲文本格式，防止類似0011導出後自動被轉化爲數字11。
說明
1. 如果遇到類似未在本地計算機上註冊“Microsoft.ACE.OLEDB.12.0”提供程序的錯誤。需要下載AccessDatabaseEngine.exe，下載地址在【軟件安裝】可以看到。
2. 在導入的過程如果想要暫停或中斷，在菜單【編輯-操作暫停】可以暫停操作，菜單【編輯-操作繼續】可以繼續操作，在菜單【編輯-操作停止回滾事務】可以中斷操作
3. 在軟件的左下角可以查看軟件的處理信息，右下角可以很直觀地查看導入的進度，導入所花費的時間。爲了避免過多彈窗，如果在點擊按鈕發現沒有反應，可以查看左下角給出的提示，或者打開日誌查看日誌信息。
4. 雙擊右邊的運行時間，可以顯示平均速度，剩餘未導入數量，預計剩餘時間
5. 除了進行導入操作，還可以進行修改、查詢、刪除操作，這些操作需要設定查詢條件定位到具體的記錄，所以需要設置查詢字段
6. 如果想要進行非事務的處理，可以在菜單【編輯-設定用戶數量定義執行操作】選擇要進行的操作類型後，點擊菜單【編輯-根據定義執行(無事務)】
7. 該導入功能需要系統有安裝Siebel Tools(非綠色版)、Siebel Client、Oracle Client，在裝有Siebel服務器的系統可直接使用。
8. 如果導入數據後，界面出現細微混亂，可以通過設置兼容性，以管理員打開解決該問題
9. 對於數據量較大的導出，可以使用快速拷貝全部數據，快速拷貝選中數據來進行導出。