鼎捷互聯中台-系統操作手冊.pdf

鼎捷互聯中台系統操作手冊DAP平台中心互聯中台技術部2目錄1.登入鼎捷互聯中台管理介面...........................................................................................................62.智能監控...........................................................................................................................................82.1.開啟智能監控畫面..............................................................................................................82.2.檢視智能監控圖表..............................................................................................................92.2.1.硬體資源使用率......................................................................................................92.2.2.產品連接狀態監控..................................................................................................92.2.3.中台運作狀態........................................................................................................103.整合紀錄查詢.................................................................................................................................113.1.開啟紀錄檢視功能畫面.....................................................................................................113.2.輸入查詢條件....................................................................................................................123.3.檢視紀錄內容....................................................................................................................133.4.檢視整合訊息內容............................................................................................................133.4.1.檢視原始訊息........................................................................................................143.4.2.檢視格式化訊息....................................................................................................153.4.3.檢視應用欄位........................................................................................................163.4.4.規範檢測................................................................................................................173.4.5.取得序列化內容....................................................................................................183.5.整合異常檢視....................................................................................................................193.5.1.整合紀錄查詢........................................................................................................193.5.2.異常檢視................................................................................................................193.5.3.視覺化檢視............................................................................................................193.6.手動重新回覆非同步請求................................................................................................214.流量統計查詢.................................................................................................................................224.1.開啟流量統計功能畫面....................................................................................................224.2.流量統計查詢....................................................................................................................235.整合產品監控.................................................................................................................................265.1.開啟整合產品監控功能畫面............................................................................................265.2.註冊產品立即檢測............................................................................................................275.3.檢視產品監測紀錄............................................................................................................276.產品維護.........................................................................................................................................296.1.開啟產品維護功能畫面....................................................................................................296.2.註冊整合產品....................................................................................................................316.3.刪除已註冊整合產品........................................................................................................3336.4.修改整合產品資訊............................................................................................................346.5.設定整合產品聯絡人........................................................................................................366.6.設定全產品編碼開關........................................................................................................376.7.加密設定............................................................................................................................396.8.設定FTP伺服器................................................................................................................416.9.設定預設主機....................................................................................................................437.服務註冊.........................................................................................................................................457.1.開啟服務註冊功能畫面....................................................................................................457.2.查詢已註冊服務................................................................................................................467.3.註冊服務............................................................................................................................477.4.刪除已註冊服務................................................................................................................487.5.修改已註冊服務資訊........................................................................................................498.整合設定.........................................................................................................................................509.整合訊息規範檢測.........................................................................................................................519.1.開啟整合訊息規範檢測功能畫面....................................................................................519.2.服務訊息檢測....................................................................................................................529.3.發起訊息檢測....................................................................................................................549.4.匯出檢測結果....................................................................................................................5810.資料轉換管理...............................................................................................................................6010.1.Job管理.............................................................................................................................6010.1.1.開啟Job管理功能畫面................................................................................................6010.1.2.查詢Job.........................................................................................................................6210.1.3.修改Job資訊................................................................................................................6210.1.4.立即執行Job.................................................................................................................6310.1.5.設置預設參數...............................................................................................................6410.1.6.設定WebService執行權限.........................................................................................6510.1.7.設定Job權限................................................................................................................6710.1.8.設定Job聯絡人............................................................................................................6910.1.9.設定執行主機...............................................................................................................7010.2.Job執行紀錄..............................................................................................................................7210.2.1.開啟Job執行紀錄功能畫面........................................................................................7210.2.2.查詢Job執行紀錄........................................................................................................7310.2.3.立即停止執行中Job.....................................................................................................7510.2.4.查詢Job執行步驟紀錄................................................................................................7710.2.5.查詢詳細轉換執行紀錄...............................................................................................78410.2.6.查詢詳細執行訊息.......................................................................................................7910.3.排程管理....................................................................................................................................8010.3.1.開啟排程管理功能畫面...............................................................................................8010.3.2.查詢排程資訊...............................................................................................................8110.3.3.新增排程資訊...............................................................................................................8110.3.4.修改排程資訊...............................................................................................................8410.3.5.刪除排程資訊...............................................................................................................8510.3.6.設定排程聯絡人...........................................................................................................8610.3.7.設定批次排程...............................................................................................................8710.4.排程執行紀錄............................................................................................................................8910.4.1.開啟排程執行紀錄功能畫面.......................................................................................8910.4.2.查詢排程執行紀錄.......................................................................................................9010.4.3.排程執行紀錄連結Job執行紀錄................................................................................9110.5.共用連線設定............................................................................................................................9210.5.1.開啟共用連線設定功能畫面.......................................................................................9210.5.2.修改共用連線設定.......................................................................................................9310.5.3.刪除共用連線設定.......................................................................................................9510.6.負載平衡伺服器管理................................................................................................................9610.6.1.開啟負載平衡伺服器管理功能畫面...........................................................................9610.6.2.新增負載平衡伺服器...................................................................................................9710.6.3.停用負載平衡伺服器...................................................................................................9810.6.4.刪除負載平衡伺服器...................................................................................................9810.7.ETL匯入匯出............................................................................................................................9910.7.1.開啟ETL匯入匯出功能畫面......................................................................................9910.7.2.ETL匯出......................................................................................................................10010.7.3.ETL匯入......................................................................................................................10310.8.ETL參數設定..........................................................................................................................10710.8.1.ETL執行引擎設定......................................................................................................10710.8.2.Log紀錄清除設定.......................................................................................................10811.帳戶管理......................................................................................................................................11111.1.開啟帳戶管理功能畫面.................................................................................................11111.2.新增帳戶.........................................................................................................................11211.3.修改帳戶資訊.................................................................................................................11411.4.重設密碼.........................................................................................................................115511.5.設定帳戶角色.................................................................................................................11611.6.刪除帳戶.........................................................................................................................11711.7.測試通知工具.................................................................................................................11712.系統參數.....................................................................................................................................11812.1.開啟系統參數功能畫面.................................................................................................11812.2.整合參數設定.................................................................................................................11912.3.訊息通知設定................................................................................................................12012.4.外觀設置........................................................................................................................12212.5.服務總線整合紀錄清除設定........................................................................................12312.6.Datakey排程設定...........................................................................................................12513.EAI應用伺服器(啟動/關閉/重啟).............................................................................................12761.登入鼎捷互聯中台管理介面*鼎捷互聯中台於內文中簡稱EAI(DigiwinEAIMiddleware)1.輸入EAI管理介面網址：http://{EAIAPSERVERIP}:9990/CROSS/顯示EAI管理介面登入畫面。預設登入帳戶資訊如下：帳號：DS密碼：DS備註：如EAIAPServer安裝在本機，亦可於「開始」→「程式集(所有程式)」→「DigiwinEAIMiddleware」中，點選DigiwinEAIMiddleware開啟EAIWEB介面。Server2012Server200872.進入EAI管理介面。82.智能監控將中台主機的硬體使用狀況、各產品的服務狀況及整合Log透過統計計算、分析，以圖表的方式呈現整個中台整合的運作狀況，並在有異常時發出預警，讓使用者及早解決問題。2.1.開啟智能監控畫面1.點選左方「智能監控」功能。2.右邊顯示「智能監控」功能畫面。92.2.檢視智能監控圖表2.2.1.硬體資源使用率記憶體、AP與DB的磁碟空間的使用率。到達紅色區域時，中台會發出警示訊息。2.2.2.產品連接狀態監控查看所有已註冊於中台的產品，並顯示產品的WSDL及RESTful接口的服務狀態。102.2.3.中台運作狀態整合Log統計分析運算中台當日的「平均整體服務時間」及「平均中台處理時間」。113.整合紀錄查詢3.1.開啟紀錄檢視功能畫面1.點選左方「紀錄檢視」功能。2.右邊顯示「紀錄檢視」功能畫面。123.2.輸入查詢條件欲從資料列中快速找到紀錄，可以透過輸入查詢條件篩選出符合條件的紀錄。依照時間查詢：選擇10.「(起)日期、(起)時間」及11.「(訖)日期、(訖)時間」兩個條件，選取至欲查詢的時間區間，點選「查詢」按鈕後，下方資料列顯示查詢結果。依整合發起端查詢：1.「發起端」。2.「發起端IP」。3.「發起端ID」。「發起端UID」。依整合服務端查詢：4.「服務端」。5.「服務端IP」。6.「服務端ID」。「服務端UID」。「服務說明」。依請求ID查詢：7.「請求ID」，每一次整合請求，會產生一組請求ID，此ID可供查詢。依服務名稱查詢：「服務名稱」，依發起端呼叫的服務名稱查詢。依狀態碼查詢：12.「狀態碼」，依照輸入的狀態碼查詢相關的ESB紀錄。依關鍵字查詢：13.「關鍵字」，依照訊息中的data-key內容作為查詢依據只顯示異常訊息：勾選只顯示異常後，依照想搜尋的條件輸入後查詢的結果只會出現含有異常的紀錄。133.3.檢視紀錄內容檢視正常整合請求：正常的同步整合請求的「狀態碼」由「000」、「013」、「014」、「015」、「019」所組成，並且會有一個整合發起端，及一個整合服務端，並由一個請求ID代碼以識別此次的請求。狀態碼所代表的意義如下：000：整合平台接收到發起端的請求。013：等待服務呼叫。014：整合平台呼叫服務端。015：整合平台收到服務端回應訊息。019：整合平台回應發起端。備註：更詳細的代碼說明請詳見EAI整合規範文件。3.4.檢視整合訊息內容在雙擊任一資料列後，會跳出整合訊息內容檢視視窗，視窗中會一併列出該次整合請求的所有訊息內容，可點選上方頁籤可切換不同狀態下紀錄的訊息內容。143.4.1.檢視原始訊息點擊「原始訊息」按鈕，可檢視請求方送出的原始訊息內容。153.4.2.檢視格式化訊息點擊「格式化訊息」按鈕，可將原始訊息內容格式化。163.4.3.檢視應用欄位點擊「應用欄位」按鈕開啟訊息應用欄位視窗，可解析原始訊息並以應用欄位的方式呈現訊息內容，此功能目前只支援標準API。173.4.4.規範檢測點擊「規範檢測」按鈕開啟規範檢測視窗，使用者可以透過檢測確認訊息是否符合規範。詳細功能及操作說明，請參考「8.3發起訊息檢測」。183.4.5.取得序列化內容點擊「取得序列化內容」按鈕，使用者可下載請求方送出的檔案內容。1.點擊「取得序列化內容」2.顯示下載檔案視窗，對連結上點右鍵可以另存新檔。193.5.整合異常檢視當集成過程發生異常時，可紀錄問題發生當下的「發起端」、「服務端」、「時間」，甚至「請求ID或UID」(如果AP端有紀錄及顯示請求ID或UID)等相關信息記錄下來，並且依照這些信息透過鼎捷應用集成軟件進行查詢，應可查詢到特定的集成請求信息，協助判斷問題發生的原因。3.5.1.整合紀錄查詢請參考「輸入查詢條件」輸入特定條件，以進行整合紀錄查詢。3.5.2.異常檢視異常的整合狀態在資料列中會以「紅色」呈現。3.5.3.視覺化檢視可透過視覺化方式，檢視整合異常內容。20備註：1.並非所有的整合異常皆可從紀錄檢視中明顯的觀察。EAI所能觀察到的異常為與網路連線、標準訊息、系統例外等異常項目，某些整合異常可能會發生在AP端內部的執行邏輯內，此時必須搭配異常發生時的相關資訊，例如「時間」、「發起端」、「服務端」等資訊，協助從EAI中查詢對應的整合請求，並將整合的訊息內容，交由相關的產品單位進行分析及處理。2.整合發生異常時EAI會發出異常通知至發起端產品，相關設定請詳閱「異常通知設定」。213.6.手動重新回覆非同步請求在非同步整合活動中，若回覆結果至發起端失敗，可選擇此筆異常紀錄並點選重送，手動將結果重新回覆至發起端。224.流量統計查詢4.1.開啟流量統計功能畫面1.點選左方「流量統計」功能。2.右邊顯示「流量統計」功能畫面。234.2.流量統計查詢可透過輸入「發起端」、「服務端」、「時間」篩選欲查看的產品、時間範圍，再將整合Log透過統計計算，以圖表的方式呈現統計結果。1.點選左方欲查詢之流量統計專案。支持「集成交易每日總訊息量」、「集成交易每日總次數」、「平均每日各時段交易訊息量」以及「平均每日各時段交易次數」四種查詢方式。242.選擇要查詢之請求端(可選)、服務端(可選)、服務端服務名稱(可選)。若日期範圍超過一個月，僅提供匯出方式查詢。3.當流量統計項目為「整合交易每日總訊息量」或「整合交易每日總次數」，且請求、服務端與服務端服務名稱皆未選擇之情況下，另提供「個別產品狀態」查詢功能。25265.整合產品監控整合產品監控功能主要目的是可以快速的瞭解整合產品之服務從平台安裝到目前為止執行的狀況，包括執行次數、接收回傳的訊息大小。除了檢視監控資訊外還提供產品檢測功能與檢測紀錄之查詢。5.1.開啟整合產品監控功能畫面1.點選左方「產品監控」功能。2.右邊顯示「產品監控」功能畫面。檢測狀態分為WSDL與RESTful兩種，為沒有回應，為正常運作，若產品無實作WSDL或RESTful則為空。275.2.註冊產品立即檢測立即檢測產品當下的WSDL及RESTful接口的服務狀態。1.由清單中點選欲檢測之產品，再點選下方立即檢測之按鈕5.3.檢視產品監測紀錄可選擇其中一個產品，並開窗檢視該產品的每日每小時每20分鐘的檢測記錄。1.由清單中點選欲檢測之產品，再點選下方檢測紀錄之按鈕282.該產品之檢測紀錄會以開窗方式呈現，顯示每天每個小時的檢測結果3.鼠標移至欄位資訊雙擊欲查看的時間點，雙擊後開窗顯示該產品當天的每20分鐘的檢測結果。296.產品維護產品維護功能提供使用者介面以維護整合產品之註冊，以及修改及刪除相關註冊資訊，並且可針對註冊之整合產品設定連絡人等功能。6.1.開啟產品維護功能畫面1.點選左方「產品維護」功能。2.右邊顯示「產品維護」功能畫面。303.在下方產品列檢視產品資訊，箭頭可收折該產品的WSDL及RESTfulURL。316.2.註冊整合產品透過產品維護介面，於上方欄位輸入欲註冊的產品資訊，點選右上角「新增」按鈕後，即可增加一筆產品資訊於下方資料列中。1.於上方「輸入編輯欄位」中輸入欲註冊產品之資訊。各欄位說明如下，(1).WSDL：WebService的WSDL位置，必須使用IP位址，不可使用DomainName。(2).RESTfulURL:產品RESTful接口的位址(3).僅作為發起端：勾選代表註冊產品僅作為發起端，不需註冊WebService或RESTful位址。(4).屬性:產品之屬性，分為一般產品、設備和Adapter。(5).名稱：產品名稱，若為鼎捷集團產品則於名稱前會有鼎捷Logo，反之則無。每項產品會有一台預設主機，以藍色粗體字顯示。(6).版本：產品版本。(7).ID：產品識別碼，提供同一產品多台主機辨別之用。(8).UID：產品唯一識別字，提供產品主機辨別之用。(9).IP位址：IP位址，需與WSDL一致。(10).時區：時區，內容值為(-12~+14)，預設值為+8，台灣為+8。(11).重試次數：重送次數，預設值為3。(12).重試間隔：重送間隔時間，預設值為3000毫秒。32(13).Concurrence：同時連線人數(license)，預設值為0，表示無限制。(14).備註：產品之備註。2.點選畫面右上角的「新增」按鈕。3.點選新增按鈕後，出現執行成功訊息，且下方資料列會新增一筆資料。336.3.刪除已註冊整合產品1.於下方「產品列表」先點選欲刪除之產品，並點選「刪除」按鈕。2.於「是否要刪除？」對話方塊中點選「是」，即可刪除該產品。346.4.修改整合產品資訊1.於下方「產品列表」點選欲修改資訊之產品。2.於上方「輸入編輯欄位」中修改產品資訊。353.點選畫面右上角的「修改」按鈕，即可完成產品資訊修改。並且下方「產品列表」會顯示修改後的結果。366.5.設定整合產品聯絡人設定該產品發生異常時要通知的聯絡人。每項產品可設定一或多個聯絡人。1.於下方「產品列表」點選欲設定聯絡人之整合產品。2.點選畫面右下角的「設定聯絡人」按鈕，開啟設定聯絡人視窗。3.將欲設定為聯絡人的帳戶，加入至右邊資料列中。並點選「儲存」按鈕，即可完成聯絡人設定。376.6.設定全產品編碼開關產品可設置編碼開關，在整合過程中為保護資料安全，故對資料進行Base64編碼。1.點選右下角的「設定全產品編碼開關」按鈕。2.於對話方塊提示此功能會將編碼開關同步至所有產品，如須設置個別產品編碼開關，請點選產品編碼開關圖示。如需要執行，請點選「是」。3.點選「是」後，於顯示的對話方塊中指定欲設定的編碼開關，並點選「同步至所有產品」按鈕。384.各個產品會回應編碼開啟狀況5.於「產品列表」中會顯示目前各個產品的編碼開關狀態。396.7.加密設定產品可做加密設定，在整合過程中為保護資料安全，故對產品訊息進行編碼。1.於「產品列表」中打開產品的加密開關2.對話方塊提示此功能會開起加密開關。如需要執行，請點選「是」。403.畫面彈出加密設定視窗，使用者會得到一組預設的金鑰，透過點擊「下載金鑰」檢視並複製金鑰；使用者也可以在欄位中重新設置金鑰（金鑰須由16位英數字元組成）。加密方式目前僅提供AES加密的ECB模式。4.對話方塊提示此功能會將會修改加密設定。如需要執行，請點選「OK」。5.點選「OK」按鈕後，出現儲存成功訊息。416.8.設定FTP伺服器每台產品主機可設置一個FTP伺服器，供整合機制之FTP檔案傳輸方案使用。1.於下方「產品列表」點選欲設定FTP伺服器之整合產品。2.點擊畫面右下角的「設定FTP伺服器」按鈕，開啟設定FTP伺服器視窗。423.輸入欲設定之FTP伺服器之位址、連接埠，以及登入之使用者帳號與密碼。4.填入FTP資訊後，可點擊「測試」按鈕測試FTP是否可正常登入。成功則出現「連線測試成功」訊息。若連線失敗，可點擊「查看詳細訊息」查看錯誤原因。435.點擊儲存按鈕，即可儲存產品之FTP伺服器資訊，出現『儲存成功』訊息。6.9.設定預設主機每項產品會有一台預設主機，在畫面中以藍色粗體字表示。當整合訊息中只有描述訊息要送到哪項產品，而未指定詳細主機資訊（如IP、識別碼）時，EAI會將該整合訊息送至該產品的預設主機。1.於下方「產品列表」點選欲設定為預設主機之整合產品442.點選畫面右下角的「設定為預設主機」按鈕，出現詢問對話框「是否設定為預設主機？」3.點擊『是』，出現『已設為預設主機』訊息即設定成功，該產品於產品清單中變換成藍色粗體字。457.服務註冊服務註冊功能提供使用者在介面上進行查詢、新增、修改及刪除服務資訊。7.1.開啟服務註冊功能畫面1.點選左方「服務註冊」功能。2.右邊顯示「服務註冊」功能畫面。467.2.查詢已註冊服務欲從資料列中快速找到服務，可以透過選擇「產品主機」、輸入「服務名稱」、「服務說明」查詢出符合條件的服務。1.於上方「輸入編輯欄位」中輸入欲查詢服務之資訊。各欄位說明如下：(1).產品主機：於產品維護中已註冊的產品清單。(2).操作名稱：服務所屬操作的名稱，預設值為invokeSrv。(3).服務名稱：服務的名稱。(4).服務說明：服務的說明。(5).服務版本：服務的版本，其格式為d.d(d代表0~9中某一數字)。(6).Concurrence：服務可被同時呼叫的數量。2.點選畫面右上角的「查詢」按鈕，下方「服務資料列」即顯示查詢的結果。477.3.註冊服務透過服務註冊介面，於上方欄位輸入欲新增的服務資訊，點選右上角「新增」按鈕後，即可增加一筆服務於下方資料列中。1.於上方「輸入編輯欄位」中輸入欲註冊服務之資訊，欄位說明請參考「查詢已註冊服務」。2.點選畫面右上角的「新增」按鈕，即可完成服務註冊。註冊完成的服務將顯示於「服務資料列」中。487.4.刪除已註冊服務1.於下方「服務資料列」點選欲刪除之服務。2.點選畫面右上角的「刪除」按鈕，並於對話方塊中點選「是」，即可刪除指定服務。497.5.修改已註冊服務資訊1.於下方「服務資料列」點選欲修改之服務。2.於上方「輸入編輯欄位」中修改服務資訊。3.點選畫面右上角的「修改」按鈕，即可完成修改服務資訊，並且更新下方資料列。508.整合設定整合設定提供鼎捷集團產品便捷的註冊方式，只要在整合設定頁面中，輸入鼎捷集團產品的WebServiceWSDL位置，即可完成產品主機資訊及服務資訊的註冊。並且可以手動更新產品的資訊、同步整合設定，讓產品間的整合設定一致化。詳細功能及操作說明，請參考「系統整合設定手冊」。519.整合訊息規範檢測EAI整合平台提供以WebService的方式供產品(系統)間進行整合。整合產品WebService所提供的Operation、Service與訊息格式須符合EAI的規定，方可透過EAI進行整合。整合訊息規範檢測功能可供開發人員檢測產品整合規範的符合情形，並列出有那些須修正或不完善的項目，節省開發人員查詢規範訊息問題的時間。9.1.開啟整合訊息規範檢測功能畫面1.點選左方選單「服務總線」中之「規範檢測」。2.右方主畫面顯示整合訊息規範檢測頁面。529.2.服務訊息檢測「服務訊息檢測」的功能為檢測產品做為整合服務端所須具備的WebServiceOperation與Service是否完善，以及訊息格式是否正確。操作步驟如下：1.點選「服務訊息檢測」頁籤。2.於頁面中輸入以下資料：(1).整合產品WSDL：整合產品WebService的WSDL位置。(2).產品名稱：整合產品於EAI註冊所使用的產品名稱。(3).啟用編碼：可分別檢測整合產品在啟用/未啟用資料編碼的情形下是否符合規範。(4).檢測的整合活動：使用者可選擇要檢測那些整合活動，EAI會依據使用者勾選的項目，呼叫對應的Service，並接收整合產品回傳的訊息後進行檢測。各項整合活動的詳細內容請參考整合規範文件2.2節。3.點選「開始檢測」按鈕。53檢測結果如下圖所示：欄位說明如下，(1).序號：檢測項目的編號。(2).檢測項目：檢測的項目名稱。(3).是否必要：表示此項目是否為必要資料。(4).輸入值：根據檢測項目，從整合訊息中取得對應的輸入值。(...