鼎捷互聯中台-系統整合設定手冊.pdf

鼎捷互聯中台系統整合設定手冊DAP平台中心互聯中台技術部目錄1.整合設定說明...................................................................................................................................31.1.EAI整合設定流程圖............................................................................................................32.執行整合設定...................................................................................................................................42.1.註冊整合產品......................................................................................................................42.2.執行整合設定同步..............................................................................................................82.3.註冊僅作為發起端產品......................................................................................................93.整合產品版更及移機.....................................................................................................................103.1.更新整合產品註冊資訊....................................................................................................103.2.整合產品移機.....................................................................................................................114.預設主機.........................................................................................................................................124.1.預設主機說明....................................................................................................................124.2.設定預設主機....................................................................................................................125.產品測試環境說明.........................................................................................................................145.1.識別產品註冊資訊............................................................................................................145.2.建置產品測試環境............................................................................................................166.多廠區設定.....................................................................................................................................176.1.外部IP設定.......................................................................................................................176.2.註冊多廠區EAI.................................................................................................................186.3.更新多廠區EAI.................................................................................................................226.4.多廠區EAI移機................................................................................................................236.5.刪除多廠區EAI.................................................................................................................257.整合設定Q&A...............................................................................................................................267.1.產品註冊失敗如何排除？................................................................................................267.2.執行同步程序時產品發生同步失敗該怎麼辦？............................................................277.3.如何知道EAI或整合產品的WebService是否存活？..................................................287.4.為什麼找不到、連不到Workflow的WebService？.....................................................297.5.完成同步程序後，各產品還需執行什麼設定？............................................................3031.整合設定說明1.1.EAI整合設定流程圖42.執行整合設定整合產品及EAI在安裝完成後，需於EAI上執行兩項標準的整合設定程序，包括：註冊整合產品，將整合產品的資訊註冊至EAI中。同步整合設定至整合產品，讓產品透過EAI進行整合。2.1.註冊整合產品1.進入EAI整合設定功能頁面：選擇「服務總線」「整合設定」。2.顯示「整合設定」功能頁面。53.點選「產品註冊」標題左方之「」圖示，可新增註冊欄位，同時可新增多筆註冊欄位。4.於新註冊欄位的「下拉選單」中，選擇欲註冊的產品名稱，選擇後項目右方「文字方塊」會出現該產品預設的WSDL範本。5.可選擇「WSDL」或「REST」輸入對應URL6.輸入產品資訊或URL（以下兩種輸入方式二擇一即可）(1)在欄位輸入IP，鼠標移開欄位後會將URL欄位中「{IPADDRESS}」修改為使用者輸入的IP。(2)在URL欄位輸入實際WSDL位置。備註：a.輸入完成後，可點選右方「檢驗」按鈕，以確認輸入的WSDL或REST位置是否可正常連線。6檢驗完成後，按鈕中會顯示「檢驗完成」，並且按鈕變成灰色。b.亦可使用IE瀏覽器開啟WSDL，以確認WSDL位置是否可正常連線。如可正常連線會顯示類似下圖之畫面。7.點選畫面右上角「確定並執行註冊」按鈕，執行註冊程序。78.詢問是否執行，點選「是」繼續，離開點選「否」。9.執行過程進度會顯示於產品文字方塊右邊。10.右邊顯示「註冊完成」，代表產品已註冊成功。11.已註冊產品項目下亦會新增註冊完成之產品資訊。12.可進入「產品維護」頁面，及「服務註冊」頁面，查看產品註冊的結果。備註：相關Q&A「產品註冊失敗如何排除?」。「為什麼找不到、連不到Workflow的WebService？」82.2.執行整合設定同步1.進入整合設定頁面後，點選畫面右上角「執行同步程序」按鈕。2.選擇同步執行的方式。僅同步預設主機：只同步預設產品主機間的整合設定，預設主機通常用於正式環境。同步所有主機：同步包含非預設產品主機的設定，可能會影響測試環境的整合設定，並造成整合的對應錯誤，需小心執行。3.點選執行的方式後，產品開始執行同步程序，並顯示同步結果於產品項目右方。備註：相關Q&A「執行同步程序時產品發生同步失敗該怎麼辦？」。92.3.註冊僅作為發起端產品整合設定頁面中可註冊僅作為發起端的產品，可註冊的產品依不同版本的EAI有所不同。1.進入整合設定頁面後，於「僅作爲發起端」項目下，勾選欲註冊的產品。2.於對話方塊中點選「是」進行註冊。3.註冊完成後該項目會變為灰色，並且不可點選。4.可進入「產品維護」頁面查看註冊的結果。103.整合產品版更及移機3.1.更新整合產品註冊資訊整合產品在版更之後，相關整合設定資訊及產品服務列表可能會更新，為了保持EAI上註冊資訊與產品為一致，建議可以執行更新程序。1.在已註冊的產品項目右方，勾選「更新」。2.點選畫面右上角「確定並執行註冊」，即可執行更新程序。備註：相關Q&A「產品註冊失敗如何排除?」。113.2.整合產品移機整合產品的主機在更新IP位置之後，需要在EAI上執行移機的作業，以確保EAI可以正確連線至移機後的產品主機。1.整合產品先完成移機程序。2.在已註冊的產品項目右方，勾選「移機」。3.修改產品文字方塊中的IP位置。備註：必須確認輸入正確產品的WSDL或REST位置。4.點選畫面右上角「確定並執行註冊」，即可執行移機程序。備註：相關Q&A「產品註冊失敗如何排除?」。124.預設主機4.1.預設主機說明當同一產品在EAI上註冊多台主機時，可在EAI的整合設定上指定目前使用的正式環境主機。以利整合發起端在發起整合服務時，可以順利找到適當的主機環境。備註：一般情況下，預設主機設定不可隨意更動，除非確認需要更改「正式環境」主機。4.2.設定預設主機方法一：整合設定功能頁面1.進入EAI服務總線之整合設定功能頁面。2.在已註冊產品項目之右方，會出現「預設主機」的選項，其中同名稱產品只會有一個預設主機。3.點選欲設定為預設主機的產品。4.於對話方塊中點選「是」，確定設為預設主機。135.顯示「已設為預設主機」方法二：產品維護功能頁面1.進入EAI服務總線之產品維護功能頁面。2.「預設主機」產品會以藍色粗體方式呈現3.點選欲設定為預設主機的產品，並點選右下角「設定為預設主機」按鈕。4.於對話方塊中點選「是」，確定設為預設主機。145.顯示「已設為預設主機」5.產品測試環境說明非正式環境主機（非預設主機）產品，一般無法透過EAI的「整合設定同步」完成產品間整合設定的對應。因此，需要瞭解測試環境產品在EAI上所註冊的資訊之後，於產品端進行整合設定。5.1.識別產品註冊資訊所有註冊到EAI上的產品主機皆以下兩組資訊進行識別，包括：1.由「產品名稱」+「唯一識別碼」資訊做為識別：產品名稱：註冊的產品名稱。唯一識別碼：若產品有唯一識別碼，則不會識別第2點中的「IP位置」與「識別碼」。2.由「產品名稱」+「IP位置」+「識別碼」資訊做為識別：產品名稱：註冊的產品名稱。IP位置：註冊WebService的IP位置。識別碼：識別資訊（可能為空白）。產品註冊資訊可於EAI進行查詢，方式如下，15方法一：進入EAI服務總線「整合設定」功能頁面，將滑鼠停留至產品的「WSDL」或「REST」上，即可顯示註冊資訊。方法二：進入EAI服務總線「產品維護」功能頁面，下方資料列會顯示產品主機註冊之資訊。165.2.建置產品測試環境1a.產品測試主機可透過EAI整合設定之「2.1註冊整合產品」章節說明，進行產品主機註冊（建議方法）。1b.亦可透過EAI「產品維護」功能頁面，進行註冊（此方法需手動輸入產品資訊）。1c.產品端如有EAI註冊工具，亦可透過該工具進行註冊。2.紀錄註冊測試產品主機之「產品名稱」、「IP位置」及「識別碼」資訊，識別碼如為空白，則不需紀錄。3.進入產品端系統，進行整合設定，此部份每個產品設定方式不同，需個別參考各產品整合設定文件。主要設定內容如下，設定EAI位置資訊。設定整合產品之「IP位置」及「識別碼」，識別碼如為空白，則不需設定。啟用EAI整合。備註：設定整合產品之「IP位置」及「識別碼」詳細說明：例如進入EasyFlow測試環境系統，設定Workflow測試環境於EAI上註冊的IP位置、識別碼等資訊。4.設定完成後，在產品端執行整合功能。並進入EAI確認是否有收到發起端訊息，以及測試環境對應是否正確。176.多廠區設定以下將配置的兩台EAI稱為EAI(A)與EAI(B)進行說明，兩台EAI需先完成「6.1外部IP設定」，透過多廠區配置後，EAI(A)與EAI(B)上的產品可相互拋轉資訊。6.1.外部IP設定多廠區EAI整合需透過外網進行，故在配置前須先設定EAI主機的外網IP。1.點選左方系統管理下的「系統參數」功能。2.右邊顯示「系統參數設定」功能畫面，點選「系統資訊與設置」可開啟該頁面。3.設定「主機IP(二)」與「備註」。欄位說明如下，(1).主機IP(二)：中台主機的第二個IP（可以是第二張網卡或外網IP），設定完成後，即可使用此IP連線至中台服務。(2).UID：中台主機的識別碼，於第一次設定外部IP後產生。18(3).備註：中台主機備註欄位，可輸入廠區紀錄，例如:北京廠。4.欄位輸入完畢後，按下「儲存」按鈕，會顯示「儲存完成」訊息。6.2.註冊多廠區EAI1.於EAI(A)介面點選左方服務總線底下的「整合設定」功能。192.右邊顯示「整合設定」功能畫面，點選「多廠區設定」可開啟該頁面。3.輸入EAI(B)外部IP並進行註冊。A.點選新增一筆EAIIP輸入項。B.輸入EAI(B)的外部IP。C.按下確定並執行註冊進行EAI註冊。204.於詢問視窗點選「是」。215.註冊成功後，已註冊EAI下方顯示EAI(B)的外部IP、備註與產品資訊。6.至EAI(B)的多廠區設定介面下顯示EAI(A)的外部IP、備註與產品資訊，配置完成。226.3.更新多廠區EAI多廠區EAI資訊更新分為自動更新與手動更新，當產品資訊有異動時系統自動進行更新，亦可至整合設定介面進行手動更新。1.手動更新多廠區EAI資訊。A.點選更新選項。B.按下確定並執行註冊進行EAI資訊更新。2.於詢問視窗點選「是」。3.更新成功後，顯示更新後的EAI(B)外部IP、備註與產品資訊。236.4.多廠區EAI移機1.多廠區EAI移機。A.點選移機選項。B.於消息視窗中點選OK。24C.輸入EAI(B)移機後的外部IP。D.按下確定並執行註冊進行EAI移機。2.於詢問視窗點選「是」。3.移機成功後，顯示新EAI(B)的外部IP、備註與產品資訊。若EAI(B)為重新安裝，請先刪除後再註冊。256.5.刪除多廠區EAI1.刪除多廠區EAI。A.點選刪除選項。B.按下確定並執行註冊進行EAI刪除。2.於詢問視窗點選「是」。3.刪除完成後顯示「刪除完成」，已註冊EAI底下移除EAI(B)資訊。267.整合設定Q&A7.1.產品註冊失敗如何排除？產品註冊失敗的情況分為幾種，每一種失敗所發生的原因都不同，必須個別檢視。1.執行註冊失敗會顯示錯誤訊息於項目右方。2.點擊「詳細訊息」可開啟處理方案導引，依序排查錯誤。錯誤訊息與處理方式如下：錯誤訊息處理方式產品主機WSDL解析錯誤IP輸入錯誤，確認整合產品之整合站台WebService的位置後再輸入。連線WSDL文件時發生timeout，因網路問題發生，請再次重新執行該產品的註冊即可。整合產品未安裝整合站台，WorkflowERP的整合站台需要另外安裝，且整合站台主機可能不與ERP主機相同。整合站台尚未啟動，檢查IIS是否啟動，或IIS中是否包含該整合產品之站台。整合產品的WSDL路徑有變動，在同一時期進行聯合測試的產品，EAI會預設產品的WSDL路徑，讓使用者只需要修改IP即可連線，但有可能整合產品因為某些因素，變更了WSDL的路徑。只需確認產品的WSDL路徑後，輸入新的WSDL位置即可。產品主機REST解析錯誤無法連線至REST文件，請再次確認REST位置是否正確。連線REST文件時發生timeout，因網路問題發生，請再次277.2.執行同步程序時產品發生同步失敗該怎麼辦？執行同步程序發生失敗的原因可能是EAI在傳遞同步資料至產品端後，產品處理發生例外，或是產品處理同步後回應失敗的訊息。因為EAI僅負責將同步的訊息傳遞至產品端，並不介入產品端的處理，因此在排除網路異常狀況後，可再次進行同步，如產品同樣發生同步失敗，則需要請產品中心或整合中心進行處理。失敗原因處理方式網路短暫斷線重新執行同步。產品WebService無法連線修復產品的WebService，可能為產品主機斷線，或產品主機站台未啟動。產品處理同步發生例外聯絡該產品之產品中心，測試WebService的程式是否可正常運作。產品處理同步後回應失敗訊息聯絡該產品之產品中心，查詢失敗的原因。重新執行該產品的註冊即可。建立WSClient時失敗產品提供的WSDL不符合W3C1.1規範，因此造成EAI無法建立呼叫元件。在實際佈署環境下較不可能發生，因為產品皆已經過測試。產品端回傳產品註冊資訊時發生例外產品端回覆EAI產品註冊資訊時拋出例外，聯絡該產品之產品中心，以測試WebService的syncProd方法是否可以正常回應訊息。產品端回傳產品註冊訊息錯誤產品端回覆EAI的產品註冊資訊格式有誤，聯絡該產品之產品中心，測試WebService的syncProd方法回應之訊息是否符合EAI規範。產品端回覆EAI的產品註冊資訊有缺漏，聯絡該產品之產品中心，測試WebService的syncProd方法回應之訊息是否符合EAI規範。產品端回傳服務註冊資訊時發生例外產品端回覆EAI服務註冊資訊時拋出例外，聯絡該產品之產品中心，以測試WebService的syncProd方法是否可以正常回應訊息。取得服務註冊資訊時發生錯誤產品端回覆EAI的服務註冊資訊格式有誤，聯絡該產品之產品中心，測試WebService的syncProd方法回應之訊息是否符合EAI規範。執行服務註冊發生錯誤產品端回覆EAI的服務註冊資訊中指定了錯誤的註冊主機，造成EAI無法找到對應的產品主機，執行服務註冊。聯絡產品中心修正問題。287.3.如何知道EAI或整合產品的WebService是否存活？可使用IE瀏覽器輸入EAI及整合產品的WSDL位置，如可顯示如下畫面，代表可連線至WebService的定義檔案。也可以使用EAI整合設定頁面測試整合產品的WebService是否存活，點選產品文字方塊右邊的「檢驗」按鈕後，假設按鈕變灰色，且顯示「檢驗完成」，代表產品WebService為存活狀態。EAI的WebSerivceWSDL位置如下，「http://{EAIIP}:9999/IntegrationEntry?wsdl」「http://{EAIIP}:9999/IntegrationEntry/Axis?wsdl」EAI的WebSerivceRESTful位置如下，「http://{EAIIP}:9990/CROSS/RESTful」297.4.為什麼找不到、連不到Workflow的WebService？因為WorkflowERP安裝配置的彈性，預設並不會將與所有產品的整合站台WebService都進行安裝。且Workflow整合站台可以安裝在不同主機上，例如與ERPAP、ERPDB不同主機，故IP位置也會不相同。發生找不到WorkflowforEAI的整合站台時，請逐步確認：確認是否已經安裝WorkflowforEAI整合站台，如已安裝，則確認是否安裝在ERPDB或者其他ERPII產品的主機中。可利用「如何知道整合產品的WebService是否存活」進行測試。如尚未安裝WorkflowforEAI整合站台，則需要利用Workflow安裝片進行安裝，安裝程式的路徑為「\ERPII_Integration\WebService\WF_EAI」目錄下之可執行檔案。(a).開啟WorkflowforEAI整合站台安裝程式。(b).輸入「虛擬目錄路徑」及「ERPAPIP」。(c).點選「安裝」按鈕，即可完成WorkflowforEAI整合站台安裝。備註：不需執行「EAI主機及服務註冊」，請回到EAI整合設定。307.5.完成同步程序後，各產品還需執行什麼設定？EAI整合設定註冊及同步目前的範圍僅包括：令EAI知道各產品的主機資訊及服務資訊。令EAI知道各產品的單一整合WebService入口位置。整合設定同步令產品知道EAI的WebService整合入口位置。整合設定同步令產品知道目前EAI上已有哪些整合產品，以及已註冊產品的相關資訊，並切換透過EAI進行整合。除了以上所述之項目，例如Portal的SSO應用等，需要另外進行整合設定。請參考下方整理。1.EF.Net與Portal整合設定到EF.Net主站台的實體路徑中設定web.config(預設安裝目錄EasyFlow\EFNET)，搜尋關鍵字EnableSSO，找到後依下列方式修改。2.SFT整合設定以文字編輯器開啟SFT安裝目錄(預設為C:\workspace)底下的子目錄SFT\WebContent\xmldata\config裡的SFT參數檔「SFT_System.xml」，並修改以下項目：修改內容：設定為http://{WorkflowWebserviceIP}/WFPortal/WFPortalService.asmx{Workflow31WebserviceIP}請置換為Workflow的PortalWebService實際的IP修改內容：設定為http://{SSOWebserviceIP}:8081/cas-web/WebService/IssueandValidateTicketWS{SSOWebserviceIP}請置換為Portal的實際IP。3.EF.Net與ESSPLUS整合設定進入系統參數設定維護作業，查詢參數代號「APPFormWebERPIIUrlESSExtIP」，並將參數設定「http://127.0.0.1/HRMESS」改為「http://ESSPLUS外網IP/HRMESS」。進入設定APPForm程式選單作業，並執行，進入「APPForm程式選單作業」，讓EF取得程式選單與欄位資料。「重新取得授權模組」：將授權模組資訊記錄到EF系統。「取APPForm平台的Menu」：將ESSPLUS的程式選單建立到EF系統。「取得ERPIIPlus的ColumnSet」：將ESSPLUS的欄位資料建立到EF系統。進入HRM主機，設定ESSWebService位置，在小助手按右鍵，選擇「整合配置配置」。輸入「WEB服務地址」：http://EFServerIP/ESS/Service.asmx後，32按下「測試鏈接」，出現測試成功，則表示HR和EF二邊的WebService溝通成功。4.CRM與Portal整合設定到CRM主站台的實體路徑中設定web.config(預設安裝目錄C:\inetpub\wwwroot\WebCRM)，搜尋關鍵字EnableSSO，找到後依下列方式修改。