U8EAI

U8V10.0产品培训—EAI用友软件股份有限公司U8平台及公共开发部杨庆峰2011年5月28日课程提纲一．产品简介1.产品结构2.产品特性3.应用领域二．EAI接口配置1.基础设置2.外部系统注册课程提纲（续）三．EAI数据交换1.导入导出设置2.数据映射3.数据导入4.数据导出四．EAI数据交换计划1.数据交换计划设置2.数据交换计划执行课程提纲（续）五．EAI二次开发1.接口规范2.接口调用3.通用SQL查询六．EAI日志1.业务日志2.调试日志七．常见问题与解决U8EAI产品简介U8企业应用集成（EAI）产品是U8ERP与第三方系统（非U8）进行业务数据交换的平台级工具产品，是U8ERP统一的对外开放接口。EAI产品包括一整套U8ERP的标准业务数据交换接口，这些接口涵盖基础档案、财务、供应链、生产制造、客户关系管理、HR等ERP业务模块，具备统一的入口、一致的业务外观和相对完整的业务功能，能完成U8基础数据、凭证、业务单据的导入导出及增、删、改等操作（少数不支持），是U8与外部系统进行应用集成和业务整合的基本资源。产品结构U8EAI产品结构EAI导入导出工具手动导入导出工具XML导入导出EXCEL导入导出其他格式导入导出导入导出设置条件过滤规则增量规则导入导出目标地址定时计划导入导出任务计划规划设计器任务计划执行引擎U8ERP数据交换业务接口基本档案接口财务接口供应链接口生产制造接口其它接口EAI数据交换框架EAI数据交换代理服务--EAIBroker（支持多种协议）EAI数据交换目录EAI数据交换元数据数据映射规则EAI日志适配器框架专用适配器EXCELEDI通用适配器（XML）格式和数据适配规则EAI数据交换管理器外部系统管理数据映射管理适配器管理EAI日志管理解决方案管理产品特性应用特性内容完整：涵盖了U8ERP的大部分基本档案和业务单据（含凭证），是U8ERP目前最完整、规范的对外接口。功能丰富：支持手动、自动、远程和本地接口等多种数据交换方式；支持数据映射、增量、过滤条件等多种数据交换规则。接口统一：对外提供了一个统一的服务代理接口，由此接口负责所有数据交换请求（调用）的分发处理，使外部系统对U8的接口依赖减小到最少，降低的系统耦合性。技术特性XML数据交换格式：XML提供了跨平台和低耦合特性，支持COM、.NET、JAVA等平台。Request/Response数据交换模式：数据交换的交互模式采用Request/Response方式，并通过标准的Request和Response消息来承载交互数据信息。支持本地和HTTP远程调用：本地调用采用COM方式；远程调用采用XMLHTTPPOST的方式。应用领域企业内部第三方业务系统与U8的整合财务整合：凭证上传典型案例：U8网络分销系统通过U8EAI接口向U8财务系统上传结算凭证。业务整合：单据协同典型案例：U8连锁零售系统通过U8EAI接口与U8销售和库存系统进行业务协同。包括：零售部门下载公司U8系统中的商品、客户档案、库存信息等；往U8系统上传每日结算的零售日报；库存不够了往U8发调拨申请单进行要货调拨等等业务。企业之间的B2B业务协作供应链协同典型案例：供应商远程接收订单。伙伴客户的采购系统通过供应商U8EAI远程接口往供应商U8销售系统提交订单。U8EAI接口配置U8EAI接口配置包括两项内容：EAI基本设置、外部系统注册。基本设置目的：指定EAI默认登录信息，包括指定U8应用服务器名或IP、EAI登录身份验证、EAI数据源。如果进行数据交换的数据包比较大，则需要点“自动设置IIS”更改IIS的最大数据上传或下载限制。外部系统注册目的：为了建立外部系统与U8业务帐套之间的数据交换关系。在数据交换中，需要明确指定外部系统与U8某个业务账套的对应关系，该对应关系由一个唯一的注册码标识。数据交换时需要在请求消息的头部指定一个注册码：ufinterfacesender=“注册码”…，表示请求方需要与该注册码对应的U8业务帐套进行数据交换。U8EAI接口配置基本设置“开始”-“程序”-“用友ERP-U8V10.0”-“企业应用集成(EAI)”-“EAI接口设置”U8EAI接口配置外部系统注册在“EAI接口设置”中切换到外部系统注册页签进行外部系统注册。可以注册多个外部系统注册码。U8EAI接口配置外部系统注册在进行外部系统注册时，还可以同时指定U8业务帐套的连接身份，默认“使用EAI的连接身份”。U8EAI数据交换导入导出设置在数据交换之前，用户可设置每个具体项目的导入或导出文件的存放路径及导出数据的过滤条件，在以后的数据交换时系统按照预设的条件进行操作。U8EAI数据交换数据映射在进行数据交换时，外部系统与内部系统的基础档案可能存在不一致的情况，这时需要建立外部数据、内部数据之间的对应关系。U8EAI数据交换数据导入数据导入功能：将档案或单据数据(可批量)导入到外部系统注册码对应的U8业务帐套中，同时支持多种导入文件格式，如常见的XML和Excel格式。U8EAI数据交换数据导出数据导出功能：根据所选外部系统注册码，导出对应U8业务帐套中保存的一个或多个档案或单据项目的全部或部分数据。U8EAI数据交换计划应用场景实现在无人值守的情况下，U8EAI能按预先设置的计划自动的进行数据交换。典型应用场景：多个U8业务帐套之间的档案或单据数据同步。操作步骤首先进行数据交换计划的参数设置。一个注册编码可以设置一个定时计划，一个定时计划中可以设置多个自动导入导出项目的执行规则，包括：执行频率、执行期间和是否按照数据映射关系执行。然后执行数据交换计划。单击【数据交换计划执行】菜单，当到达预置的计划时间，U8EAI就会自动执行已定义的数据交换任务。U8EAI数据交换计划数据交换计划设置指定数据交换执行的时间和频率，并设置导入导出的条件和路径以及是否按照数据映射关系执行。U8EAI数据交换计划数据交换计划执行单击【数据交换计划执行】菜单，在windows的状态栏中显示一小图标，即【用友U8EAI计划监控程序】。U8EAI二次开发U8应用服务器外部系统二次开发工作EAI数据交换COM接口IIS调用EAI接口数据转换或处理本地调用远程调用U8EAI接口规范接口定义本地COM接口类库：U8Distribute.DLLProgID：U8Distribute.iDistribute方法：StringProcess(StringRequestXml)参数：数据交换请求消息，详见数据交换格式定义。返回：数据交换响应消息，详见数据交换格式定义。远程HTTP接口EAI远程数据交换采用HttpPOST的方式。访问网址：或机器名/U8EAI/import.aspPOST上传：数据交换请求消息与本地调用一样。Response接收：数据交换响应消息与本地调用一样。U8EAI接口规范数据交换格式总体格式EAI数据交换消息格式分为框架和内容两部分：ufinterfacesender=“001”receiver=“u8”roottag=“department”proc=“Add”dynamicdate=“12/25/2010”—框架部分department…/department—内容部分/ufinterface框架部分包含数据交换的控制信息，其中：–sender:发送方，填外部系统注册码–receiver:接收方，填u8即可–roottag:档案或单据，填档案或单据的唯一标识–proc：操作类型，分为“增删改查”，对应填add/delete/edit/query–dynamicdate:业务账套登录日期,如果不填,则取U8应用服务器所在操作系统的当前日期U8EAI接口规范数据交换格式总体格式内容部分：指数据请求或响应消息中携带的档案或单据等业务数据，如：U8EAI提供了一整套完整的基本档案和单据的数据交换模版（在EAI\XML\Template目录下），模板中定义了消息内容部分的格式和字段。departmentcode1/codeendflag0/endflagname综合处/namerank1/rankmanager/prop管理兼技术/prop/departmentU8EAI接口规范数据交换格式Request-请求消息格式对于add/edit操作，Request消息的内容就是档案和单据内容，举例如下，具体格式请详见EAI提供的数据模板。?xmlversion=1.0encoding=utf-8?ufinterfacesender=001receiver=u8roottag=departmentproc=“addcodeexchanged=nexportneedexch=Npaginate=0display=部门档案“family=基础档案departmentcode001/codeendflag1/endflagname基建投资部/namerank2/rankddepbegindate2011-01-26/ddepbegindatecdeptype部/cdeptype/department/ufinterface常见问题与解决数据交换格式条件过滤对于delete/query操作，Request消息的内容包含过滤条件。查询单条数据的时候往往需要带上条件，可以采用U8EAI通用SQL查询，也可以采用U8EAI标准的条件查询格式，如：注意:field节点中的name过滤字段名需和数据库中字段名一致。?xmlversion=1.0encoding=utf-8?ufinterfacesender=001receiver=u8“roottag=department”proc=“query“departmentfielddisplay=“部门编码name=cDepCodeoperation==value=“001logic=//department/ufinterfaceU8EAI接口规范数据交换格式Response-响应消息格式Response消息是EAI接口执行Request消息之后的返回结果，不同的操作有所不同：对于query操作，返回的结果就是查询的数据，格式详见EAI数据模板。对于add/edit/delete操作，返回的结果包括单据体每一行数据的详细执行结果(由Item节点描述)，如下：ufinterfaceroottag=“return”docid=“823482692”proc=“add”!--key:单据表体行数据的编号，比如：销售订单表体的存货编码succeed:成功或失败号，0为成功，其他值为失败dsc:成功或失败的描述信息u8key：成功后U8系统对应的关键字--itemkey=001succeed=0dsc=u8key='001'/itemkey=002succeed=0dsc=u8key='002'//ufinterfaceU8EAI接口规范数据交换格式Response-响应消息格式凭证的add操作的Response格式比较特殊，如下：返回字段含义如下：–accounting_period：会计期间，0为期初往来明细帐，21为期初待核银行帐，20为银行帐科目调整前余额，1-12为凭证及明细帐；–voucher_type：凭证类别字；–voucher_id：外部系统原始凭证号(期初时可为空)；–u8voucher_id：U8生成的凭证号；–u8accounting_period：U8凭证会计期间–succeed：是否成功，0为成功，非零为失败。ufinterfaceroottag=voucheraddreturndocid=proc=additemaccounting_period=10voucher_type=记voucher_id=88