U8 EAI二次开发说明

1、企业应用集成工具（EAI）二次开发1概述U850企业应用集成工具（EAI）是U850与外部系统的数据接口，EAI提供了一些组件，可以在这些组件的基础上进行二次开发（以下简称“EAI二次开发”），实现与外部系统的集成。不同系统集成的关键是遵循共同的数据标准，U850根据自己系统提出了一套数据标准，包括各种单据和基础档案，外部系统如果要和U850集成则必须遵循这一标准。这套标准用XML描述，因此数据流都为XML格式。EAI二次开发可分为两种模式：注意：文中所有编程都以VB为例一、直接利用EAI管理工具。在开始菜单中选择企业应用集成工具，登录企业应用集成主界面。在这里可以将U850数据以标准XML文

2、件的形式导出U850数据库或将标准XML数据文件导入U850系统。二次开发程序员只需编写一个工具将标准XML数据文件进行适当转换写入外部系统或取出外部系统数据写成标准XML数据文件。（参看EAI安装目录xmlSamples下的例子）数据流程如下：这种开发模式比较简单，优点是：充分利用EAI工具提供的功能，编程简单；缺点是：只能提供批量导入导出功能。二、利用EAI提供的组件，进行灵活的二次开发。包括两种方式：本地COM方式、Internet方式。1）本地COM方式：U850外部系统二次开发的工作二次开发出的软件这种方式可根据开发者的需要批量处理或者实时处理。接口调用非常简单，简化了编程。开发者只

3、需将标准数据传入接口，如下SetObj=CreateObject(U8Distribute.iDistribute)Str=obj.Process(sXml)sXml为标准数据串，具体格式后面会说明。 HYPERLINK http:/http.Open http.OpenPost,http_name&“import.asp,Tru/e指定服务器ASP HYPERLINK http:/http.send http.senddom.xml把xml数据发送到服务器端strRet= HYPERLINK http:/http.responseText http.responseText/strRet:返

4、回的xml格式的回执信息2数据格式标准EAI可以导入导出的数据范围包括:0总帐凭证银行对账单0工资管理人员档案工资项目数据0固定资产固定资产卡片0成本管理材料消耗数据0资金管理资金内部结算单0应收管理应收单收款单0应付管理应付单付款单0采购管理采购订单采购到货单采购发票0销售管理销售订单发货单销售发票销售发票_导入到内部结算单0库存管理入库单出库单库存量0基础档案部门档案职员档案地区分类客户分类客户档案供应商分类供应商档案存货分类存货档案结算方式付款条件开户银行仓库档案收发类别销售类型计量单位计量单位组产品结构采购类型成套件费用项目发运方式货位档案自定义项档案项目会计科目外币凭证类别常用摘要提

5、示：EAI安装目录xmlOperationdir.xml保存了相关定义下面一个例子是从U8导出的部门档案的片断：10综合处/name1管理兼技术/prop1091厂办公室/name2管理EAI中所有的标准数据文件都有类似于上例的结构，首先，有一个名为ufinterface的元素，ufinterface再有若干个子元素组成，不同应用的子元素有不同的格式。注意：XML是对大小写敏感的，在EAI标准中所有的元素名都为小写字母。注意：EAI标准数据中的有些元素可以为空元素，有些则不得为空，根据具体业务不同而不同。但所规定的元素一个也不能多，一个也不能少。Ufinterface元素定义如下：rootta

6、g:类型；billtype:系统用；docid:唯一编号；receiver:接收方（系统用）；sender:注册的外部系统号；proc：操作码：Add,Edit,Delete,Querycodeexchanged:外部系统导入时是否转换：y：需要经过对照表；n：不需要经过对照表exportneedexch:导出时是否需要转换：y：需要经过对照表；n：不需要经过对照表display:单据中文名；family：单据中文大类名。所有的xml标准的头文件格式都是一样的，通过roottag区分单据类型，proc区分操作类型。从U8导出的数据格式操作码为Query，可加入导出条件。格式例子（以导出收款单为

7、例）：元素department表示为部门档案：属性name:单据名称；属性importfile:保存的是导入文件路径；属性exportfile:保存的是导出文件路径；属性code:外部系统的注册号。元素Field表示每个条件：属性display:中文含义；属性name:字段名；属性operation:是比较运算符；属性value：比较值；属性logic:是连接的逻辑运算符。and：并且；or：或者。每次导出一种单据，这里为部门档案，如果需要导出收款单则需要再一次导出。条件Field可以有多条。这个调用返回的XML回执为U8的标准数据。注意：并不是导出数据会自动保存到Importfileexpo

8、rtfile指定的路径，这两个参数是EAI工具保存数据使用的。提示：EAI安装目MxmlOperationCondition.xml保存了EAI的条件，可以通过EAI管理界面设定条件，变化保存在Condition.xml中。导入数据到U8中时操作码为Add可将数据填到Ufinterface元素中作为子元素。形式为:元素table_name代表一张单据，元素al、a2等为单据中的元素。元素ufinterface则包含若干个table_name元素。注意：sender属性值必须为EAI系统注册过的注册号一致，因为EAI系统根据这个注册号与具体账套相连接；Receiver为U8”docid取随机数；

9、family、roottag、display可以参考EAI安装目录xmlOperationdir.xml，总帐，基础档案等为family，它们的下级元素中文名为display,其属性name为roottag。可将dir.xml与数据文件例子参照，以便理解其的意义。调用接口返回的XML回执从U8导出数据成功的回执就是数据。其它情况的回执为：描述：key：为一条记录的关键字；succeed：成功标识：0：成功；非0：失败；dsc：失败的描述；docid:消息号;proc：操作码；u8key：成功后U8系统对应的关键字凭证的返回格式如下：描述：acc_period:会计期间,0为期初往来明细帐,21

10、为期初待核银行帐,20为银行帐科目调整前余额,1-12为凭证及明细帐vouch_type:凭证类别字vouch_id：凭证号（由系统分配凭证号，期初时可为空）row_id：行号（由系统赋值，期初时为1）u8vouch_id：U8凭证号u8acc_period：U8凭证会计期间3二次开发程序接口COM接口调用（本地方式）EAI提供一个统一的标准接口，参数是定义好的标准xml格式，只要符合标准的格式，即可以很轻松的和EAI挂接。引用U8Distribute.Dll方法如下(VB)：DimobjasObjectDimStrasstring/返回的Xml数据SetObj=CreateObject(U8

11、Distribute.iDistribute)Str=obj.Process(sXml)/sXml为传入的Xml数据sXml为String型。可以根据str的回执进行相应的操作。所有的操作只需调用这个接口可以完成。注意：本地方式接口调用之前必须利用EAI工具提供的默认操作员界面设置U8服务器、用户、密码和登录日期，以通过U8的权限认证。Internet方式(SOAP协议)开发者可以用SOAP协议向装有U850-EAI的IIS服务器发送XML数据，类似本地调用分析返回的XML回执。DimdomAsNewDOMDocumentDimhttpAsNewXMLHTTPDimstrRetasstring

12、IfnotDom.load(“c:voucher.xml”)thenmsgbox“xmlerror”/c:voucher.xml是一个例子 HYPERLINK http:/http.Open http.OpenPost,http_name&“import.asp,True/指定服务器ASP HYPERLINK http:/http.send http.senddom.xml把xml数据发送大服务器端strRet= HYPERLINK http:/http.responseText http.responseText/strRet:返回的xml格式的回执信息4.U850-EAI标准数据模版提示：

13、EAI安装目录xmlTemplate下为所有EAI2.0标准模版文件。凭证Voucher.xml对账单BankAccount.xml工资人员档案SalaryPerson.xml工资项目数据SalaryItem.xml固定资产卡片CapitalAsserts.xml成本材料及外购半成品耗用表material.xml资金内部结算单InternalBalance.xml应收应付单OughtReceivePay.Xml收付款单AcceptPay.xml采购订单PurchaseOrder.Xml采购到货单ArrivedGoods.xml采购发票PurchaseInvoice.Xml销售订单SaleOrder.Xml销售发货单Consignment.Xml销售发票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.xml结算