U8EAI企业应用集成培训

1、u8eai企业应用集成培训企业应用集成培训u8u8平台开发部平台开发部李静李静2008年年10月月2525日日 背景介绍背景介绍 u8eaiu8eai产品简介产品简介 u8eaiu8eai产品应用领域产品应用领域 u8eaiu8eai产品特性产品特性 u8eaiu8eai产品基本结构产品基本结构 u8eaiu8eai数据交换接口规范数据交换接口规范 u8eaiu8eai应用集成开发基本流程应用集成开发基本流程 最佳实践最佳实践 挑战挑战 当今全球化时代，企业面临着新的挑战：社会化大生产的分工越来越细，企业的生产方式由大而全的自主式生产转变为专业化协作生产。企业面临越来越激烈的外部竞争环境带来的

2、挑战以及内部管理和运营成本上升带来的压力。 应对策略应对策略企业迫切需要与供应商、合作伙伴、客户建立更紧密的协作关系，以共同应对风险和挑战，实现互惠共赢。 企业迫切需要能整合优化内部资源和业务流程，降低运营成本，提高运营效率和客户服务水平。 对对it系统的要求系统的要求打通 “信息孤岛”，实现企业内部各系统之间互连互通、信息共享融合和业务整合，以提高企业运营效率，降低成本。 背景介绍背景介绍 打通企业之间的“信息壁垒”，实现企业与供应商、伙伴、客户之间的信息交换和自动化业务协同，降低交易成本。 背景介绍背景介绍企业应用集成的关键问题企业应用集成的关键问题it系统的开放性和扩展能力系统的开放性和

3、扩展能力 为应对全球化带来的挑战，企业需要有效整合内外资源，这要求企业的it系统要具备足够的开放性和扩展能力，这种开放性和扩展能力首先体现在it系统要具备能与外部系统进行信息交流的丰富的对外接口。标准和规范的遵循标准和规范的遵循 企业it系统之间的集成除了相互的开放性以外，最重要的一点是要遵循一致的技术标准和规范，即必须说一种“语言”，才能进行有效“交谈”。当前比较流行的xml、soap/webservice、soa等技术，就是为了解决系统之间的数据通讯和信息交换问题而出现的业界公认标准。信息之间差异的弥合信息之间差异的弥合 企业应用集成最重要的行为是信息的交换，由于没有统一的商业标准，系统之

4、间的信息数据在结构上往往存在差异，甚至在对相同信息的描述上也可能存在语义上的差异，比如：对于同样的原材料a，在供应商系统中记录的编码是001，而在制造商系统中记录的编码是002。企业应用集成必须要解决这样的信息差异问题。 背景介绍背景介绍u8企业应用集成（企业应用集成（eai）产品是）产品是u8erp与第三方系统进行业与第三方系统进行业务数据交换的平台级工具产品，是务数据交换的平台级工具产品，是u8erp统一的对外开放接统一的对外开放接口。口。eai产品包括一整套产品包括一整套u8erp的标准业务数据交换接口，这些接的标准业务数据交换接口，这些接口涵盖基础档案、财务、供应链、生产制造、客户关系

5、管理、口涵盖基础档案、财务、供应链、生产制造、客户关系管理、hr等等erp业务模块，具备统一的入口、一致的业务外观和相业务模块，具备统一的入口、一致的业务外观和相对完整的业务功能，能完成对完整的业务功能，能完成u8基础数据、凭证、业务单据的基础数据、凭证、业务单据的导入导出及增、删、改等操作（少数不支持），是导入导出及增、删、改等操作（少数不支持），是u8与外部与外部系统进行应用集成和业务整合的基本资源。系统进行应用集成和业务整合的基本资源。 为解决数据交换中系统之间数据格式和数据语义差异问题，为解决数据交换中系统之间数据格式和数据语义差异问题，eai产品提供了可扩展的数据适配器和数据映射机制

6、用来进行产品提供了可扩展的数据适配器和数据映射机制用来进行内外数据的翻译和转换。内外数据的翻译和转换。为方便用户的应用和体验，为方便用户的应用和体验，eai产品还提供了能直接进行产品还提供了能直接进行u8数数据导入导出的基本用户界面工具，此工具支持手工和自动导入据导入导出的基本用户界面工具，此工具支持手工和自动导入导出。导出。 u8eai产品简介产品简介企业内部第三方业务系统与企业内部第三方业务系统与u8的整合的整合l财务整合：凭证上传典型案例：u8网络分销系统通过u8eai接口向u8财务系统上传结算凭证。l业务整合：单据协同典型案例：u8连锁零售系统通过u8eai接口与u8销售和库存系统进行

7、业务协同。包括：零售部门下载公司u8系统中的商品、客户档案、库存信息等；往u8系统上传每日结算的零售日报；库存不够了往u8发调拨申请单进行要货调拨等等业务。企业之间的企业之间的b2b业务协作业务协作l供应链协同：供应商远程接收订单。伙伴客户的采购系统通过供应商u8eai远程接口往供应商u8销售系统提交订单。u8eai在这两类应用领域中扮演的角色和职责主要是提供u8erp对外的基本集成接口资源。u8eai产品应用领域产品应用领域应用特性应用特性l内容完整内容完整涵盖了u8erp的大部分基本档案和业务单据（含凭证），是u8erp目前最完整、规范的对外接口。l功能丰富功能丰富支持手动、自动、远程和本

8、地接口等多种数据交换方式；支持数据映射、增量、过滤条件等多种数据交换规则。l接口统一接口统一对外提供了一个统一的服务代理接口，由此接口负责所有数据交换请求（调用）的分发处理，使外部系统对u8的接口依赖减小到最少，降低的系统耦合性。技术特性技术特性l采用采用xml作为数据交换格式作为数据交换格式xml提供了跨平台和低耦合特性，支持com、.net、java三种平台。l采用采用request/response作为数据交换模式作为数据交换模式数据交换的交互模式采用request/response方式，并通过标准的request和response消息来承载交互数据信息。l支持本地和支持本地和http远

9、程调用远程调用本地调用采用com方式；远程调用采用xmlhttp post的方式。u8eai产品特性产品特性u8erp数据交换业务接口数据交换业务接口: u8erp各业务模块提供的数据交换接口。eai数据交换框架数据交换框架: 为管理和调用数据交换业务接口而提供的统一的基础框架，包括数据交换业务基本配置信息以及数据交换服务代理接口和适配器。其中数据交换服务代理接口数据交换服务代理接口负责处理数据交换请求；适配器适配器负责对不同格式和结构的数据信息进行适配转换；数据交换目录数据交换目录集中注册和管理u8产品的所有数据交换业务接口；数据交换元数据数据交换元数据描述了数据接口格式和数据类型定义 ；数

10、据映射规则；数据映射规则描述了数据适配过程中的内外数据的对照映射关系；eai日志日志用来对数据交换过程进行跟踪和记录。eai数据交换管理器数据交换管理器: 用来配置和管理数据交换业务。主要包括以数据交换解决方案为中心的各种数据交换要素的配置管理 。其中，解决方案管理解决方案管理主要对各种数据交换配置按照数据交换应用任务为单位进行分类集中管理；外部系统管理外部系统管理用来建立外部系统与u8帐套的集成关系；数据映射管理数据映射管理用来配置外部系统数据与u8数据的对照映射规则，以便在数据交换时进行数据适配和转换（解决数据信息差异问题）；适配器管理适配器管理用来管理系统预置和自定义数据适配器、定义适配

11、规则；eai日志管理日志管理用来查询和处理eai日志。eai导入导出工具：导入导出工具：为方便用户的应用和体验， eai提供了面向最终用户的导入导出工具。能直接进行u8数据导入导出，支持多种格式，支持条件过滤和增量，支持手工和定时自动导入导出。 u8eai产品基本结构产品基本结构u8eai产品结构产品结构eai导入导出工具导入导出工具手动导入导出工具nxml导入导出nexcel导入导出n其他格式导入导出导入导出设置条件过滤规则增量规则导入导出目标地址定时计划导入导出任务计划规划设计器任务计划执行引擎u8erp数据交换业务接口数据交换业务接口基本档案接口财务接口供应链接口生产制造接口其它接口ea

12、i数据交换框架数据交换框架eai数据交换代理服务-eai broker（支持多种协议）eai数据交换目录eai数据交换元数据数据映射规则eai日志适配器框架专用适配器nexcelnedi通用适配器（xml）格式和数据适配规则eai数据交换管理器数据交换管理器外部系统管理数据映射管理适配器管理eai日志管理解决方案管理u8eai数据交换接口规范数据交换接口规范eai接口定义接口定义l本地本地com接口接口类库：u8distribute.dllprogid：u8distribute.idistribute方法：string process(string requestxml)参数： request

13、xml数据交换请求消息，详见数据交换格式定义。 返回值数据交换response消息，详见数据交换格式定义。l远程远程http接口接口eai远程数据交换采用xmlhttp post的方式。接口为：post上传：数据交换请求消息与本地调用一样，详见数据交换格式定义。 response接收：数据交换响应消息与本地调用一样，详见数据交换格式定义。eai数据交换格式数据交换格式 l数据交换消息总体格式数据交换消息总体格式eai数据交换消息格式分为框架和内容两部分： 框架部分 内容部分 框架部分框架部分包含数据交换的控制信息，其中：u8eai数据交换接口规范数据交换接口规范sender: 发送方，填外部系

14、统注册码receiver: 接收方，填u8即可roottag：数据类型，根据eaixmltemplate目录中的数据交换模板文件填写proc：数据交换的操作，分为add/edit/delete/query内容部分内容部分指消息中携带的档案或单据等业务数据。u8eai提供了一整套完整的基本档案和单据的数据交换模版（在eaixmltemplate目录下），模板中定义了消息内容部分的格式和字段。lrequset消息格式消息格式request消息格式的框架部分同上所述，内容部分根据不同的操作有所不同：对于add/edit操作，request消息的内容就是档案和单据内容，具体格式详见数据模板。对于del

15、ete/query操作， request消息的内容包含过滤条件，条件格式如下： u8eai数据交换接口规范数据交换接口规范lresponse消息格式消息格式response消息是eai接口执行request消息之后的返回结果，不同的操作有所不同：对于query操作， 返回的结果就是查询的数据，格式详见eai数据模板。对于add/edit/delete操作，返回的结果包括单据体每一行数据的详细执行结果(由item节点描述)，如下： 凭证的add操作的response格式比较特殊： voucher_id： 外部系统原始凭证号； u8voucher_id： u8生成的凭证号； succeed： 是否

16、成功，0为成功，非零为失败； accounting_period： 会计期间； voucher_type： 凭证类别第一步：第一步：eai基本配置基本配置第二步：规划并准备数据第二步：规划并准备数据第三步：根据部署方式选择第三步：根据部署方式选择eai接口类型接口类型第四步：调用第四步：调用eai接口，发送数据接口，发送数据第五步：处理返回结果第五步：处理返回结果u8eai应用集成开发流程应用集成开发流程第一步：第一步：eai基本配置基本配置1、配置、配置eai连接连接“开始”- “程序”-“用友erp-u872”-“企业应用集成(eai)”-“u8eai接口设置”u8eai应用集成开发流程应

17、用集成开发流程2、外部系统注册、外部系统注册切换到外部系统注册页签进行外部系统注册。外部系统注册的目的是为了建立外部系统与u8帐套的数据交换关系。u8eai应用集成开发流程应用集成开发流程第二步：规划并准备数据第二步：规划并准备数据1、根据项目的需求，分析应用集成业务场景，确定需要与、根据项目的需求，分析应用集成业务场景，确定需要与u8进行数据交换的业务环节。进行数据交换的业务环节。2、对于项目中每一个数据交换环节，确定数据来源，并进、对于项目中每一个数据交换环节，确定数据来源，并进行数据适配，将原始数据转换为符合行数据适配，将原始数据转换为符合u8eai标准数据标准数据交换格式的数据（对于交

18、换格式的数据（对于add/edit的数据必须符合的数据必须符合u8eai的数据模板格式）。的数据模板格式）。3、对于数据交换过程中需要进行基本档案编码转换的（比、对于数据交换过程中需要进行基本档案编码转换的（比如：订单中存货的编码外部系统与如：订单中存货的编码外部系统与u8可能不一致），可能不一致），可以在可以在eai的数据交换配置管理中配置档案编码的映射的数据交换配置管理中配置档案编码的映射关系。当然，也可以不使用关系。当然，也可以不使用eai的数据映射功能，直接的数据映射功能，直接在外部数据转换为在外部数据转换为u8eai标准格式的代码中处理。标准格式的代码中处理。u8eai应用集成开发流

19、程应用集成开发流程第三步：根据部署方式选择第三步：根据部署方式选择eai接口类型接口类型对于需要与对于需要与u8服务器分离部署的应用集成项目，应该服务器分离部署的应用集成项目，应该选择选择eai的的http远程接口。远程接口。对于可以和对于可以和u8服务器部署在一起的项目，则应选择调服务器部署在一起的项目，则应选择调用用eai本地本地com接口。接口。u8eai应用集成开发流程应用集成开发流程第四步：调用第四步：调用eai接口，发送数据接口，发送数据本地本地com调用调用 vb代码：代码： dim eaibroker as object set eaibroker = createobject

20、(“u8distribute.idistribute”) 创建eai服务代理接口对象 dim responsexml as string responsexml = eaibroker.process(requestxml) 调用eai服务代理的数据交换方法process，传入request交 换消息， 并获取eai返回的response消息。 . 处理返回结果 set eaibroker =nothing 释放eai服务代理接口对象 .net代码：代码： 引用u8softeaiu8distribute.dll u8distribute.idistributeclass eaibroker =

21、 new u8distribute.idistributeclass(); /创建eai服务代理接口对象 string responsexml = eaibroker.process(requestxml); /调用eai服务代理的数据交换方法process，传入request交换消息， 并获取eai返回的response消息。 . /处理返回结果 system.runtime.interopservices.marshal.finalreleasecomobject(eaibroker); /释放eai服务代理接口对象u8eai应用集成开发流程应用集成开发流程 java代码：代码： 采用jn

22、i、jcom、jacob技术调用eai服务代理com组件,下面以jacob为例： import .dispatch; import .variant; class test public static void main(string args) dispatch eaibroker = new dispatch(u8distribute.idistribute); /创建eai服务代理接口对象 string responsexml = dispatch.call(eaibroker, process, new variant(requestxml); /调用eai服务代理的数据交换方法pro

23、cess，传入request交换消息， 并获取eai返回的response消息。 . /处理返回结果 u8eai应用集成开发流程应用集成开发流程http远程调用远程调用 远程调用采用http post的方式上传request消息。 vb代码：代码： dim xmlhttp as object set xmlhttp = createobject(“msxml2.xmlhttp”) 创建xmlhttp对象 call xmlhttp.open(“post”, “http:/u8appsrv/u8eai/import.asp”, false) 使用xmlhttp对象打开网络连接，url中的u8app

24、srv填u8应用服务器 xmlhttp.send requestxml 发送request消息 dim responsexml as string responsexml = xmlhttp.responsetext 获取返回response消息 . 处理返回结果.net代码：代码： 引用d:u8softinteropinterop.msxml2.dll msxml2.xmlhttpclass xmlhttp = new msxml2.xmlhttpclass(); xmlhttp.open(post, http:/localhost/u8eai/import.asp, false, null

25、, null); xmlhttp.send(dom.outerxml); string responsexml = xmlhttp.responsetext; /处理返回结果 system.runtime.interopservices.marshal.finalreleasecomobject(xmlhttp); /com释放u8eai应用集成开发流程应用集成开发流程 java代码：代码： class test public static void main(string args) url url = new url(http:/localhost/u8eai/import.asp); h

26、ttpurlconnection con = (httpurlconnection)url.openconnection(); con.setconnecttimeout(3000000); con.setreadtimeout(3000000); con.setdoinput(true); con.setdooutput(true); con.setallowuserinteraction(false); con.setusecaches(false); con.setrequestmethod(post); con.setrequestproperty(content-type,appli

27、cation/x-www-form-urlencoded); /发送request消息 outputstream out = con.getoutputstream(); dataoutputstream dos = new dataoutputstream(this.out); dos.write(requestxml.getbytes(utf-8);/获取response消息inputstream in = con.getinputstream();bufferedreader br = new bufferedreader(new inputstreamreader(in);string

28、builder sb = new stringbuilder();string s = null;while (s = br.readline() != null) sb.append(s);string responsexml = sb.tostring(); u8eai应用集成开发流程应用集成开发流程第五步：处理返回结果第五步：处理返回结果分析返回结果，处理返回结果就是处理分析返回结果，处理返回结果就是处理response消息，消息， response消息格式在消息格式在“eai数据交换接口规范数据交换接口规范”中已经中已经详详 细介绍了。细介绍了。u8eai应用集成开发流程应用集成开发流

29、程最佳实践最佳实践 活用活用eaieai接口接口 关于二次开发中关于二次开发中u8u8接口选择接口选择 u8u8与外部系统集成最佳开发模式与外部系统集成最佳开发模式活用活用eai接口接口eai通用通用sql查询接口查询接口 由于eai接口返回的数据格式是固定的标准格式，很有可能返回的数据中没有用户所需要的字段；另外，对于u8中的业务数据，eai接口也不是100%覆盖的。 针对以上情况，eai提供了一个灵活的数据查询通用接口-eai通用sql查询接口，该接口支持向eai数据交换代理传递sql语句进行查询操作，可以查询当前u8帐套的所有数据，用户不用直接访问u8帐套库。查询返回的结果为.net中的

30、dataset的xml格式的数据。调用该接口只需给eai数据交换服务代理传递特殊的request消息即可： request消息格式如下： 其中内容部分 节点为sql查询语句。框架部分的roottag值必须固定为“sqlexe” ， proc的值用来标识dataset的行节点，可以是任意字符串。 活用活用eai接口接口response消息格式如下： 1true采购1部2true销售1部根节点的proc的值用来标识dataset的行节点，一般为表名。活用活用eai接口接口使用条件过滤使用条件过滤查询单条数据的时候往往需要带上条件，可以采用eai通用sql查询，也可以采用eai标准的条件查询格式：

31、注意控制部分的roottag要与内容根节点呼应。活用活用eai接口接口关于内外格式适配问题关于内外格式适配问题外部系统通过eai与u8进行数据交换，首先必须解决数据格式匹配问题，必须将外部系统数据格式变换为u8eai标准数据格式，eai当前的版本还没有实现完善的适配器机制，故目前常见的做法是直接在项目工程的二次开发代码中做转换，这种方式虽然很高效，但是不灵活，不能适应规则或需求变化（一旦有变化，则需要调整代码重新编译），推荐一个比较好的做法是将数据格式转换功能做成一个通用服务，采用xslt作为转换引擎，xslt脚本作为转换规则，这样，应对任何格式甚至业务规则的变化只需要调整xslt脚本即可。

32、关于客户化开发中关于客户化开发中u8接口选择接口选择要在客户化开发代码中调用要在客户化开发代码中调用u8的某项功能，目前有三种选择：的某项功能，目前有三种选择： 直接访问u8数据库：优点是最直接，能够完全自我控制；缺点是最危险，需要对产品的实现机理和数据库表结构都非常了解。 使用u8开发部提供的内部接口：优点是可以复用现有接口，不需要重复劳动，而且内部使用的接口一般都比较灵活；缺点是太灵活，不易用，粒度太细，依赖和耦合度太强，需要很多上下文条件，需要总部强有力的技术支持！ 使用u8对外公布的产品化的标准接口u8eai与u8api（872新增加）：优点是经过严格测试，编程模型统一，业务粒度适中，功能相对独立完整，耦合度和依赖都不强。缺点是标准化后导致不灵活，另外功能覆盖度不是很全面（持续完善中！）。u8eai与与u8api接口接口 u8eai与u8api接口看起来比较类似，但它们的特性有差别。 u8api采用传统的编程模式，更靠近底层，业务逻辑粒度更细，而且还需要或依赖一些特定的上下文环境，比如：login、事务等；而u8eai接口则是完全松耦合的，采用xml和请求/响应的消息模式，支持跨平台和远程访问，且