1、U8EAI培訓案例培訓案例U8U8平臺開發部平臺開發部李靜李靜2009年年1月月4 4日日 應用篇應用篇 案例背景案例背景 需求分析需求分析 解決方案解決方案 開發步驟開發步驟 提高篇提高篇 深入分析深入分析 解決方案解決方案 開發步驟開發步驟一、案例背景一、案例背景 A公司是一家專業辦公設備經銷商。在企業創建之初，公司是一家專業辦公設備經銷商。在企業創建之初，由于規模和業務量都不大，在管理上并沒有出現多大問題。由于規模和業務量都不大，在管理上并沒有出現多大問題。隨著公司的發展，在財務上采用傳統手工處理的方式逐漸隨著公司的發展，在財務上采用傳統手工處理的方式逐漸暴露出越來越多的問題。于是公司引

2、進了一套暴露出越來越多的問題。于是公司引進了一套U8財務系統財務系統來有效管理企業的應收賬款和出入現金流。來有效管理企業的應收賬款和出入現金流。 為了更好的拓展和輻射外地市場，提高市場占有率和為了更好的拓展和輻射外地市場，提高市場占有率和客戶服務水平，公司逐步在全國許多城市建立了自己的經客戶服務水平，公司逐步在全國許多城市建立了自己的經銷網點和客服中心，為了提高運營效率，降低成本，加強銷網點和客服中心，為了提高運營效率，降低成本，加強管控，公司決定為整個分銷網絡部署一套綜合業務系統，管控，公司決定為整個分銷網絡部署一套綜合業務系統，通過資源共享與實時調度提高整個銷售網絡的靈活度和有通過資源共享

3、與實時調度提高整個銷售網絡的靈活度和有效應對市場變化的能力，并為客戶提供一流的服務水平。效應對市場變化的能力，并為客戶提供一流的服務水平。 應用篇應用篇-案例背景案例背景 但問題隨之產生，由于但問題隨之產生，由于A公司的外地營銷網點規模普公司的外地營銷網點規模普遍很小，不具備獨立核算能力，而且公司即將部署的綜合遍很小，不具備獨立核算能力，而且公司即將部署的綜合業務系統并不具備專業的財務管理功能，在財務上仍然必業務系統并不具備專業的財務管理功能，在財務上仍然必須由公司集中管控。而且，多年來，公司在須由公司集中管控。而且，多年來，公司在U8財務軟件的財務軟件的幫助下已逐步形成了一套嚴謹高效的財務管

4、理流程和制度，幫助下已逐步形成了一套嚴謹高效的財務管理流程和制度，如果擯棄如果擯棄U8，去開發和部署新的能連接業務系統的財務軟，去開發和部署新的能連接業務系統的財務軟件，不僅會浪費公司現有的件，不僅會浪費公司現有的IT資產，增加資產，增加IT投資成本，更投資成本，更重要的是會浪費公司積累起來的適合自己實情的寶貴管理重要的是會浪費公司積累起來的適合自己實情的寶貴管理經驗。經驗。 A公司老總認為，如果能將綜合業務系統與現有的公司老總認為，如果能將綜合業務系統與現有的U8財務軟件實現整合，必將帶來雙贏的利益：一方面降低了財務軟件實現整合，必將帶來雙贏的利益：一方面降低了IT投資成本，節約了時間；另一

5、方面促進了公司財務管理投資成本，節約了時間；另一方面促進了公司財務管理的持續完善和創新。的持續完善和創新。應用篇應用篇-案例背景案例背景二、需求分析二、需求分析 A公司的綜合業務系統能有效管理經銷網點的銷售和公司的綜合業務系統能有效管理經銷網點的銷售和售后業務帳以及倉庫臺帳：能開具發票，進行收款結算；售后業務帳以及倉庫臺帳：能開具發票，進行收款結算；能管理發貨和收貨，進行商品盤點和結存；能統計和分析能管理發貨和收貨，進行商品盤點和結存；能統計和分析銷售狀況；能處理退貨、維修等售后業務。銷售狀況；能處理退貨、維修等售后業務。 這些業務活動為公司帶來的盈利或虧損，必須要通過這些業務活動為公司帶來的

6、盈利或虧損，必須要通過公司總部的會計系統（公司總部的會計系統（U8財務系統）進行記賬、核算、以財務系統）進行記賬、核算、以及財務報表分析，才能正確反映公司的經營狀況和業績。及財務報表分析，才能正確反映公司的經營狀況和業績。 這就是說，綜合業務系統和這就是說，綜合業務系統和U8財務系統的連接必須要財務系統的連接必須要能實現自動記賬功能。具體來說就是要將綜合業務系統的能實現自動記賬功能。具體來說就是要將綜合業務系統的結算憑證結算憑證銷售發票轉換成銷售發票轉換成U8的記賬憑證，并傳遞給的記賬憑證，并傳遞給U8系統進行會計記賬。系統進行會計記賬。應用篇應用篇-需求分析需求分析三、解決方案三、解決方案

7、要實現自動記賬功能，首先需要將業務系統的結算憑要實現自動記賬功能，首先需要將業務系統的結算憑證證銷售發票轉換成銷售發票轉換成U8的記賬憑證；隨后還要能將轉換后的記賬憑證；隨后還要能將轉換后的記賬憑證傳遞到的記賬憑證傳遞到U8。 解決方案是使用解決方案是使用U8EAI數據交換接口。數據交換接口。 U8EAI數據交數據交換接口提供了換接口提供了U8與外部系統進行交流的與外部系統進行交流的“窗口窗口”，U8EAI定義了一套標準的數據交換格式，外部系統只要遵循此格定義了一套標準的數據交換格式，外部系統只要遵循此格式，在數據一致的前提下，便能與式，在數據一致的前提下，便能與U8進行交互。進行交互。 數據

8、一致的意思是要保證各種數據依賴條件的一致，數據一致的意思是要保證各種數據依賴條件的一致，在本項目中就是指憑證中所記錄的經濟活動核算對象和要在本項目中就是指憑證中所記錄的經濟活動核算對象和要素要一致，比如：憑證中所反映的客戶、部門等核算對象素要一致，比如：憑證中所反映的客戶、部門等核算對象信息在業務系統和信息在業務系統和U8中要保持一致，如果不一致，需要進中要保持一致，如果不一致，需要進行數據同步或映射轉換。行數據同步或映射轉換。 遵循遵循U8的憑證格式是指需要采用某種方式將業務系統的憑證格式是指需要采用某種方式將業務系統的銷售發票轉換成的銷售發票轉換成U8的憑證格式，這一般需要進行二次開的憑證

9、格式，這一般需要進行二次開發。發。應用篇應用篇-解決方案解決方案四、開發步驟四、開發步驟1、將業務系統結算憑證轉換為、將業務系統結算憑證轉換為U8記賬憑證。記賬憑證。 2、將憑證傳遞給、將憑證傳遞給U8并記賬。并記賬。 應用篇應用篇-開發步驟開發步驟1、將業務系統結算憑證轉換為、將業務系統結算憑證轉換為U8記賬憑證記賬憑證 U8EAI的數據交換格式由數據模板描述，的數據交換格式由數據模板描述，EAI的模的模板統一放在板統一放在U8SOFTEAIXMLTemplate目錄下，以文目錄下，以文件的形式存儲。件的形式存儲。 其中憑證的模板為其中憑證的模板為Voucher.xml，在此文件中描述了，在

10、此文件中描述了憑證所包含的表頭字段以及表體的分錄字段、輔助核算憑證所包含的表頭字段以及表體的分錄字段、輔助核算字段等，對字段的數據類型、大小、取值規則也做了規字段等，對字段的數據類型、大小、取值規則也做了規定。定。 要將外部系統的銷售發票格式轉換成要將外部系統的銷售發票格式轉換成U8憑證的格式，憑證的格式，一般采用二次開發編程的方式進行，也可以采用比較通一般采用二次開發編程的方式進行，也可以采用比較通用的用的XSLT進行轉換。進行轉換。 由于外部系統的格式是未知的，在本實踐項目中假由于外部系統的格式是未知的，在本實踐項目中假定已經做了轉換，我們只需要事先準備好轉換完成的數定已經做了轉換，我們只

11、需要事先準備好轉換完成的數據即可，憑證數據的準備可以直接依據模板來手工構造據即可，憑證數據的準備可以直接依據模板來手工構造憑證的憑證的XML文件，也可以采用一下簡便方法：文件，也可以采用一下簡便方法： 應用篇應用篇-開發步驟開發步驟 先在先在U8中錄一個收款憑證作為范例中錄一個收款憑證作為范例 應用篇應用篇-開發步驟開發步驟隨后使用隨后使用EAI將其導出，注意要用剛才建的憑證號設置將其導出，注意要用剛才建的憑證號設置導出過濾條件。導出過濾條件。登錄登錄EAI：“開始開始”-“程序程序”-“用友用友ERP-U8”-“企業應用集成（企業應用集成（EAI）”-“企業應用集成企業應用集成”；左樹左樹“

12、系統菜單系統菜單”-“設置設置”- “系統注冊系統注冊”，為，為 U8的某個帳套注冊一個數據交換編碼，表明與外部系統的的某個帳套注冊一個數據交換編碼，表明與外部系統的對應關系；對應關系； 應用篇應用篇-開發步驟開發步驟應用篇應用篇-開發步驟開發步驟左樹“系統菜單”-“數據交換”- “數據交換”，先設置憑證過濾條件，然后導出為一個XML文件：應用篇應用篇-開發步驟開發步驟設置憑證過濾條件：點“保存”后“退出”回到上一個界面，點“執行”即可。假設導出的憑證文件為假設導出的憑證文件為“簡單憑證簡單憑證.xml ”，用編輯工具，用編輯工具（比如：記事本）打開此文件，將根節點修改一下：（比如：記事本）打

13、開此文件，將根節點修改一下： 根節點根節點ufinterface的兩個屬性含義如下：的兩個屬性含義如下： proc=add ：表示操作類型，表示操作類型，add表示新增。表示新增。 renewproofno=y：表示憑證導入表示憑證導入U8后是否重新編碼，后是否重新編碼，應該填應該填y。修改完后保存。這樣，我們的憑證文件就制作好了（示例修改完后保存。這樣，我們的憑證文件就制作好了（示例憑證詳見憑證詳見SAMPLES簡單憑證簡單憑證.xml ）。隨后就可以使用）。隨后就可以使用EAI數據交換接口將其導入數據交換接口將其導入U8并記賬。并記賬。應用篇應用篇-開發步驟開發步驟2、將憑證傳遞給、將憑證

14、傳遞給U8并記賬并記賬 將憑證傳遞給將憑證傳遞給U8并記賬其實就是調用并記賬其實就是調用EAI數據交換接口將憑數據交換接口將憑證導入證導入U8。 首先需要配置首先需要配置EAI接口：接口： “開始開始”-“程序程序”-“用友用友ERP-U8”-“企業應用集成（企業應用集成（EAI）”-“U8EAI接口設置接口設置”； 應用篇應用篇-開發步驟開發步驟隨后就可以調用隨后就可以調用EAI接口將憑證導入接口將憑證導入U8，以，以VB代碼為例：代碼為例： Dim xmlhttp As Object Set xmlhttp = CreateObject(“MSXML2.XMLHTTP”) 創建XMLHTT

15、P對象 Call xmlhttp.open(“POST”, “http:/u8appsrv/u8eai/import.asp”, False) 使用XMLHTTP對象打開網絡連接，URL中的u8appsrv填U8應用服務器 xmlhttp.send requestXml 發送Request消息 Dim responseXml As String responseXml = xmlhttp.responseText 獲取返回Response消息 . 處理返回結果憑證接口的返回格式如下：憑證接口的返回格式如下： succeed=“0”表示成功保存； u8voucher_id=“19”返回憑證號。應

16、用篇應用篇-開發步驟開發步驟 應用篇的詳細示例見應用篇的詳細示例見SAMPLES包，其中包，其中“簡單憑證簡單憑證.xml”為應用篇的憑證示例，為應用篇的憑證示例，Code目錄為代碼示例，目錄為代碼示例，“工程工程1.exe”為代碼編譯后的測試程序。為代碼編譯后的測試程序。應用篇應用篇-開發步驟開發步驟一、深入分析一、深入分析 對于客戶往來的應收款憑證，一般包含有客戶、部門對于客戶往來的應收款憑證，一般包含有客戶、部門等輔助核算項。等輔助核算項。 而客戶、部門、人員等這些基礎資料在企業的業務系而客戶、部門、人員等這些基礎資料在企業的業務系統和統和U8財務系統中很有可能不一致，不一致的情況一般有

17、財務系統中很有可能不一致，不一致的情況一般有以下幾種：以下幾種： 1、A公司的綜合業務系統由于直接面向市場客戶，故公司的綜合業務系統由于直接面向市場客戶，故其包含的客戶資料比其包含的客戶資料比U8財務系統更多。財務系統更多。 2、由于兩個系統的基礎資料編碼規則可能不一致，、由于兩個系統的基礎資料編碼規則可能不一致，對于同一個客戶資料，可能在業務系統中的編碼是對于同一個客戶資料，可能在業務系統中的編碼是C-01，在在U8系統中可能是系統中可能是001。 以上兩種情況的存在，都會導致相關的客戶往來憑證以上兩種情況的存在，都會導致相關的客戶往來憑證無法導入無法導入U8記賬。記賬。提高篇提高篇-深入分

18、析深入分析二、解決方案二、解決方案 解決這個問題的思路是：在上傳憑證之前要保證業務解決這個問題的思路是：在上傳憑證之前要保證業務系統和系統和U8的客戶檔案等基礎資料一致。的客戶檔案等基礎資料一致。 如果是第一種情況，即客戶檔案的編碼可以相同，但如果是第一種情況，即客戶檔案的編碼可以相同，但業務系統中的客戶多于業務系統中的客戶多于U8系統中的客戶。如果數量不大且系統中的客戶。如果數量不大且不會經常變化，則可以采用手工錄入的方式進行補平；如不會經常變化，則可以采用手工錄入的方式進行補平；如果數量很大且經常變化，則最好采用自動的方式：業務系果數量很大且經常變化，則最好采用自動的方式：業務系統中如果增

19、加了客戶，則將此客戶自動導入到統中如果增加了客戶，則將此客戶自動導入到U8系統中，系統中，導入的方式是調用導入的方式是調用U8EAI接口進行客戶檔案導入，具體實接口進行客戶檔案導入，具體實現與憑證自動導入類似，需要遵循現與憑證自動導入類似，需要遵循U8EAI客戶檔案數據交客戶檔案數據交換格式。換格式。 對于第二種情況，即雙方系統的編碼規則不一致，對于第二種情況，即雙方系統的編碼規則不一致，如如果兩邊檔案完全相同，只是編碼不一致，則可以采用編碼果兩邊檔案完全相同，只是編碼不一致，則可以采用編碼映射的方式進行對照轉換；如果編碼不一致的情況下客戶映射的方式進行對照轉換；如果編碼不一致的情況下客戶檔案

20、數量也不相同，業務系統多于檔案數量也不相同，業務系統多于U8系統，則需要按第一系統，則需要按第一種情況的做法將客戶檔案同步到種情況的做法將客戶檔案同步到U8，同步的同時還需要進，同步的同時還需要進提高篇提高篇-解決方案解決方案行編碼規則轉換，這種情況較為復雜，需要找出編碼轉換行編碼規則轉換，這種情況較為復雜，需要找出編碼轉換規律。規律。 在本實踐項目中只考慮以下兩種情況：在本實踐項目中只考慮以下兩種情況： 1、編碼相同情況下，需要將業務系統中的新增客戶檔、編碼相同情況下，需要將業務系統中的新增客戶檔案導入案導入U8。 2、客戶檔案完全一樣，只是編碼不相同，需要進行編、客戶檔案完全一樣，只是編碼

21、不相同，需要進行編碼映射。碼映射。 提高篇提高篇-解決方案解決方案三、開發步驟三、開發步驟 第一種情況的開發步驟：第一種情況的開發步驟： 1、將業務系統的客戶檔案轉換成、將業務系統的客戶檔案轉換成U8客戶檔案。客戶檔案。 2、將轉換后的客戶檔案使用、將轉換后的客戶檔案使用U8EAI接口導入接口導入U8。 3、將業務系統結算憑證轉換為、將業務系統結算憑證轉換為U8記賬憑證。記賬憑證。 4、調用、調用U8EAI接口將憑證傳遞給接口將憑證傳遞給U8并記賬。并記賬。 提高篇提高篇-開發步驟開發步驟1、將業務系統的客戶檔案轉換成、將業務系統的客戶檔案轉換成U8客戶檔案客戶檔案U8EAI客戶檔案的模板文件

22、為：客戶檔案的模板文件為：U8SOFTEAIXMLTemplateCustomer.xml, 依據此模板文件將外部系統的客戶檔案格式轉換成依據此模板文件將外部系統的客戶檔案格式轉換成U8客客戶格式，可以采用二次開發編程的方式進行，也可以采戶格式，可以采用二次開發編程的方式進行，也可以采用比較通用的用比較通用的XSLT進行轉換。進行轉換。 在本實踐項目中假定已經做好了客戶檔案轉換，我在本實踐項目中假定已經做好了客戶檔案轉換，我們只需要事先準備好轉換后的客戶檔案數據即可，準備們只需要事先準備好轉換后的客戶檔案數據即可，準備的方法跟應用篇中準備憑證相同，可以在的方法跟應用篇中準備憑證相同，可以在U8

23、中建一個客中建一個客戶檔案并使用戶檔案并使用EAI導出。假定文件名為導出。假定文件名為“客戶檔客戶檔案案.xml”。打開此文件，修改根節點的。打開此文件，修改根節點的proc屬性值屬性值為為”add”： ufinterface sender=“001” receiver=“u8” roottag=“customer” proc=“add“ （示例詳見（示例詳見SAMPLES客戶檔案客戶檔案.xml ）。）。 提高篇提高篇-開發步驟開發步驟2、將轉換后的客戶檔案使用、將轉換后的客戶檔案使用U8EAI接口導入接口導入U8 代碼示例同憑證導入，詳見代碼示例同憑證導入，詳見SAMPLESCode 。3

24、、將業務系統結算憑證轉換為、將業務系統結算憑證轉換為U8記賬憑證記賬憑證 主要過程和應用篇相同，但憑證內容應該是帶客戶輔助核算主要過程和應用篇相同，但憑證內容應該是帶客戶輔助核算的應收款憑證，其中客戶為前兩個步驟導入的應收款憑證，其中客戶為前兩個步驟導入U8的新客戶：的新客戶： 先通過應收款系統錄一個收款單先通過應收款系統錄一個收款單提高篇提高篇-開發步驟開發步驟 隨后制單生成憑證隨后制單生成憑證 提高篇提高篇-開發步驟開發步驟接著使用接著使用EAI導出，詳見應用篇。導出，詳見應用篇。這里導出的憑證分錄中就包含客戶輔助核算項：這里導出的憑證分錄中就包含客戶輔助核算項： 1 C007 另外要注意

25、憑證另外要注意憑證Xml數據的數據的ufinterface節點的控制屬性的設節點的控制屬性的設置（同應用篇）：置（同應用篇）： 根節點根節點ufinterface的兩個屬性含義如下：的兩個屬性含義如下： proc=add ：表示操作類型，表示操作類型，add表示新增。表示新增。 renewproofno=y：表示憑證導入表示憑證導入U8后是否重新編碼，后是否重新編碼，應該填應該填y。提高篇提高篇-開發步驟開發步驟帶輔助核算項的憑證數據準備好后，就可以調用帶輔助核算項的憑證數據準備好后，就可以調用EAI接口接口導入了。導入了。4、調用、調用U8EAI接口將憑證傳遞給接口將憑證傳遞給U8并記賬并記

26、賬 詳見應用篇。詳見應用篇。提高篇提高篇-開發步驟開發步驟 第二種情況的開發步驟：第二種情況的開發步驟： 1、在、在U8EAI中配置客戶檔案編碼映射。中配置客戶檔案編碼映射。 2、將業務系統結算憑證轉換為、將業務系統結算憑證轉換為U8記賬憑證。記賬憑證。 3、調用、調用U8EAI接口將憑證傳遞給接口將憑證傳遞給U8并記賬，在此過程并記賬，在此過程中自動進行客戶檔案編碼轉換。中自動進行客戶檔案編碼轉換。 提高篇提高篇-開發步驟開發步驟1、在、在U8EAI中配置客戶檔案編碼映射中配置客戶檔案編碼映射登錄登錄EAI：“開始開始”-“程序程序”-“用友用友ERP-U8”-“企業企業應用集成（應用集成（EAI）”-“企業應用集成企業應用集成”；左樹左樹“系統菜單系統菜單”-“設置設置”- “系統注冊系統注冊”，為，為 U8的某的某個帳套注冊一個數據交換編碼，表明與外部系統的對應關系；個帳套注冊一個數據交