1、用友U8產品技術介紹EAI目錄產品簡介產品結構產品特性應用領域EAI接口配置基礎設置外部系統(tǒng)注冊目錄（續(xù)）EAI數(shù)據(jù)交換導入導出設置數(shù)據(jù)映射數(shù)據(jù)導入數(shù)據(jù)導出EAI數(shù)據(jù)交換計劃數(shù)據(jù)交換計劃設置數(shù)據(jù)交換計劃執(zhí)行目錄（續(xù)）EAI二次開發(fā)接口規(guī)范接口調用通用SQL查詢EAI日志業(yè)務日志調試日志常見問題與解決U8EAI產品簡介產品結構U8EAI產品結構EAI導入導出工具手動導入導出工具XML導入導出EXCEL導入導出其他格式導入導出導入導出設置條件過濾規(guī)則增量規(guī)則導入導出目標地址定時計劃導入導出任務計劃規(guī)劃設計器任務計劃執(zhí)行引擎U8ERP數(shù)據(jù)交換業(yè)務接口基本檔案接口財務接口供應鏈接口生產制造接口其它接口

2、EAI數(shù)據(jù)交換框架EAI數(shù)據(jù)交換代理服務-EAI Broker（支持多種協(xié)議）EAI數(shù)據(jù)交換目錄EAI數(shù)據(jù)交換元數(shù)據(jù)數(shù)據(jù)映射規(guī)則EAI日志適配器框架專用適配器EXCELEDI通用適配器（XML）格式和數(shù)據(jù)適配規(guī)則EAI數(shù)據(jù)交換管理器外部系統(tǒng)管理數(shù)據(jù)映射管理適配器管理EAI日志管理解決方案管理產品特性應用特性內容完整：涵蓋了U8ERP的大部分基本檔案和業(yè)務單據(jù)（含憑證），是U8ERP目前最完整、規(guī)范的對外接口。功能豐富：支持手動、自動、遠程和本地接口等多種數(shù)據(jù)交換方式；支持數(shù)據(jù)映射、增量、過濾條件等多種數(shù)據(jù)交換規(guī)則。接口統(tǒng)一：對外提供了一個統(tǒng)一的服務代理接口，由此接口負責所有數(shù)據(jù)交換請求（調用）

3、的分發(fā)處理，使外部系統(tǒng)對U8的接口依賴減小到最少，降低的系統(tǒng)耦合性。技術特性XML數(shù)據(jù)交換格式： XML提供了跨平臺和低耦合特性，支持COM、.NET、JAVA三種平臺。Request/Response數(shù)據(jù)交換模式：數(shù)據(jù)交換的交互模式采用Request/Response方式，并通過標準的Request和Response消息來承載交互數(shù)據(jù)信息。支持本地和HTTP遠程調用：本地調用采用COM方式；遠程調用采用XMLHTTP POST的方式。應用領域企業(yè)內部第三方業(yè)務系統(tǒng)與U8的整合財務整合：憑證上傳典型案例：U8網(wǎng)絡分銷系統(tǒng)通過U8EAI接口向U8財務系統(tǒng)上傳結算憑證。業(yè)務整合：單據(jù)協(xié)同典型案例：

4、U8連鎖零售系統(tǒng)通過U8EAI接口與U8銷售和庫存系統(tǒng)進行業(yè)務協(xié)同。包括：零售部門下載公司U8系統(tǒng)中的商品、客戶檔案、庫存信息等；往U8系統(tǒng)上傳每日結算的零售日報；庫存不夠了往U8發(fā)調撥申請單進行要貨調撥等等業(yè)務。企業(yè)之間的B2B業(yè)務協(xié)作供應鏈協(xié)同典型案例：供應商遠程接收訂單?；锇榭蛻舻牟少徬到y(tǒng)通過供應商U8EAI遠程接口往供應商U8銷售系統(tǒng)提交訂單。U8EAI接口配置U8EAI接口配置包括兩項內容：EAI基本設置、外部系統(tǒng)注冊?；驹O置目的：指定EAI默認登錄信息，包括指定U8應用服務器名或IP、EAI登錄身份驗證、EAI數(shù)據(jù)源。如果進行數(shù)據(jù)交換的數(shù)據(jù)包比較大，則需要點“自動設置IIS”更改

5、IIS的最大數(shù)據(jù)上傳或下載限制。外部系統(tǒng)注冊目的：為了建立外部系統(tǒng)與U8業(yè)務帳套之間的數(shù)據(jù)交換關系。在數(shù)據(jù)交換中，需要明確指定外部系統(tǒng)與U8某個業(yè)務賬套的對應關系，該對應關系由一個唯一的注冊碼標識。數(shù)據(jù)交換時需要在請求消息的頭部指定一個注冊碼： ，表示請求方需要與該注冊碼對應的U8業(yè)務帳套進行數(shù)據(jù)交換。U8EAI接口配置基本設置“開始”-“程序”-“用友ERP-U8V10.0”-“企業(yè)應用集成(EAI)”-“EAI接口設置”U8EAI接口配置外部系統(tǒng)注冊在“EAI接口設置”中切換到外部系統(tǒng)注冊頁簽進行外部系統(tǒng)注冊?？梢宰远鄠€外部系統(tǒng)注冊碼。U8EAI接口配置外部系統(tǒng)注冊在進行外部系統(tǒng)注冊時，

6、還可以同時指定U8業(yè)務帳套的連接身份，默認“使用EAI的連接身份”。U8EAI數(shù)據(jù)交換導入導出設置在數(shù)據(jù)交換之前，用戶可設置每個具體項目的導入或導出文件的存放路徑及導出數(shù)據(jù)的過濾條件，在以后的數(shù)據(jù)交換時系統(tǒng)按照預設的條件進行操作。U8EAI數(shù)據(jù)交換數(shù)據(jù)映射在進行數(shù)據(jù)交換時，外部系統(tǒng)與內部系統(tǒng)的基礎檔案可能存在不一致的情況，這時需要建立外部數(shù)據(jù)、內部數(shù)據(jù)之間的對應關系。U8EAI數(shù)據(jù)交換數(shù)據(jù)導入數(shù)據(jù)導入功能：將檔案或單據(jù)數(shù)據(jù)(可批量)導入到外部系統(tǒng)注冊碼對應的U8業(yè)務帳套中，同時支持多種導入文件格式，如常見的XML和Excel格式。U8EAI數(shù)據(jù)交換數(shù)據(jù)導出數(shù)據(jù)導出功能：根據(jù)所選外部系統(tǒng)注冊碼，

7、導出對應U8業(yè)務帳套中保存的一個或多個檔案或單據(jù)項目的全部或部分數(shù)據(jù)。U8EAI數(shù)據(jù)交換計劃應用場景實現(xiàn)在無人值守的情況下，U8EAI能按預先設置的計劃自動的進行數(shù)據(jù)交換。典型應用場景：多個U8業(yè)務帳套之間的檔案或單據(jù)數(shù)據(jù)同步。操作步驟首先進行數(shù)據(jù)交換計劃的參數(shù)設置。一個注冊編碼可以設置一個定時計劃，一個定時計劃中可以設置多個自動導入導出項目的執(zhí)行規(guī)則，包括：執(zhí)行頻率、執(zhí)行期間和是否按照數(shù)據(jù)映射關系執(zhí)行。然后執(zhí)行數(shù)據(jù)交換計劃。單擊【數(shù)據(jù)交換計劃執(zhí)行】菜單，當?shù)竭_預置的計劃時間，U8EAI就會自動執(zhí)行已定義的數(shù)據(jù)交換任務。U8EAI數(shù)據(jù)交換計劃數(shù)據(jù)交換計劃設置指定數(shù)據(jù)交換執(zhí)行的時間和頻率，并設置

8、導入導出的條件和路徑以及是否按照數(shù)據(jù)映射關系執(zhí)行。U8EAI數(shù)據(jù)交換計劃數(shù)據(jù)交換計劃執(zhí)行單擊【數(shù)據(jù)交換計劃執(zhí)行】菜單，在windows的狀態(tài)欄中顯示一小圖標 ，即【用友U8EAI計劃監(jiān)控程序】。U8EAI二次開發(fā)U8應用服務器外部系統(tǒng)二次開發(fā)工作EAI 數(shù)據(jù)交換COM接口IIS調用EAI接口數(shù)據(jù)轉換或處理本地調用遠程調用U8EAI接口規(guī)范接口定義本地COM接口類庫：U8Distribute.DLLProgID：U8Distribute.iDistribute方法：String Process(String RequestXml)參數(shù)：數(shù)據(jù)交換請求消息，詳見數(shù)據(jù)交換格式定義。返回：數(shù)據(jù)交換響應消

9、息，詳見數(shù)據(jù)交換格式定義。遠程HTTP接口EAI遠程數(shù)據(jù)交換采用Http POST的方式。訪問網(wǎng)址： http:/U8應用服務器IP或機器名/U8EAI/import.aspPOST上傳：數(shù)據(jù)交換請求消息與本地調用一樣。 Response接收：數(shù)據(jù)交換響應消息與本地調用一樣。 U8EAI接口規(guī)范數(shù)據(jù)交換格式總體格式EAI數(shù)據(jù)交換消息格式分為框架和內容兩部分： 框架部分 內容部分 框架部分包含數(shù)據(jù)交換的控制信息，其中：sender: 發(fā)送方，填外部系統(tǒng)注冊碼receiver: 接收方，填u8即可roottag: 檔案或單據(jù)，填檔案或單據(jù)的唯一標識proc：操作類型，分為“增刪改查”，對應填add

10、/delete/edit/querydynamicdate: 業(yè)務賬套登錄日期,如果不填,則取U8應用服務器所在操作系統(tǒng)的當前日期U8EAI接口規(guī)范數(shù)據(jù)交換格式總體格式內容部分：指數(shù)據(jù)請求或響應消息中攜帶的檔案或單據(jù)等業(yè)務數(shù)據(jù)，如：U8EAI提供了一整套完整的基本檔案和單據(jù)的數(shù)據(jù)交換模版（在EAIXMLTemplate目錄下），模板中定義了消息內容部分的格式和字段。10綜合處1管理兼技術U8EAI接口規(guī)范數(shù)據(jù)交換格式Request-請求消息格式對于add/edit操作，Request消息的內容就是檔案和單據(jù)內容，舉例如下，具體格式請詳見EAI提供的數(shù)據(jù)模板。0011基建投資部22011-01-

11、26部常見問題與解決數(shù)據(jù)交換格式條件過濾對于delete/query操作， Request消息的內容包含過濾條件。查詢單條數(shù)據(jù)的時候往往需要帶上條件，可以采用U8EAI通用SQL查詢，也可以采用U8EAI標準的條件查詢格式，如：注意:field節(jié)點中的name過濾字段名需和數(shù)據(jù)庫中字段名一致。 U8EAI接口規(guī)范數(shù)據(jù)交換格式Response-響應消息格式Response消息是EAI接口執(zhí)行Request消息之后的返回結果，不同的操作有所不同：對于query操作， 返回的結果就是查詢的數(shù)據(jù)，格式詳見EAI數(shù)據(jù)模板。對于add/edit/delete操作，返回的結果包括單據(jù)體每一行數(shù)據(jù)的詳細執(zhí)行結

12、果(由Item節(jié)點描述)，如下：U8EAI接口規(guī)范數(shù)據(jù)交換格式Response-響應消息格式憑證的add操作的Response格式比較特殊，如下：返回字段含義如下：accounting_period：會計期間，0為期初往來明細帳，21為期初待核銀行帳，20為銀行帳科目調整前余額，1-12為憑證及明細帳；voucher_type：憑證類別字；voucher_id：外部系統(tǒng)原始憑證號(期初時可為空)；u8voucher_id：U8生成的憑證號；u8accounting_period ：U8憑證會計期間succeed：是否成功，0為成功，非零為失敗。U8EAI接口調用本地COM調用VB代碼: Dim

13、 eaiBroker As Object Set eaiBroker = CreateObject(“U8Distribute.iDistribute”) 創(chuàng)建EAI服務代理接口對象 Dim responseXml As String responseXml = eaiBroker.Process(requestXml) 調用EAI服務代理的數(shù)據(jù)交換方法Process，傳入 Request交換消息， 并獲取EAI返回的Response消息。 . 處理返回結果 Set eaiBroker = Nothing 釋放EAI服務代理接口對象.NET代碼: /引用U8SOFTEAIU8Distribut

14、e.dll U8Distribute.iDistributeClass eaiBroker = new U8Distribute.iDistributeClass(); /創(chuàng)建EAI服務代理接口對象 String responseXml = eaiBroker.Process(requestXml); /調用EAI服務代理的數(shù)據(jù)交換方法Process，傳入 / Request交換消息， 并獲取EAI返回的Response消息。 /處理返回結果 System.Runtime.InteropServices.Marshal.FinalReleaseComObject(eaiBroker); /釋放

15、EAI服務代理接口對象U8EAI接口調用本地COM調用JAVA代碼: 采用JNI、JCOM、JACOB技術調用EAI服務代理COM組件,下面以JACOB為例： import .Dispatch; import .Variant; class Test public static void main(String args) /創(chuàng)建EAI服務代理接口對象 Dispatch eaiBroker = new Dispatch(U8Distribute.iDistribute); /調用EAI服務代理的數(shù)據(jù)交換方法Process，傳入Request交換消息， 并獲取EAI /返回的Response消息

16、。 String responseXml = Dispatch.call(eaiBroker, Process, new Variant(requestXml); /處理返回結果 U8EAI接口調用Http遠程調用VB代碼: Dim xmlhttp As Object Set xmlhttp = CreateObject(“MSXML2.XMLHTTP”) 創(chuàng)建XMLHTTP對象 Call xmlhttp.open(“POST”, “http:/u8appsrv/u8eai/import.asp”, False) 使用XMLHTTP對象打開網(wǎng)絡連接 xmlhttp.send requestXm

17、l 發(fā)送Request消息 Dim responseXml As String responseXml = xmlhttp.responseText 獲取返回Response消息. 處理返回結果.NET代碼: /引用U8SOFTInteropInterop.MSXML2.dll MSXML2.XMLHTTPClass xmlHttp = new MSXML2.XMLHTTPClass(); /創(chuàng)建XMLHTTP對象 xmlHttp.open(“POST”, “http:/u8appsrv/u8eai/import.asp”, false, null, null);/打開網(wǎng)絡連接 xmlHttp

18、.send(dom.OuterXml);/發(fā)送Request消息 String responseXml = xmlHttp.responseText;/獲取返回Response消息 /處理返回結果 System.Runtime.InteropServices.Marshal.FinalReleaseComObject(xmlHttp); /COM釋放注意： URL： http:/u8appsrv/u8eai/import.asp 中的u8appsrv應填U8應用服務器IP或機器名。U8EAI接口調用Http遠程調用JAVA代碼: class Test public static void ma

19、in(String args) URL url = new URL(“http:/u8appsrv/u8eai/import.asp”); HttpURLConnection con = (HttpURLConnection)url.openConnection(); con.setConnectTimeout(3000000); con.setReadTimeout(3000000); con.setDoInput(true); con.setDoOutput(true); con.setAllowUserInteraction(false); con.setUseCaches(false)

20、; con.setRequestMethod(POST); con.setRequestProperty(Content-type,application/x-www-form-urlencoded); /發(fā)送Request消息 OutputStream out = con.getOutputStream(); DataOutputStream dos = new DataOutputStream(this.out); dos.write(requestXml.getBytes(UTF-8); /獲取Response消息 InputStream in = con.getInputStream(

21、); BufferedReader br = new BufferedReader(new InputStreamReader(in); StringBuilder sb = new StringBuilder(); String s = null; while (s = br.readLine() != null) sb.append(s); String responseXml = sb.toString(); U8EAI接口調用U8EAI接口調用調用U8API接口請求XML格式其中，proc填入操作類型，添加：add；編輯：edit；刪除：delete；查詢：query；審核：verif

22、y；棄審：unverify。 U8EAI接口調用調用U8API接口返回XML格式以上為查詢返回XML格式，新增成功后，還會返回新增單據(jù)或檔案的ID。U8EAI接口調用調用U8API接口返回錯誤信息按傳入順序返回批量操作的執(zhí)行結果，調用一次API的過程中若出現(xiàn)錯誤，不影響其他調用的執(zhí)行。通用SQL查詢接口由于EAI接口返回的數(shù)據(jù)格式是固定的標準格式，很有可能返回的數(shù)據(jù)中沒有用戶所需要的字段；另外，對于U8中的業(yè)務數(shù)據(jù)，EAI接口也不是100%覆蓋的。針對以上情況，EAI提供了一個靈活的數(shù)據(jù)查詢通用接口-EAI通用SQL查詢接口，該接口支持向EAI數(shù)據(jù)交換代理傳遞SQL語句進行查詢操作，可以查詢當

23、前U8帳套的所有數(shù)據(jù)，用戶不用直接訪問U8帳套庫。查詢返回的結果為.NET中的Dataset的XML格式的數(shù)據(jù)。調用該接口只需給EAI數(shù)據(jù)交換服務代理傳遞特殊的Request消息即可。通用SQL查詢接口 通用SQL查詢接口Response消息格式其中，根節(jié)點的proc的值用來標識Dataset的行節(jié)點，一般為表名。 1true采購1部2true銷售1部U8EAI日志U8EAI業(yè)務日志日志設置“開始程序用友ERP-U8V10.0企業(yè)應用集成(EAI) U8EAI接口設置”進入配置界面，切換到第三個頁簽“日志設置”，可以啟用和關閉日志，并可以配置日志清除策略。默認的日志清除策略是：日志清除周期為1

24、周。用戶可以根據(jù)實際數(shù)據(jù)交換業(yè)務量的情況修改此策略。U8EAI業(yè)務日志日志查看查看功能路徑從企業(yè)門戶功能菜單或直接登錄“企業(yè)應用集成”，可以打開日志查看界面，查看業(yè)務日志項和日志內容。具體功能菜單為：企業(yè)應用集成數(shù)據(jù)交換日志查看數(shù)據(jù)交換日志。U8EAI業(yè)務日志日志查看查看界面日志查看界面總體分為左樹日志分類目錄和右邊的日志項列表。日志的分類體系采用U8的產品模塊結構進行多級分類，末級為數(shù)據(jù)交換業(yè)務數(shù)據(jù)（檔案和單據(jù)）；可以區(qū)分不同外部系統(tǒng)與U8進行數(shù)據(jù)交換的日志。U8EAI業(yè)務日志日志查看日志內容每進行一次數(shù)據(jù)交換會產生一條日志項。日志的主要內容包括：數(shù)據(jù)交換時間、數(shù)據(jù)（單據(jù)或檔案）類型、操作類

25、型（增刪改）、數(shù)據(jù)交換狀態(tài)（成功/失?。?、最后執(zhí)行任務信息。U8EAI業(yè)務日志日志查看日志詳細信息雙擊日志項可以查看日志詳細信息。對于導入操作，日志詳細信息顯示如下界面：對于導出操作，日志詳細信息顯示如下界面：U8EAI調試日志日志啟用EAI調試日志的啟用可以通過手動修改配置文件來設置，調試日志配置文件的路徑為：%U8SOFT%EAI ConfigLogConfig.ini。日志文件中有三行內容：重要提示：修改日志開關后需要重啟IIS。 U8EAI調試日志日志查看EAI調試日志以文件的方式存儲，日志文件系統(tǒng)根目錄為：%U8SOFT%EAILogs，在此目錄下，EAI會按“外部系統(tǒng)注冊碼單據(jù)類型

26、日志項”的層次結構對日志進行分類存儲：每一次數(shù)據(jù)交換會生成一個調試日志項目錄，日志項目錄名包含日期時間后綴，目錄中包含三個文件：Request.xml：記錄數(shù)據(jù)交換的請求消息；Response.xml：記錄數(shù)據(jù)交換的響應消息（即返回結果）；EaiDistributeLog.txt：記錄數(shù)據(jù)交換詳細執(zhí)行過程和步驟。常見問題與解決常見問題與解決通用SQL查詢問題U8EAI返回錯誤：調用業(yè)務組件UFIDA.U8.IEAISqlExecutor.SQLExecutor發(fā)生異常，原因：執(zhí)行查詢出錯：無法打開登錄UFDATA_001_2010中請求的數(shù)據(jù)庫。登錄失敗。(錯誤號：-2146233088)調用業(yè)務組件UFIDA.U8.IEAISqlExecutor.SQLExecutor發(fā)生異常，原因：創(chuàng)建只讀用戶出錯: No error message available, result code: DB_E_ERRORSOCCURRED(0 x80040E21).(錯誤號：-2146233088)問題原因：創(chuàng)建數(shù)據(jù)庫用戶“reader”或通過“reader”用戶查詢帳套數(shù)據(jù)庫無權限。解決：手動在SQL SERVER中創(chuàng)建登錄用戶“reade