U8 EAI二次開發(fā)說明.doc

企業(yè)應用集成工具（EAI）二次開發(fā)1 概述U850企業(yè)應用集成工具（EAI）是U850與外部系統(tǒng)的數(shù)據(jù)接口，EAI提供了一些組件，可以在這些組件的基礎上進行二次開發(fā)（以下簡稱“EAI二次開發(fā)”），實現(xiàn)與外部系統(tǒng)的集成。不同系統(tǒng)集成的關鍵是遵循共同的數(shù)據(jù)標準，U850根據(jù)自己系統(tǒng)提出了一套數(shù)據(jù)標準，包括各種單據(jù)和基礎檔案，外部系統(tǒng)如果要和U850集成則必須遵循這一標準。這套標準用XML描述，因此數(shù)據(jù)流都為XML格式。EAI二次開發(fā)可分為兩種模式：注意：文中所有編程都以VB為例一、直接利用EAI管理工具。在開始菜單中選擇企業(yè)應用集成工具，登錄企業(yè)應用集成主界面。在這里可以將U850數(shù)據(jù)以標準XML文件的形式導出U850數(shù)據(jù)庫或將標準XML數(shù)據(jù)文件導入U850系統(tǒng)。二次開發(fā)程序員只需編寫一個工具將標準XML數(shù)據(jù)文件進行適當轉換寫入外部系統(tǒng)或取出外部系統(tǒng)數(shù)據(jù)寫成標準XML數(shù)據(jù)文件。（參看EAI安裝目錄xmlSamples下的例子）數(shù)據(jù)流程如下：EAI工具導出數(shù)據(jù)Xml文件數(shù)據(jù)寫入外部系統(tǒng)U850Xml文件從外部系統(tǒng)讀出數(shù)據(jù)EAI工具寫入數(shù)據(jù)外部系統(tǒng)EAI工具完成EAI二次開發(fā)的工作這種開發(fā)模式比較簡單，優(yōu)點是：充分利用EAI工具提供的功能，編程簡單；缺點是：只能提供批量導入導出功能。二、利用EAI提供的組件，進行靈活的二次開發(fā)。包括兩種方式：本地COM方式、Internet方式。1）本地COM方式：U850數(shù)據(jù)處理外部系統(tǒng)EAI組件調(diào)用接口二次開發(fā)出的軟件二次開發(fā)的工作這種方式可根據(jù)開發(fā)者的需要批量處理或者實時處理。接口調(diào)用非常簡單，簡化了編程。開發(fā)者只需將標準數(shù)據(jù)傳入接口，如下：Set Obj=CreateObject(U8Distribute.iDistribute)Str = obj. Process(sXml)sXml為標準數(shù)據(jù)串，具體格式后面會說明。2）Internet方式：U850外部系統(tǒng)IIS服務器二次開發(fā)模塊SOAP協(xié)議二次開發(fā)工作http.Open Post,http_name & “import.asp, True /指定服務器ASPhttp.send dom.xml /把xml數(shù)據(jù)發(fā)送到服務器端strRet= http.responseText /strRet :返回的xml格式的回執(zhí)信息2 數(shù)據(jù)格式標準EAI可以導入導出的數(shù)據(jù)范圍包括：總帳憑證銀行對賬單工資管理人員檔案 工資項目數(shù)據(jù)固定資產(chǎn)固定資產(chǎn)卡片成本管理材料消耗數(shù)據(jù)資金管理資金內(nèi)部結算單應收管理應收單收款單 應付管理應付單付款單 采購管理采購訂單采購到貨單采購發(fā)票銷售管理銷售訂單發(fā)貨單銷售發(fā)票銷售發(fā)票_導入到內(nèi)部結算單庫存管理入庫單出庫單庫存量基礎檔案部門檔案職員檔案地區(qū)分類客戶分類 客戶檔案供應商分類供應商檔案存貨分類存貨檔案結算方式付款條件開戶銀行倉庫檔案收發(fā)類別銷售類型計量單位計量單位組產(chǎn)品結構采購類型成套件費用項目發(fā)運方式貨位檔案自定義項檔案項目會計科目外幣 憑證類別常用摘要 提示：EAI安裝目錄xmlOperationdir.xml保存了相關定義下面一個例子是從U8導出的部門檔案的片斷： 1 0 綜合處 1 管理兼技術 109 1 廠辦公室 2 管理 EAI中所有的標準數(shù)據(jù)文件都有類似于上例的結構，首先，有一個名為ufinterface的元素，ufinterface再有若干個子元素組成，不同應用的子元素有不同的格式。注意：XML是對大小寫敏感的，在EAI標準中所有的元素名都為小寫字母。注意：EAI標準數(shù)據(jù)中的有些元素可以為空元素，有些則不得為空，根據(jù)具體業(yè)務不同而不同。但所規(guī)定的元素一個也不能多，一個也不能少。Ufinterface元素定義如下：roottag：類型；billtype：系統(tǒng)用；docid：唯一編號；receiver：接收方（系統(tǒng)用）；sender：注冊的外部系統(tǒng)號；proc：操作碼：Add,Edit,Delete,Querycodeexchanged：外部系統(tǒng)導入時是否轉換 ：y：需要經(jīng)過對照表；n：不需要經(jīng)過對照表exportneedexch：導出時是否需要轉換：y：需要經(jīng)過對照表；n：不需要經(jīng)過對照表display：單據(jù)中文名；family：單據(jù)中文大類名。所有的xml標準的頭文件格式都是一樣的，通過roottag區(qū)分單據(jù)類型，proc區(qū)分操作類型。 從U8導出的數(shù)據(jù)格式操作碼為Query，可加入導出條件。格式例子（以導出收款單為例）：元素department表示為部門檔案：屬性name：單據(jù)名稱；屬性importfile：保存的是導入文件路徑；屬性exportfile：保存的是導出文件路徑；屬性code：外部系統(tǒng)的注冊號。元素Field表示每個條件：屬性display：中文含義；屬性name：字段名；屬性operation：是比較運算符；屬性value：比較值；屬性logic：是連接的邏輯運算符。and：并且；or：或者。每次導出一種單據(jù)，這里為部門檔案，如果需要導出收款單則需要再一次導出。條件Field可以有多條。這個調(diào)用返回的XML回執(zhí)為U8的標準數(shù)據(jù)。注意：并不是導出數(shù)據(jù)會自動保存到Importfile exportfile指定的路徑，這兩個參數(shù)是EAI工具保存數(shù)據(jù)使用的。提示：EAI安裝目錄xmlOperationCondition.xml 保存了EAI的條件，可以通過EAI管理界面設定條件，變化保存在Condition.xml中。 導入數(shù)據(jù)到U8中時操作碼為Add可將數(shù)據(jù)填到Ufinterface元素中作為子元素。形式為：元素table_name代表一張單據(jù)，元素a1、a2等為單據(jù)中的元素。元素ufinterface則包含若干個table_name元素。注意：sender屬性值必須為EAI系統(tǒng)注冊過的注冊號一致，因為EAI系統(tǒng)根據(jù)這個注冊號與具體賬套相連接；Receiver為”U8”； docid取隨機數(shù)；family、roottag、display可以參考EAI安裝目錄xmlOperationdir.xml，總帳,基礎檔案等為family，它們的下級元素中文名為display，其屬性name 為roottag?？蓪ir.xml與數(shù)據(jù)文件例子參照，以便理解其的意義。 調(diào)用接口返回的XML回執(zhí)從U8導出數(shù)據(jù)成功的回執(zhí)就是數(shù)據(jù)。其它情況的回執(zhí)為：描述：key：為一條記錄的關鍵字；succeed：成功標識：0：成功；非0：失敗；dsc：失敗的描述；docid：消息號；proc：操作碼；u8key：成功后U8系統(tǒng)對應的關鍵字憑證的返回格式如下：描述：acc_period：會計期間,0為期初往來明細帳,21為期初待核銀行帳,20為銀行帳科目調(diào)整前余額,1-12為憑證及明細帳vouch_type：憑證類別字vouch_id：憑證號(由系統(tǒng)分配憑證號,期初時可為空)row_id：行號(由系統(tǒng)賦值,期初時為1)u8vouch_id：U8憑證號u8acc_period：U8憑證會計期間3 二次開發(fā)程序接口l COM接口調(diào)用(本地方式)EAI提供一個統(tǒng)一的標準接口，參數(shù)是定義好的標準xml格式，只要符合標準的格式，即可以很輕松的和EAI掛接。引用U8Distribute.Dll方法如下(VB)：Dim obj as ObjectDim Str as string /返回的Xml數(shù)據(jù)Set Obj=CreateObject(U8Distribute.iDistribute)Str=Obj.Login(sxml) /測試數(shù)據(jù)庫連接是否正常Str=obj. Process(sXml) /sXml為傳入的Xml數(shù)據(jù) sXml為String型。可以根據(jù)str的回執(zhí)進行相應的操作。所有的操作只需調(diào)用這個接口可以完成。注意：本地方式接口調(diào)用之前必須利用EAI工具提供的默認操作員界面設置U8服務器、用戶、密碼和登錄日期，以通過U8的權限認證。l Internet方式（SOAP協(xié)議）開發(fā)者可以用SOAP協(xié)議向裝有U850-EAI的IIS服務器發(fā)送XML數(shù)據(jù)，類似本地調(diào)用分析返回的XML回執(zhí)。Dim dom As New DOMDocumentDim http As New XMLHTTPDim strRet as stringdom.loadXML With dom.documentElement .setAttribute uid, 用戶名 .setAttribute pwd, 密碼 .setAttribute date, 登錄日期 .setAttribute sender, 注冊號End Withurl = 服務器名 + login.asphttp.Open post, url, Truehttp.send dom.xmlIf not Dom.load(“c:voucher.xml”) then msgbox “xml error” / c:voucher.xml是一個例子http.Open Post, http_name & “import.asp, True /指定服務器ASPhttp.send dom.xml /把xml數(shù)據(jù)發(fā)送大服務器端strRet= http.responseText /strRet :返回的xml格式的回執(zhí)信息4U850-EAI標準數(shù)據(jù)模版提示：EAI安裝目錄xmlTemplate下為所有EAI2.0標準模版文件。憑證 Voucher.xml對賬單 BankAccount.xml工資人員檔案 SalaryPerson.xml工資項目數(shù)據(jù) SalaryItem.xml固定資產(chǎn)卡片 CapitalAsserts.xml成本材料及外購半成品耗用表 material.xml資金內(nèi)部結算單 InternalBalance.xml應收應付單 OughtReceivePay.Xml收付款單 AcceptPay.xml采購訂單 PurchaseOrder.Xml采購到貨單 ArrivedGoods.xml采購發(fā)票 PurchaseInvoice.Xml銷售訂單 SaleOrder.Xml銷售發(fā)貨單 Consignment.Xml銷售發(fā)票 SaleInvoice.Xml庫存出入庫單 StoreInOut.Xml客戶檔案 Customer.xml客戶分類 Customerclass.xml供應商檔案 vendor供應商分類 vendercalss.xml存貨 inventory.xml 存貨分類 inventorycalss.xml部門 department.xml人員 person.xml科目目錄 code.xml憑證分類 dsign.xml幣種 currency.xml匯率 currencyrate.x