SIEBEL助手
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:598791747@qq.com
?
?
版本更新
版本：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.??????對于數據量較大的導出，可以使用快速拷貝全部數據，快速拷貝選中數據來進行導出。
?
總結
