U8EAI简介和开发手册.doc

6. EAI开发 6.1. 概述6.1.1. EAI产品简介U8企业应用集成（EAI）产品是U8ERP与第三方系统进行业务数据交换的平台级工具产品，是U8ERP统一的对外开放接口。EAI产品包括一整套U8ERP的标准业务数据交换接口，这些接口涵盖基础档案、财务、供应链、生产制造、客户关系管理、HR等ERP业务模块，具备统一的入口、一致的业务外观和相对完整的业务功能，能完成U8基础数据、凭证、业务单据的导入导出及增、删、改等操作（少数不支持），是U8与外部系统进行应用集成和业务整合的基本资源。在技术上，EAI数据交换接口采用符合业界标准的XML作为数据交换接口规范（协议）描述，充分利用了XML跨平台和低耦合的特性。基于XML的交换协议描述了数据交换过程中Request/Response消息数据格式及元数据规范（Schema），外部系统只要遵循此标准和规范即可以方便的与U8ERP进行Talking。6.1.2. EAI产品结构U8EAI产品结构Web Interface（ASP）EAI工具手动导入导出工具数据映射规则定义、过滤条件规则定义、任务计划配置自动任务计划执行引擎EAI数据交换框架EAI Broker （U8Distribute ）- EAI分发调用代理服务规则数据映射条件过滤增量适配器XML适配EDI适配平面文件适配EAI档案单据元数据EAI业务接口注册表U8ERP数据交换业务接口基本档案接口总帐凭证接口供应链接口生产制造接口U8企业应用集成（EAI）产品结构自下而上分为三层：数据交换基本资源层、EAI数据交换框架层、EAI工具层。. 数据交换基本资源层即U8ERP基础数据交换接口层，这一层包含U8ERP各业务模块所提供的以业务数据实体（档案、单据、凭证等）导入导出为核心任务的基础业务接口，涵盖了U8ERP的核心业务功能点。这些业务接口通过EAI数据交换框架层对外开放并公布，为外部系统访问U8提供了最基础的功能支持。这些原始业务接口属于U8内部功能，只能通过EAI数据交换接口统一访问，外界不能直接使用。. EAI数据交换框架层EAI数据交换框架层统一封装了底层的U8ERP的数据交换业务接口；对外公布了U8的所有数据交换服务；为外部系统访问U8提供了统一的访问途径和一致的调用入口（Broker /Proxy）。其中，通过一套标准的档案和单据元数据模板（Schema），提供了U8的业务数据接口外观，描述了数据交换的应用协议（交换格式、上下文），为外部系统访问U8提供了详细完整的接口规范。另外，通过EAI业务接口注册表，对外提供可用的U8ERP数据交换服务目录，为数据交换服务的查找、发现提供集中统一的资源库，为U8内部的数据交换基础服务的开发、部署、发布、注销提供全生命期管理机制。EAI数据交换框架层还包括为解决系统之间数据格式差异而提供的各种数据格式适配器（XML适配器、EDI适配器、平面文件适配器等）；以及为系统之间业务数据翻译转换提供的数据映射规则（比如：基本档案的编码映射）；为剪裁和适配导出数据提供的条件约束规则等机制。EAI数据交换框架还提供了运行时统一服务访问接口- EAIBroker（U8Distribute组件），该接口为外部系统访问U8提供了统一的入口和一致接口外观（Facade）。该接口提供本地调用和远程（Internet）调用两种方式，是使用EAI进行系统集成开发的核心接口。. EAI工具层EAI工具层包括一组EAI配置工具和一套基于EAI数据交换框架的缺省的客户端导入导出工具。EAI配置工具主要包括U8账套连接（登录）配置、外部系统与U8账套对应关系配置，以及各种规则定义（数据映射规则定义、过滤条件规则定义），定时自动任务执行引擎的任务计划配置等。EAI导入导出工具是基于EAI数据交换框架开发的，提供给最终用户使用的轻量级工具，具备简单易用的特点。它同时也作为基于EAI数据交换框架进行二次开发的一个典型范例。此工具分为手动导入导出和自动定时任务导入导出两种，其中自动定时任务需要使用配置工具进行任务计划设定。6.2. EAI二次开发模式6.2.1 直接使用EAI导入导出工具在开始菜单中选择 用友ERP-U8企业应用集成(EAI)企业应用集成，登录企业应用集成主界面。在这里可以将U8数据以标准XML文件的形式导出或将标准XML数据文件导入U8系统。二次开发程序员只需编写一个工具将标准XML数据文件进行适当转换写入外部系统或取出外部系统数据写成标准XML数据文件。（参考EAI安装目录xmlSamples下的例子）U8数据处理外部系统EAI组件调用接口二次开发出的软件二次开发的工作数据流程如下：这种开发模式比较简单，优点是：充分利用EAI工具提供的功能，编程简单；缺点是：只能提供批量导入导出功能。6.2.2 调用EAI数据交换框架接口包括两种方式：本地COM方式、Internet方式。这两种方式在使用之前都需要检查有没有进行EAI接口配置（开始-程序-U8ERP-企业应用集成-EAI接口配置），如果没有则需要进行配置。一般配置好后就不要动了，除非出现服务器迁移或重新安装的情况。EAI接口配置包括两项内容：EAI基本设置、外部系统注册。l EAI接口基本设置需要指定U8服务器、EAI登录身份验证、EAI数据源。如果进行数据交换的数据包比较大，则需要点“自动设置IIS”更改IIS的大数据限制。l 外部系统注册在数据交换中，需要明确指定外部系统与U8的某个业务账套的对应关系，该对应关系由一个唯一的注册码标识。可以注册多个外部系统注册码。数据交换时需要在请求消息的头指定一个注册码： 本地COM方式处理流程如下：U8数据处理外部系统EAI组件调用接口二次开发出的软件二次开发的工作这种方式可根据开发者的需要批量处理或者实时处理。接口调用非常简单，简化了编程。开发者只需将标准数据传入接口，如下：Dim obj as ObjectDim strRet as string Set Obj=CreateObject(U8Distribute.iDistribute)strRet =obj. Process(sXml) 可以根据回执内容strRet对操作结果进行相应的处理。传入参数sXml和返回结果strRet为标准XML数据串，具体格式后面会说明。 Internet方式U8外部系统IIS服务器二次开发模块SOAP协议二次开发工作开发者可以用SOAP协议向装有U8-EAI的IIS服务器发送XML数据，类似本地调用分析返回的XML回执，如下：Dim http As New XMLHTTPDim sHttpServer As StringDim strRet as stringsHttpServer = http:/ + sHttpServer + /U8EAI/import.asp /指定服务器http.Open Post, sHttpServer, True /True为异步，Fasle为同步http.send sXml /发送数据Do While http.readyState 4 DoEventsLoopIf http.Status = 200 Then strRet = http.responseText /返回结果Else /处理出错信息 End If6.3. 导入导出数据格式标准6.3.1. 档案单据模板格式单据模板指的U8中各个基础档案和业务档案用XML存储时的格式。目前放在U8SoftEAIXMLTemplate中。模板的下部注释中有模板中各个节点的相应说明，主要是供二次开发人员和客户了解U8单据格式使用。 在U8SOFTEAIXMLSamples有各个模板的例子供参考。单据模版总体架构roottag: 单据模版名，如:客商档案:customer 客商分类:customerclass 具体名称由总体确定，在数据交换中该名称要经常使用billtype: 系统用 可填空docid:唯一编号 可空receiver:接收方 可填U8 sender:发送方编码 即注册的外部编码 (必填)注意：如果使用EAI工具，通过界面操作导入，则可空。通过EAI工具导入时，以选择的注册码为准，不以单据中的注册码为准。proc:操作码 添加:Add 编辑:edit 删除:delete 参照:Query 该字段必填数据交换时，会根据操作码判断是导入操作还是导出操作（操作码为query）通过EAI工具导入时，操作可选。如果是二次开发通过调用EAI提供的服务进行数据交换，则必须填写该字段，导入操作，请填写Add /Edit/Delete，导出操作，请填写Querycodeexchanged:编码是否已转换 如果已转换即已和U8基础数据编码一致填Y,将不会通过对照表的转换如果没有转换即和U8基础数据编码不一致 填N,将会自动通过对照表转换之后,进行相应的操作.对于基础档案信息，如果添加成功，则系统自动将该信息加入到对照表（即内外部编码是一致的）导入的时候使用。exportneedexch: 导出是否需要根据对照表进行转换,需要填”Y”,不需要填”N”导出的时候使用timestamp: 时间戳标志，在导出数据时，导出此时间戳的所有以后的数据，若为空，则导出只有过滤条件的数据6.3.2. 传入XML数据格式 数据导入数据的导入，传入的参数为根据XML模板制作的XML数据。比如，要导入部门档案，传入的sXml如下：00基建中心10011基建投资部2.导入时，单据头中的proc必须为Add/Edit/Delete之一，并不是所有单据都支持这三种操作，具体可参考本章第四节。凭证的导入，具体请参考本章第五节。XML是对大小写敏感的，在EAI标准中所有的元素名都为小写字母注意：EAI标准数据中的有些元素可以为空元素，有些则不得为空，根据具体业务不同而不同。但所规定的元素一个也不能多，一个也不能少 数据导出操作码为Query，可加入导出条件。格式例子（以导出部门档案为例）： 元素department表示为部门档案：属性importfile：保存的是导入文件路径属性exportfile：保存的是导出文件路径属性code：外部系统的注册号元素Field表示每个条件：属性display：中文含义属性name：字段名属性operation：是比较运算符属性value：比较值属性logic：是连接的逻辑运算符。and：并且；or：或者每次导出一种单据，这里为部门档案，如果需要导出收款单则需要再一次导出。条件Field可以有多条。这个调用返回的XML回执为U8的标准数据。注意：并不是导出数据会自动保存到Importfile exportfile指定的路径，这两个参数是EAI工具保存数据使用的。6.3.3. 回执XML数据格式从U8导出数据成功的回执就是数据。其它情况的回执：描述：key：为一条记录的关键字；succeed：成功标识：0：成功；非0：失败；dsc：失败的描述；docid：消息号；proc：操作码；u8key：成功后U8系统对应的关键字凭证的返回格式如下：描述：acc_period：会计期间,0为期初往来明细帐,21为期初待核银行帐,20为银行帐科目调整前余额,1-12为凭证及明细帐vouch_type：凭证类别字vouch_id：凭证号(由系统分配凭证号,期初时可为空)row_id：行号(由系统赋值,期初时为1)u8vouch_id：U8凭证号u8acc_period：U8凭证会计期间succeed：成功标识：0：成功；非0：失败；6.4. 支持数据交换的基础档案和业务单据1. 模块2. 类型3. 外部数据导入U84. U8数据导出5. 增加6. 修改7. 删除8. 总账9. 凭证10. Y11. Y12.13. Y14. 银行对账单15. Y（仅导入期初对账单）9. 期初余额20. Y21. Y22.23. Y24. 结算中心25. 内部结算单26. Y27.28.29. Y30. 应收款管理31. 应收单32. Y（不可导入期初单据）33.34. Y35. Y36. 收款单37. Y（不可导入期初单据）38.39. Y40. Y41. 销售发票（不启用销售管理）42. Y（不可导入期初单据）43.44.45. Y46. 应付款管理47. 应付单48. Y（不可导入期初单据）49.50. Y51. Y52. 付款单53. Y（不可导入期初单据）54.55. Y56. Y57. 采购发票（不启用采购管理）58. Y（不可导入期初单据）2. 成本管理63. 材料消耗数据64. Y65.66.67. Y68. 薪资管理69. 工资人员档案70. Y71.72.73. Y74. 工资项目数据75. Y76.77.78. Y79. 固定资产80. 固定资产卡片81. Y82.83. Y84. Y85. 固定资产变动单86. Y87.88.89. Y90. 采购管理91. 采购订单92. Y93.94.95. Y96. 采购到货单97. Y98.99.100. Y101. 采购发票102. Y103.104.105. Y106. 代管挂账确认单107. Y108.109.110. Y111. 供应商存货价格112. Y113.114.115. Y116. 销售管理117. 销售订单118. Y119.120.121. Y122. 销售发货单123. Y124.125.126. Y127. 销售发票128. Y129.130.131. Y132. 销售发票_导入到内部结算单133. Y37. 直营门店零售日报138. Y42. 客户调价单143. Y144.145.146. Y147. 存货调价单148. Y149.150.151. Y152. 库存管理153. 入库单154. Y155.156.157. Y158. 出库单159. Y160.161.162. Y163. 调拨申请单164. Y165.166.167. Y168. 调拨单169. Y170.171.172. Y173. 库存量174. Y175.176.177. Y178. 库存期初179. Y180.181.182. Y183. 期初不合格品184. Y185.186.187. Y188. 项目管理189. 项目要素分类93. Y194. 项目要素98. Y199. 项目成本03. Y204. 项目预算表205. Y206.207.208. Y209. 预算项目信息表210. Y211.212.213. Y214. 项目周期预算表215. Y216.217.218. Y219. 项目预算周期权数表220. Y221.222.223. Y224. 项目周期预算子表225. Y226.227.228. Y229. 项目预算子表230. Y231.232.233. Y234. 预算项目周期表235. Y236.237.238. Y239. 预算版本信息表240. Y241.242.243. Y244. 生产制造245. 时栅资料246. Y247.248.249. Y250. 时格资料251. Y252.253.254. Y255. 工作中心256. Y257.258.259. Y260. 资源资料261. Y262.263.264. Y265. 班次资料266. Y267.268.269. Y270. 标准工序271. Y272.273.274. Y275. 物料工艺路线276. Y277. Y278. Y279. Y280. 物料资源清单281. Y282.283.284. Y285. 物料清单286. Y287. Y288. Y289. Y290. 物料生产线关系291. Y292.293.294. Y295. 生产订单296. Y297.298.299. Y300. ATP规则301. Y302.303.304. Y305. 预测版本306. Y307.308.309. Y310. 设备管理311. 设备台账312.313.314.315.316. 设备类型台账317.318.319.320.321. 测量点记录322.323.324.325.326. 出口管理327. 贸易术语328. Y329.330.331. Y332. 贸易方式333. Y334.335.336. Y337. 国家档案338. Y339.340.341. Y342. 港口资料343. Y344.345.346. Y347. 唛头资料348. Y349.350.351. Y352. 存货价格353. Y354.355.356. Y357. 报价单358. Y359.360.361. Y362. 出口订单363. Y364.365.366. Y367. 费用单368. Y369.370.371. Y372. 信用证373. Y374.375.376. Y377. 进口管理378. 进口订单379. Y380.381.382. Y383. 委外管理384. 委外发票385. Y386.387.388. Y389. 委外订单390. Y391.392.393. Y394. 基础档案395. 部门档案396. 集团账套不支持部门的导入（添加、删除、修改）导出操作397. Y398. Y399. Y400. Y401. 集团企业目录非集团账套不支持该档案的导入导出操作402. Y403. Y404.405. Y406. 人员档案407. Y408. Y409. Y410. Y411. 人员类别412. Y413. Y414. Y415. Y416. 职务簇417. Y418. Y419. Y420. Y421. 职务级别422. Y423. Y424. Y425. Y426. 职务档案427. Y428. Y429. Y430. Y431. 岗位序列432. Y433. Y434. Y435. Y436. 岗位等级437. Y438. Y439. Y440. Y441. 岗位档案442. Y443. Y444. Y445. Y446. 币种447. Y448.449.450. Y451. 银行档案452. Y453. Y454. Y455. Y456. 本单位开户银行457. Y458. Y459. Y460. Y461. 地区分类462. Y463. Y464. Y465. Y466. 发运方式467. Y468. Y469. Y470. Y471. 仓库档案472. Y473. Y474. Y475. Y476. 货位档案477. Y478. Y479. Y480. Y481. 客户分类482. Y483. Y484. Y485. Y486. 客户档案487. Y488. Y489. Y490. Y491. 供应商分类492. Y493. Y494. Y495. Y496. 供应商档案497. Y498. Y499. Y500. Y501. 计量单位组502. Y503. Y504. Y505. Y506. 计量单位507. Y508. Y509. Y510. Y511. 存货分类512. Y513. Y514. Y515. Y516. 存货档案517. Y518. Y519. Y520. Y521. 结算方式522. Y523. Y524. Y525. Y526. 付款条件527. Y528. Y529. Y530. Y531. 收发类别532. Y533. Y534. Y535. Y536. 销售类型537. Y538. Y539. Y540. Y541. 采购类型542. Y543. Y544. Y545. Y546. 成套件547. Y548. Y549. Y550. Y551. 费用项目分类552. Y553. Y554. Y555. Y556. 费用项目557. Y558. Y559. Y560. Y561. 自定义项设置562.563. Y564.565. Y566. 自定义项档案567. Y568.569. Y570. Y571. 原因码档案572. Y573. Y574. Y575. Y576. 仓库存货对照表577. Y578. Y579. Y580. Y581. 存货货位对照表582. Y583. Y584. Y585. Y586. 供应商存货对照表587. Y588. Y589. Y590. Y591. 客户存货对照表592. Y593. Y594. Y595. Y596. 项目597. Y598.599.600. Y601. 会计科目602. Y603.604.605. Y606. 汇率607. Y608.609.610. Y611. 凭证类别612. Y613.614.615. Y616. 常用摘要617. Y618.619.620. Y621. 交易单位分类622. Y623.624.625.626. 交易单位档案627. Y628.629.630.631. 交易单位账