产品应用方案信息交换平台数据集成篇用友网络科技股份有限公司新一代云ERP解决方案2目录1总体介绍..32外部系统注册..43数据导入文件准备..44数据导入文件发送..94.1手工发送.104.2定时批量发送.104.2.1后台任务类型注册.104.2.2后台任务部署.124.3程序接口调用发送.134.3.1根据密码获取accesstoken..154.3.2根据accesstoken获取用户信息.165数据导出..17用友网络科技股份有限公司新一代云ERP解决方案31总体介绍外部交换平台总体结构图外部数据交换平台主要用于外部系统和U8cloud系统进行集成。利用外部数据交换平台，可以将外系统的基本档案和业务数据发送到U8cloud系统中，并进行相关的业务操作，如审批、弃审，也可以通过发送XML格式的查询条件导出U8cloud系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。主要特点：支持通过XML格式作为数据交换标准，为数据访问提供简便、统一的模式。XML格式在数据表达和描述方面有着很大的优势，逐渐成为业界的标准，采用XML格式作为交换标准格式可以很好的保护企业投资。支持通过EXCEL文件格式进行关键数据的系统间交换。在“交换规则定义”节点中可选择相关业务模块，导出预置数据模板包，基于模板维护相关业务数据后，可通过“手工加载界面”将其传送进U8cloud系统。面向服务的架构。这使得第三方系统可以随时随地向U8cloud系统发送相关的业务数据，U8cloud内部的预警服务及工作流引擎使得U8cloud系统可以在合适的时候向第三方系统传送需要的数据，并且满足第三方系统的格式规范。灵活配置。数据转换的规则可灵活定义，独立于应用集成和业务逻辑，也就是说根据不同的外部数据结构，直接通过修改交换规则文件的定义，即可达到各种异构数据无缝集成的目的。自由扩充。对于标准产品不支持的业务单据，如果有集成需求，信息交换平台提供了向导式的二次开发工具，集成了所有与二次开发相关的功能及配置，支持动态部署，可以在用户环境上进行快速有效的开发。用友网络科技股份有限公司新一代云ERP解决方案42外部系统注册外系统要和U8cloud系统交换数据，彼此必须可以相互识别，外部系统信息设置就是用来配置U8cloud系统可识别的外部系统。根据协议，发送的数据文件属性头中必然包括sender字段，将该字段配置为外系统编码后，U8cloud系统才可识别该外系统文件，并根据之后配置的匹配规则、交换规则等对文件进行处理，翻译转化为U8cloud系统中的数据。在【应用集成】→【信息交换平台】→【外部系统信息设置】中点击〖增加〗按钮，完善信息并保存即可：匹配规则用来配置数据文件中需参照U8cloud基础档案翻译字段的翻译规则，其优先级为：默认基础数据匹配规则<表体中的基础数据匹配规则<“基础数据对照表”配置的对照关系，所以默认匹配规则一般看数据文件中需参照基础档案的字段多数和U8cloud系统中基础档案的编码或名称哪一项一致即设置为哪一项，其他档案在表体中做设置，两种设置均无法满足需要，就只能通过增加基础数据对照来对数据做映射了。3数据导入文件准备对于系统预置的基本档案导入，可在【应用集成】→【信息交换平台】→【交换规则定义】中点击打开按钮，选择需要导入的单据类型和上一步创建的外部系统，点击确定打开系统预置的默认交换规则，点击导出即可导出预置数据文件作为参考，按此模板完善的数据文件可直接导入，文件的翻译转化将使用系统默认的交换规则。若对于某些基本档案，外系统数据文件格式和内容与U8cloud默认支持的差异性较大，人工转换过于复杂，可通过修改交换规则定义使外系统数据文件可识别，首先打开系统对于某基本档案预置的默认交换规则，对交换规则做必要的修改，此处可做保存操作以便日后重用：点击另存为，在弹出的对话窗口中选择外部系统，点击确定即保存。注意：另存为操作将创建基本档案对于特定外部系统的交换规则，直接保存则会修改系统预置的交换规则，所以对交换规则做修改后，请务必另存为外部系统，避免对系统预置的规则造成篡改。下面介绍一下xml文件修改交换规则经常涉及到的内容，以导入仓库档案为例，假定下图为外部系统用友网络科技股份有限公司新一代云ERP解决方案5的仓库档案文件：打开系统预置的仓库档案的默认交换规则，将交换文档根标签属性值设置为data（默认为bill），与外部系统保持一致：接下来看表记录，将billhead的外系统定义的表标签设置为header（默认为billhead）【外系统定义的表标签】是外系统数据文件中单据表头元素的标签名，在上面的外部系统文件中是header，因此该属性值必须改为header，否则导入会报找不到表头元素的错误。再看字段属性项的配置我们发现仓库档案外部文件的所属地址字段名为address，而系统预置的交换规则中该字段的“该字段在外系统中的名称”值是pk_address，此处需要修改为address。【该字段在外系统中的名称】表示字段元素的标签名，数据交换的本质是数据映射，映射过程中可能两个系统的字段名不一致，这时就需要配置此信息项，否则会造成信息丢失。用友网络科技股份有限公司新一代云ERP解决方案6单据的某些字段需要参照U8cloud基础档案进行翻译，类似于界面的参照选择，我们在界面增加仓库档案时，地点编码需要参照地点档案进行选值，这里也要做相应配置。【需要参照的U8cloud基础档案】表示该字段翻译时需要参照U8cloud的指定档案进行翻译（根据前面设置的外部系统的匹配规则进行翻译），如不指定，会造成数据错误或导入无效的数值。【规则】用于外部系统和U8cloud系统数据间的简单映射，比如“true=Y;false=N”表示若外系统当前字段传值为true那么导入U8cloud中为Y，false则对应N。我们看到上面的外部系统数据文件中csflag字段传值是true/flase，这里就可以将其映射成Y/N。观察不难发现，外部系统数据文件提供的字段明显少于U8cloud系统需要的字段数量，并且某些字段在U8cloud中不允许为空，此时可为该字段设值默认值。【默认值】顾名思义就是当外系统数据文件没有为字段提供值时，取此值导入到U8cloud系统中，适用于U8cloud内的非空字段，但外系统不具备相应字段值的情形。用友网络科技股份有限公司新一代云ERP解决方案7以上介绍的是导入过程中常用的属性，另外某些属性意义浅显不做赘述，其他属性非二次开发人员无需修改。将上述改后的交换规则另存为外部系统，以后导入该外部系统的仓库档案即可重复使用，这时再用上面的外部数据文件做导入操作，观察U8cloud外部交换平台对数据文件做了哪些转换和翻译操作，如下图（右侧为经外部交换平台翻译后的文件）：对于主子表结构的多行子表数据文件，可以按如下方法生成：【交换规则定义】->【打开】->【导出】，导出界面选择模板、选择数据文件目录，当前支持的格式有xml和xls、xlsx三种。下面以总账凭证为例，用友网络科技股份有限公司新一代云ERP解决方案8导出的xls文件式样：用友网络科技股份有限公司新一代云ERP解决方案9编辑如下内容：a.第一行的B(roottag)和C(billtype)表示的是表头和表体行。如果只有表头，是档案数据。b.第三行的sender下面填的值是外部系统编码值如1101。c.表头和表体行可以录入多条数据。d.表体和表体都要录入id。如果表头和表体是同一个单据，用相同的id来标识。凭证为例，一张凭证的不同分类行的id是相同的。e.表体数据有孙表信息，在右侧用特殊字段隔开，如备注列辅助核算的auxiliary_accounting。f.一条表体对应多条孙表信息，前面空出来，只写一条表体数据，如第10行这个表体有两个辅助核算项，第11行表体部分不要录入，B11的id也不要写。后面孙表部分竖排表示，第10行和第11行的孙表数据都是第10行表体的g.孙表没有数据就空出来，如R9到T9。h.孙表有数据就要用字段行的特殊字段标识出来。如R13和R17的auxiliary_accounting与R8的auxiliary_accounting一样。i.编辑完数据后，数值型的数据是需要保证是文本型的，单元格出现左上角的小角标。j.导出格式允许建议不进行大范围的的设置如按照整列设置文本格式，会导致导入不进去。编辑完成后如下图：4数据导入文件发送数据文件准备完毕，接下来就是发送了，U8cloud外部交换平台支持客户端以同步和异步两种方式发送（加载）外部数据。对于异步加载方式平台内置了两类客户端：界面和预警，而对于同步加载方式，需要编写向U8cloud后台Servlet发送文件的代码，下面分别介绍。用友网络科技股份有限公司新一代云ERP解决方案104.1手工发送手动加载界面发送，这是外部数据最简单也最常用的一种客户端发送方式，点击【应用集成】→【信息交换平台】→【手动加载界面】，在打开的界面中选择需要发送的文件，如有必要，修改目标URL地址的receiver（接收公司）参数值，选择待发送文件并点击“发送”按钮即可。手工发送支持的文件类型，XML与EXCEL格式。修改完数据文件后，要点击刷新，来同步数据。选中要导入的文件点击发送，导入数据。发送完成后，点击〖回执文件查看〗按钮或直接打开回执目录查看外部交换平台的回执信息，可以看到文件的失败与否。4.2定时批量发送定时批量发送是通过后台预警发送，具体配置步骤如下。4.2.1后台任务类型注册【企业建模平台】→【任务中心】→【任务类型注册】中点击新增按钮，在弹出的后台任务类型注册对话框中配置一个类型为“外部交换数据后台发送”的后台任务条目（此任务U8cloud已预置，若存在则无需再注册）。用友网络科技股份有限公司新一代云ERP解决方案11其配置如上图所示。在参数列表部分内置了四个预警条件：1.【待发送文件目录】该预警条件阈值用于设置用户数据文件目录（不能为空）；2.【回执目录】该预警条件阈值用于设置存放单据导入之后的回执信息的目录，每张单据一个回执文件，如果用户不设置这个阈值，默认将待发送文件目录作为回执目录；3.【发送后文件转移目录】该预警条件阈值对于想将能够成功加载的文件转移走的用户有用，若配置后台任务为周期性执行，配置该阈值可防止文件被重复发送；4.【发送配置信息】该预警条件阈值是一个可扩展的预警条件阈值，它用于配置将什么样的文件发送到哪个URL地址（不能为空）。这个配置值的格式如下：billtype=test;sysno=0001;urladdress=http://localhost:80/service/XChangeServlet?account=1001。其中第一部分是单据类型（billtype=test），第二部分是外系统编码（sysno=0001），第三部分是目的URL地址：（urladdress=http://localhost:80/service/XChangeServlet?account=1001）上面所列发送配置信息项取值的意思就是将单据类型是“test”，外部系统编码为“0001”的文件发送到U8cloud外部数据接收的Servlet地址：http://localhost:80/service/XChangeServlet?account=0001。这个地方如果我们将单据类型的取值设为“XX”或“xx”的话，表示任何单据类型的文件都可以往某个地址发送，相当于通配符的意思，但对于外部系统编码没有通配符。用友网络科技股份有限公司新一代云ERP解决方案124.2.2后台任务部署【企业建模平台】→【任务中心】→【后台任务管理】→【后台任务部署】中点击增加按钮，条目属性标签页类型选择“外部交换数据后台发送”。发送配置信息是一个可扩展的预警条件阈值，意思就是用户可以在预警平台的类型注册对话框中修改名为“外部交换数据后台发送”的预警类型定义，增加作为预警条件的发送配置信息项，以实现数据文件的多点发送，操作方法如下：在上一步的菜单中选中“外部数据交换后台发送”行，点击修改按钮，弹出“类型注册”对话框，为其增加一个发送配置信息阈值项。用友网络科技股份有限公司新一代云ERP解决方案13需要注意的是该新增阈值项的名称必须以字符串“postconfig”开头，如“postconfig1”、“postconfig2”等。这样配置更多的发送配置信息，使得能有选择地将某个特殊单据类型特殊外部系统的数据文件能够发送到某个指定服务器地址去。配置完毕，即可由预警平台调度和执行发送任务。另请注意，在待发送文件目录、回执目录和发送后转移目录的设置上本地客户端和服务器端文件系统的差别，如目录“c:/aaa”指的是服务器端文件系统路径而非客户端文件系统地址。4.3程序接口调用发送外系统对接U8cloud外部交换平台上传报文时，需要对报文进行加密处理，同时平台会进行权限校验（要求上传可以唯一标识友户通用户身份的accessToken），具体报文加解密和友户通对接事宜请联系U8cloud开发人员。以Java代码为例，介绍如何自定义程序向U8cloud系统发送数据，以下代码仅做参考：packagecom.yonyou.test.demo;importjava.io.BufferedReader;importjava.io.FileInputStream;importjava.io.InputStream;importjava.io.InputStreamReader;importjava.io.OutputStreamWriter;importjava.io.Writer;用友网络科技股份有限公司新一代云ERP解决方案14importjava.net.HttpURLConnection;importjava.net.URL;importorg.apache.commons.io.IOUtils;publicclassSendDemo{//接口调用地址privatestaticfinalStringurl="http://127.0.0.1:80/service/XChangeServlet";//待发送文件privatestaticfinalStringfilePath="C:/Users/Administrator/Desktop/待发送文件.xml";publicstaticvoidmain(String【】args)throwsException{//获取友户通accessTokenStringtoken=createToken();pfxxSend(token);}/***获取友户通accessToken*@return*/privatestaticStringcreateToken(){//此处需要对接友户通return"token";}/***文件发送*@paramtoken*@throwsException*/privatestaticvoidpfxxSend(Stringtoken)throwsException{HttpURLConnectionconn=(HttpURLConnection)new用友网络科技股份有限公司新一代云ERP解决方案15URL(url+"?token="+token).openConnection();conn.setDoOutput(true);conn.setRequestProperty("Content-type","text/xml");conn.setRequestMethod("POST");Writerw=newOutputStreamWriter(conn.getOutputStream(),"UTF-8");BufferedReaderreader=null;reader=newBufferedReader(newInputStreamReader(newFileInputStream(filePath),"UTF-8"));StringtempString=null;StringBuffersb=newStringBuffer();//一次读入一行，直到读入null为文件结束while((tempString=reader.readLine())!=null){sb.append(tempString);}w.append(sb);reader.close();w.flush();w.close();InputStreami=conn.getInputStream();System.out.println(newString(IOUtils.toByteArray(i),"UTF-8"));}}4.3.1根据密码获取accesstoken基本信息描述获取accesstoken路径/oauth/token请求方法POST请求参数usernameString用户名md5passwordStringmd5密码用友网络科技股份有限公司新一代云ERP解决方案16shapasswordStringsha密码multiLoginboolean是否支持多设备登录SDK方法：publicstaticStringgenerateAccessToken(StringuserName,Stringmd5Password,StringshaPassword，booleanmultiLogin)body{"username":"test","md5password":"test","shapassword":"test"}返回值字段类型描述statusint请求的状态，如果为0，表示失败，如果为1，表示成功resultString{"accessToken":"f2a2314a-1fdd-41e3-9119-4b2e8bb63ca5","refreshToken":"f2a2314a-1fdd-41e3-9119-4b2e8bb63ca5","expires_in":"86400"}4.3.2根据accesstoken获取用户信息基本信息描述根据accesstoken获取用户信息路径/user/getUserByToken请求方法POST请求参数access_tokenStringaccesstoken用友网络科技股份有限公司新一代云ERP解决方案17SDK方法：publicstaticStringgetUserByToken(StringaccessToken)body{"accessToken":"f2a2314a-1fdd-41e3-9119-4b2e8bb63ca5"}返回值字段类型描述statusint请求的状态，如果为0，表示失败，如果为1，表示成功userString用户信息5数据导出数据文件准备，U8cloud系统支持部分基础档案和财务凭证的xml文件导出，目前已知的支持的基础档案包括部门档案、人员管理档案、人员类别、客商管理档案、会计科目。外部交换平台的设置（包括上文提到的匹配规则、交换规则和基础数据对照等）都会影响xml文件的导出，换句话说就是导入数据是根据外部交换平台的配置信息将外系统xml数据文件解析成U8cloud数据，而导出恰好相反，是从U8cloud数据到外部系统xml数据文件的转换。以人员管理档案为例说明一下文件导出的过程，在【企业建模平台】→【基本档案】→【人员信息】→【人员管理档案】中选择部门查询出人员档案后，点击导出按钮，在弹出的导出对话窗中选择目标系统（即外部系统）并填写目标文件，点击确定即可。用友网络科技股份有限公司新一代云ERP解决方案18用友网络科技股份有限公司新一代云ERP解决方案19新一代云ERP解决方案NewGenerationofCloudERPSolution用友网络科技股份有限公司YonyouNetworkTechCo.Ltd.用友网络科技股份有限公司
