鼎捷EAI整合規範文件V3.1.07 (集團).pdf

SPC-001EAI整合規範文件Ver.3.1.07智能+技術中心互聯中台技術部DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：2文件制/修訂履歷版次日期說明作者備註2.2.072013/10/091.使用整合服務增加單向模式(Link)(Link)林雙翌EAIBuild00672.2.082014/01/031.新增Adapter屬性(Link)(Link)林雙翌2.2.092014/05/151.整合設定同步資訊中新增共用參數(Link)2.新增查詢產品共用參數清單服務(Link)3.修改單次請求最大傳輸量限制(Link)鄭舜尹2.2.102014/05/291.新增互動代碼(103、104)殷仕偉2.2.112014/06/101.修改服務名稱限制說明林雙翌EAIBuild00732.2.122014/11/251.修改ETL執行服務回傳訊息(Link)2.新增查詢ETLJOB清單服務(Link)3.新增互動代碼095、404(Link)。林雙翌周宏達2.2.132014/12/011.新增互動代碼808(Link)2.修正3.6、3.7、3.8互動代碼的部分(Link)殷仕偉2.2.142014/12/221.修改查詢ETL的JOB清單，回應端Job描述以Base64加密回應(Link)殷仕偉2015/10/121.提供服務呼叫EAI送出的訊息中，host標籤增加timestamp與acct屬性(Link)周宏達2.2.152015/10/291.新增鼎捷產品WIP,T100,T100MOBILE(Link)2.新增oneway說明(Link)殷仕偉2.2.162015/11/021.新增StateCode407(Link)殷仕偉EAIBuild00792.2.172016/09/201.新增發布服務代理(Link)林雙翌EAIBuild00813.0.002017/02/061.新增序列化與檔案資料交換機制(Link)鄭舜尹EAIBuild00873.1.002017/05/021.新增產品唯一識別碼uid(Link)鄭舜尹EAIBuild00883.1.012018/03/281.整理互動代碼資訊(Link)鄭舜尹3.1.022018/04/031.新增標準產品POSSERVER(Link)2.新增標準產品SPC(Link)謝承諺EAIBuild01013.1.042019/03/281.請求產品提供產品註冊資訊resturl(Link)林郁翔3.1.052019/09/161.新增標準產品PMS(Link)謝承諺3.1.062019/10/18整合同步資訊新增同步、非同步逾時秒數(Link)謝承諺3.1.072021/05/24調整服務註冊格式、服務描述格式規範說明林雙翌鄭舜尹EAIBuild0127DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：3目錄文件制/修訂履歷...............................................................................................................................................2目錄....................................................................................................................................................................31.名詞定義.......................................................................................................................................................51.1.鼎捷互聯中台....................................................................................................................................51.2.服務端................................................................................................................................................51.3.需求端................................................................................................................................................51.4.WebService.........................................................................................................................................51.5.WebServiceOperation........................................................................................................................51.6.服務(Service)...................................................................................................................................52.整合介面規範...............................................................................................................................................62.1.鼎捷互聯中台....................................................................................................................................62.1.1.產品主機註冊.........................................................................................................................92.1.2.產品主機服務清單註冊.......................................................................................................112.1.3.使用整合服務.......................................................................................................................122.1.4.使用整合服務ETL...............................................................................................................152.1.5.查詢ETLJOB清單..............................................................................................................162.1.6.查詢已註冊產品清單...........................................................................................................162.1.7.查詢特定產品詳細資訊.......................................................................................................162.1.8.查詢特定產品服務清單.......................................................................................................162.1.9.查詢共用參數清單...............................................................................................................172.2.整合產品..........................................................................................................................................182.2.1.提供服務呼叫.......................................................................................................................192.2.2.提供Callback呼叫...............................................................................................................202.2.3.監控產品主機存活狀態.......................................................................................................212.2.4.取得產品註冊資訊...............................................................................................................222.2.5.取得服務註冊資訊...............................................................................................................232.2.6.接收整合設定同步資訊.......................................................................................................242.2.7.接收整合規範參數資訊.......................................................................................................272.2.8.接收同步主資料...................................................................................................................282.2.9.接收資料編碼啟用狀態.......................................................................................................292.2.10.取得資料編碼啟用狀態.....................................................................................................303.訊息格式.....................................................................................................................................................313.1.產品主機註冊..................................................................................................................................313.2.產品主機服務清單註冊..................................................................................................................343.3.使用整合服務..................................................................................................................................373.3.1.使用整合服務–關鍵字(datakey)格式..................................................................................433.3.2.使用整合服務–僅作為發起端產品(例如POS)..................................................................45DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：43.4.使用整合服務MDM.......................................................................................................................473.5.使用整合服務ETL..........................................................................................................................503.6.查詢ETLJOB清單.........................................................................................................................543.7.查詢已註冊產品清單......................................................................................................................563.8.查詢特定產品詳細資訊..................................................................................................................573.9.查詢特定產品服務清單..................................................................................................................593.10.查詢產品共用參數清單................................................................................................................613.11.EAI呼叫服務端.............................................................................................................................623.12.EAI呼叫接收端進行MDM主資料同步.....................................................................................663.13.EAI將工作結果(服務執行結果)Callback給需求端..................................................................693.14.EAI請求產品提供產品註冊資訊.................................................................................................713.15.EAI請求產品提供服務註冊資訊.................................................................................................733.16.EAI傳送整合設定同步資訊至產品.............................................................................................753.17.EAI傳送整合規範參數資訊至產品.............................................................................................773.18.EAI傳送編碼啟用狀態至產品.....................................................................................................783.19.EAI請求產品提供資料編碼狀態.................................................................................................804.其他整合規範.............................................................................................................................................814.1.執行整合服務逾時..........................................................................................................................814.2.服務等待逾時..................................................................................................................................834.3.字元編碼..........................................................................................................................................844.4.整合訊息編碼及解碼......................................................................................................................854.5.整合產品連線EAI失敗訊息.........................................................................................................86互動代碼一覽表..............................................................................................................................................87DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：51.名詞定義1.1.鼎捷互聯中台請參考2.1節之鼎捷互聯中台。1.2.服務端服務端指提供服務供外部系統使用的軟體系統。1.3.需求端請求端指請求服務端執行服務的軟體系統。1.4.WebServiceWebService為一個軟體系統的API接口，可以供其他系統呼叫，以達成相互溝通的目的。在EAI平台中，提供以WebService的方式與其他鼎捷軟體溝通。1.5.WebServiceOperationWebService通常由好幾個Operation所組成，每個Operation執行一個特定的程式功能，通常可以透過WSDL描述文件查詢該WebService有哪些Operation。在EAI平台中，以Operation做為執行服務的入口，例如在規範中，服務端的「invokeSrv」為一個WebService的Operation，此Operation會根據接收到的訊息，分辨應執行的服務。1.6.服務(Service)在EAI平台的定義中，服務指鼎捷軟體中的一個功能，例如CRM系統的查詢客戶資料、Workflow系統的取得選單資料(GetMenuData)或Portal系統接收消息中心資料，都是指服務。在EAI平台中，每個軟體系統的服務以一個名稱做為識別，例如「GetMenuData」即為Workflow所提供的一個服務，供其他系統取得Workflow系統中的選單資料。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：62.整合介面規範2.1.鼎捷互聯中台說明EAI整合平台提供以WebService的方式供產品(系統)間進行整合，其中WebService的功能包括產品註冊(產品資訊及服務列表)、使用整合服務(Service、MDM、ETL)以及產品註冊資訊查詢等功能。EAI整合平台並提供一管理介面，可供進行與產品註冊相關的設定，功能包含整合設定、產品註冊維護、服務註冊管理等。並且可透過紀錄檢視，以查詢產品(系統)間的整合紀錄。WebServiceWSDLWebServiceStyle/Use:Document/Literalhttp://[IPaddress]:9999/IntegrationEntry?wsdlWebServiceStyle/Use:RPC/Encodedhttp://[IPaddress]:9999/IntegrationEntry/Axis?wsdlWebServiceOperation名稱描述regProdAP註冊產品主機regSrv註冊產品服務invokeSrv使用整合服務invokeEtl使用ETL服務getEtlJobList取得ETLJob清單getProdList取得平台已註冊產品清單getProd取得產品詳細資訊getSrv取得產品服務清單getParamList取得共用參數清單EAI管理介面瀏覽器連線網址http://[IPaddress]:9990/CROSS/預設登入帳號及密碼DS/DS(帳號/密碼)EAI紀錄檢視連結EAI的紀錄檢視可直接指定整合交易請求的ID，即可開啟該次整合交易的紀錄內容。當整合活動發起端收到EAI回覆的整合異常訊息時，可將此連結提供給使用者，以便於定位及回報問題發生點，以及問題發生的原因。連結格式(不指定語系，EAI自動根據瀏覽器語系切換)：http://[EAIIP]:9990/CROSS/LogViewer.do?reqid=[該次整合交易ID]連結格式(指定語系：en、zh_TW、zh_CN，大小寫需一致)：http://[EAIIP]:9990/CROSS/LogViewer.do?reqid=[該次整合交易ID]&locale=enDigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：7其他整合規範其他整合規範是描述EAI整合平台與整合產品間相關協議(共同協議)的內容，當整合產品呼叫EAI的WebService並使用相關服務時，在此規範規定的條件下，整合產品會收到規範中預期的回應。部份規範在滿足條件的情況時，會回應異常的代碼，並表示整合異常。相關的內容如下：規範內容適用範圍執行整合服務逾時整合產品呼叫EAI的invokeSrv，並執行type為sync(同步)的服務執行請求時。服務等待逾時(服務忙碌)整合產品呼叫EAI的invokeSrv，並執行type為sync(同步)的服務執行請求時。字元編碼所有EAI整合的交換資料。整合訊息編碼及解碼透過EAI進行整合的發起端及服務端之整合產品的請求及回應訊息。傳送訊息大小限制整合產品呼叫EAI的invokeSrv、invokeMdm、invokeEtl。單次整合服務之訊息量傳輸上限為30MB備註EAIWebService(以VS2010加入服務參考為範例)DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：8EAI管理介面【回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：92.1.1.產品主機註冊說明不論是整合的發起端或是服務端，皆需在EAI進行註冊，以便EAI統一監控、管理整合產品及主機的狀況。產品主機註冊時需給予EAI的資訊必須包括：產品的名稱(應用系統名稱)、產品的版本號碼、產品主機的IP位置，以及產品WebService之WSDL的連結位置，並且產品WebService的Operation必須依照EAI的規定，方可進行註冊。EAI提供預設主機的功能，讓發起端在不需知道服務端IP位置的情況可，可以進行呼叫。詳細說明請參考下方備註。Operation名稱參數(各產品)回傳(EAI)regProdAPXml訊息Xml訊息備註主機註冊圖示：除了EAI可主動向產品主機請求註冊資訊外(請參考)，產品主機也可主動呼叫EAI的「regProdAP」WebServiceOperation，以進行註冊。此Operation會依據接收到的訊息內容，執行註冊、更新及反註冊的功能。產品主機的基本資訊包括：產品名稱(ex.TIPTOP)；產品版本(ex.5.3)；主機IP位置(ex.192.168.0.223)；識別碼等(請參考Xml訊息)。產品名稱的分類：註冊的產品名稱依規定分為鼎捷產品及第三方軟體，其中：鼎捷集團產品註冊的名稱如下表：產品註冊名稱備註TIPTOPTIPTOPTIPTOP_WPCTIPTOP_WPCWorkflowGPWFGPEasyflowGPEFGPEasyflow.NETEFNETCRMCRMDigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：10SFTSFTBIBIPortalPORTALHRMHRM易飛YIFEIM-CloudMCLOUDCOSMOSCOSMOS易成YICHENGAPPFormAPPFORMESSPlusESSPLUSPLMPLME10E10BEPBEPSmartERPSMERPWIPWIPT100T100T100_LightT100_LightPOSPOS僅作為發起端ETLETL僅作為發起端T100MOBILET100MOBILE僅作為發起端MESMESKMIKMI僅作為發起端sJDSsJDSPOSSERVERPOSSERVERSPCSPCPMSPMS第三方軟體註冊名稱規定：需為半形英文字母或數字，且不超過30個字元。不可與鼎捷集團的產品註冊名稱重覆。為識別方便，建議可加上系統供應商簡稱，例如：ORACLEBI、ORACLEHCM、SAPERP等。預設產品主機的功能：當發起端要呼叫的服務端產品有兩台主機時(例如HRM呼叫WFGP，而WFGP有兩台主機，且HRM未指定WFGP的主機IP、ID時)，EAI會將需求端的請求指定至預設的產品主機。註冊預設的主機當產品第一次在EAI上註冊時，EAI會自動視該產品主機為預設(例如，WFGP先註冊主機10.20.86.159，EAI會將159設定為WFGP預設的主機。而當WFGP再次註冊第二台主機10.20.86.139時，139則不為預設的主機)。改變預設的主機欲改變預設的主機時，必須進入EAI管理介面之「產品維護」或「整合設定」修改。呼叫預設的主機需求端在<service>的tag中，不指定ip、id及uid的屬性。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：11【返回】【返回目錄】2.1.2.產品主機服務清單註冊說明服務端除註冊主機WebService位置外，還需註冊服務端所提供的服務於EAI平台，以供發起端使用服務。規範2.2.05後提供服務合約註冊(此為服務組裝相關規範，請參考「整合規範文件-服務組裝」文件)。Operation名稱參數(各產品)回傳(EAI)regSrvXml訊息Xml訊息備註服務註冊圖示：產品(應用軟體)的服務可能經常有變動的需求，除了EAI可定期監控產品的服務狀態外，產品也可主動請求EAI的「regSrv」，以進行服務註冊。「regSrv」中也提供服務註冊、更新及反註冊的功能。一個產品有同樣的服務名稱時不會被重覆註冊，因此當有新增服務時，Xml訊息中不用特地排除已註冊的服務。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：122.1.3.使用整合服務說明服務整合發起端呼叫EAI平台，並執行指定的整合服務，服務整合(服務總線)的方式分為同步、非同步、單向及發布模式。Operation名稱參數(各產品)回傳(EAI)invokeSrvXml訊息/已編碼訊息Xml訊息/已編碼訊息備註服務代理模式：分為同步(sync)、非同步(async)、單向(oneway)和發布(publish)四種模式。同步模式(sync)：同步模式在需求端呼叫EAI的invokeSrv後，會等待EAI呼叫並執行服務端的服務，待EAI取得服務端回應後，會回覆執行結果給發起端。呼叫順序為：發起端→EAI→服務端。非同步模式(async)：非同步模式在需求端呼叫EAI後，假如訊息驗證無誤，會先回應需求端，以確認已接受工作請求。EAI在稍待會依據需求端的需求，呼叫服務端執行服務(服務執行時間依不同服務而定)。在收到服務端回應後，會馬上呼叫需求端的「callbackSrv」，以回覆服務端執行的結果。呼叫順序為：需求端→EAI；EAI→服務端；EAI→需求端。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：13單向模式(oneway)：單向模式在需求端呼叫EAI後，假如訊息驗證無誤，會先回應需求端，以確認已接受工作請求。EAI在稍待會依據需求端的需求，呼叫服務端執行服務(服務執行時間依不同服務而定)，但不會將執行結果回覆給發起端。呼叫順序為：需求端→EAI；EAI→服務端。發布模式(publish)：發布模式在需求端呼叫EAI後，假如訊息驗證無誤，會先回應需求端，以確認已接受工作請求。EAI在稍待會依據需求端訊息中的服務名稱，呼叫所有擁有該服務的服務端主機(服務執行時間依不同服務而定)。呼叫順序為：需求端→EAI；EAI→服務端(多台)。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：14資料交換機制：分為一般資料(raw)、序列化資料(serial)和FTP檔案(ftp)三種機制。一般資料(raw)：將要傳送的資料直接放在payload中。序列化資料(serial)：將要傳送的檔案經過序列化(Serialization)後放在payload中。收到資料的AP須從payload中取出內容後進行反序列化(Deserialization)。FTP檔案(ftp)：資料傳送方和接收方皆須架設FTP。傳送方將檔案放在FTP上後，向EAI發出FTP檔案拋轉請求。EAI會依據訊息內容，從指定的來源FTP將指定的檔案拋轉到指定的目的端FTP。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：152.1.4.使用整合服務ETL說明ETL服務請求端呼叫EAI，並請求執行ETL服務。Operation名稱參數(各產品)回傳(EAI)invokeEtlXml訊息/已編碼訊息Xml訊息/已編碼訊息備註同步模式：此WebService介面供ETL服務需求端，同步模式在需求端呼叫invokeEtl後，會等待EAI呼叫並執行ETL的服務，待EAI取得回應後，會回覆執行結果給發起端。非同步模式：EAI在收到ETL服務請求後，會驗證ETLJOB是否存在，並將結果以訊息方式回傳，若皆無誤，最後執行指定的ETLJOB。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：162.1.5.查詢ETLJOB清單說明查詢EAI平台上的ETLJOB清單。Operation名稱參數(各產品)回傳(EAI)getEtlJobListXml訊息Xml訊息備註此Operation可用來查詢EAI上的Job清單，功用在於讓軟體系統得知已存在於EAI上的Jobs，以便讓軟體系統透過invokeEtl接口執行指定工作。查詢Job時須提供EAI登入帳密(該帳號須有etl權限)，EAI會驗證帳密是否正確，若正確則回覆該帳號有執行權限的Job清單。2.1.6.查詢已註冊產品清單說明查詢已於EAI平台註冊的產品主機。Operation名稱參數(各產品)回傳(EAI)getProdList無Xml訊息備註此Operation可用來查詢目前已在EAI上註冊的主機清單，功用在於讓軟體系統得知其他產品已於EAI註冊，以便讓軟體系統透過EAI與其他系統整合。通常需求端呼叫服務端時，不用記憶太多的資訊，目前需求端必要的服務端資訊有：服務端的名稱、服務端的服務名稱等。只有在特定需求下時，才會需要服務端的其他資訊，例如在同一個平台環境下架設兩台同樣的產品；或同一個產品有多個WebService位置時，甚至有測試環境的需求時，才有需要記憶額外的資訊，如服務端IP、服務端識別碼(ID)等資訊。2.1.7.查詢特定產品詳細資訊說明查詢特定產品的詳細資訊。Operation名稱參數(各產品)回傳(EAI)getProdXml訊息Xml訊息備註此Operation可以利用產品名稱(例如：PORTAL、EFGP等)，直接查詢特定產品在EAI上註冊的資訊。也可透過此方法，查詢自身產品主機是否已經在EAI上註冊，以確保整合設定的一致及完整性。2.1.8.查詢特定產品服務清單說明查詢特定產品的服務清單。Operation名稱參數(各產品)回傳(EAI)getSrvXml訊息Xml訊息備註此Operation可用來查詢特定產品的服務清單，除了可以確認自己在EAI上註冊的服務清單的一致性外，也可以查詢其他產品已在EAI上註冊的服務狀況。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：172.1.9.查詢共用參數清單說明查詢EAI平台上的共用參數清單。Operation名稱參數(各產品)回傳(EAI)getParamListXml訊息Xml訊息備註此Operation可用來查詢EAI上的共用參數清單。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：182.2.整合產品說明本節說明與EAI進行整合之產品介面的規範內容，說明包含鼎捷產品以及第三方軟體的定義內容。其中，整合產品的一台主機以一個WebService位置做為識別，並定義為該產品主機的整合入口，此WebService必須提供WSDL文件(提供規定請見下方)，以利EAI進行整合呼叫。EAI將WebService的Operation定義為整合介面，並且透過訊息遞送及訊息內容完成整合工作。整合產品必須提供之WebService的Operation請參考下方內容。WSDL必須提供IP位置型式的連結位置，並且可以存取到WSDL文件內容。WSDL文件必須符合W3CWSDL1.1的規範，WebServiceDescriptionLanguage。Operation名稱描述是否必要鼎捷產品第三方invokeSrv提供服務呼叫✔✔callbackSrv供EAI回覆非同步、ETL等執行結果✔ΔsyncProd服務名稱描述getProdRegInfo取得產品註冊資訊getSrvRegInfo取得服務註冊資訊doSyncProcess接收整合設定同步資訊syncEncodingState接收資料編碼啟用狀態getEncodingState取得資料編碼啟用狀態✔ΔsyncProd服務名稱描述syncInvokeParam接收整合規範參數資訊ΔΔ圖示說明：✔：必要提供。Δ：視需求而定。備註無。【回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：192.2.1.提供服務呼叫說明當產品做為服務端時，此Operation會接收到由EAI平台傳送的Xml訊息，服務端需針對Xml訊息中的服務名稱執行對應的服務。Operation名稱參數(EAI)回傳(各產品)invokeSrvXml訊息/已編碼訊息Xml訊息已編碼訊息備註EAI呼叫服務端圖示：在平常情況下，只有在EAI接收到需求端的請求後，EAI才會呼叫服務端，以執行指定的服務。此處的訊息都是以Xml傳遞，Xml訊息中除了表頭(Header)資訊外，還包括傳遞資料的內容。服務端可以根據表頭取得需求端的資料，以及請求的服務名稱。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：202.2.2.提供Callback呼叫說明當產品做為需求端時，此Operation接收非同步、ETL工作執行完成後的結果回覆。Operation名稱參數(EAI)回傳(各產品)callbackSrvXml訊息/已編碼訊息Xml訊息/已編碼訊息備註EAI回應非同步執行結果圖示：非同步模式WebService呼叫的順序為：需求端→EAI；EAI→服務端；EAI→需求端，因此在需求端請求EAI執行服務時，EAI會先回應一個請求序號(RequestID)，需求端須記錄此請求序號，如此在EAI回應執行結果至需求端之「callbackSrv」時，才能透過請求序號得知哪一個請求已經執行完成。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：212.2.3.監控產品主機存活狀態說明EAI平台會定時監控已註冊產品主機的存活狀態，方法為傳送空字串至invokeSrv的Operation，當產品WebService的invokeSrv接收到平台的空字串時，需任意回應一個訊息(注意不可丟出例外或null，否則會造成平台監控失敗)。Operation名稱參數(EAI)回傳(各產品)invokeSrv空字串("")任意訊息備註平台監控產品主機圖示：【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：222.2.4.取得產品註冊資訊說明EAI平台主動向產品要求產品註冊資訊，並完成產品註冊。方法為平台呼叫產品之syncProd並指定執行"getProdRegInfo"服務，產品回傳產品註冊之XML訊息。Operation名稱參數(EAI)回傳(各產品)syncProd執行服務名稱getProdRegInfoXml訊息Xml訊息備註平台向產品主機請求註冊資料：此功能的目的在於，EAI可以主動透過產品主機的syncProd取回註冊資料。因為EAI與產品主機的安裝有先後順序，透過此種方法，工程人員可以減少在不同產品中設定的工作，而只從EAI中的介面就可以完成產品註冊及相關設定。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：232.2.5.取得服務註冊資訊說明EAI平台主動向產品要求服務註冊資訊，並完成服務註冊。方法為EAI平台呼叫產品之syncProd並指定執行"getSrvRegInfo"服務，產品回傳服務註冊之XML訊息。規範2.2.05後提供服務合約註冊(此為服務組裝相關規範，請參考「整合規範文件-服務組裝」文件)。Operation名稱參數(EAI)回傳(各產品)syncProd執行服務名稱getSrvRegInfoXml訊息Xml訊息備註EAI向產品主機請求服務註冊資料：EAI可以不定時的向產品主機取回服務註冊資料，以保持EAI註冊服務的狀態是最新的。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：242.2.6.接收整合設定同步資訊說明執行同步程序：進入EAIWEB管理介面，並開啟「整合設定」頁面後，點選「執行同步程序」按鈕，確認功能並執行後，整合設定頁面中所列的產品會收到同步的XML訊息。同步程序執行的方法為EAI平台呼叫產品之syncProd並指定執行"doSyncProcess"服務。在產品收到同步的XML訊息後，需記錄下列的資訊：記錄EAI的WebService位置，以便執行發起端整合工作。記錄需進行整合產品的資訊。Operation名稱參數(EAI)回傳(各產品)syncProd執行服務名稱doSyncProcessXml訊息Xml訊息備註EAI傳送整合設定同步資料給產品主機：整合設定同步資料中包含EAI平台的WebService位置、已於EAI上註冊之產品的註冊資訊，以及其他共用參數資訊。當產品主機收到同步資料時，應針對資料內容進行整合的相關設定，例如設定透過EAI之方式進行整合、記錄EAI的WebService位置、記錄其他需要進行整合活動的產品之資訊等。產品整合開關：不同整合產品會根據其架構開發整合開關，在加入EAI的整合方式後，可能會有一個整合開關以控制是否使用EAI整合方式(或切換使用原有整合方式)。主要的方式分為「單一整合開關」或「單一產品個別整合開關」。DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：25整合產品端接收同步訊息後之程序圖：單一整合開關DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：26單一產品個別整合開關【返回】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：27【返回目錄】2.2.7.接收整合規範參數資訊說明EAI整合平台與產品間在整合過程中的參數協議，當參數內容有修改時，將透過呼叫產品的syncProd並執行syncInvokeParam服務，以此通知產品取用需要的參數並進行設定工作。Operation名稱參數(EAI)回傳(各產品)syncProd執行服務名稱syncInvokeParamXml訊息Xml訊息備註包括的參數內容：項目參數名稱說明執行整合服務逾時服務執行等待時間整合需求端可依此設定呼叫EAIWebService時等待的時間，需求端的設定必須大於此數值。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：282.2.8.接收同步主資料說明供EAI平台傳送同步的主資料至接收端，產品接收主資料後，需回應處理的結果。Operation名稱參數(EAI)回傳(各產品)invokeMdm執行服務名稱syncMasterDataXml訊息/已編碼訊息Xml訊息/已編碼訊息備註EAI傳送MDM同步資料給產品主機(主資料訂閱者)：EAI會將檢核無誤的主資料傳送至有訂閱的產品主機，產品主機在接收資料後進行資料更新，並回覆同步處理結果。詳細產品主機應回應之互動代碼請參考(Link)。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：292.2.9.接收資料編碼啟用狀態說明在EAI系統參數頁面中的「同步資料編碼啟用狀態」可以執行發送同步訊息至整合產品，整合產品在收到到此訊息後，需開啟資料編碼開關，並對invokeSrv及invokeMdm之payload資料進行資料編碼。Operation名稱參數(EAI)回傳(各產品)syncProd執行服務名稱syncEncodingStateXml訊息Xml訊息備註EAI傳送資料編碼啟用狀態給產品主機：傳送資料編碼啟用狀態給產品主機，以請求啟用或關閉資料編碼開關。【返回】【返回目錄】DigiwinEAIMiddleware整合規範智能+技術中心互聯中台技術部頁次：302.2.10.取得資料編碼啟用狀態說明EAI會定時向整合產品取...