外部交换平台使用说明本文档适用于外部交换平台所有用户，和以前版本不同地方将重点介绍，并以红色字体标明。外部交换平台介绍：1.1功能介绍：外部交换平台是用来在u8c和其他外部系统之间交换数据的工具。其他外部系统如U8产品，或者其他公司的产品，只要遵守了共同约定的数据规范（在该平台中使用的是XML文档），就可以实现诸如基本档案、会计凭证和各种业务单据的系统间的交换。利用外部数据交换平台可以通过发送XML格式的查询条件导出u8c系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。在某些应用场景下，还可以通过配置u8c系统内的单据动作脚本，在某一业务操作被触发时向外系统发送数据。1.2按发送流程介绍节点：交换平台日志（参数设置）（必须）外部交换平台参数设置类似于客户化参数设置，用来设置外部交换平台各参数，各参数的意义下面具体介绍。参数可以随时修改，修改后即时生效，不需要重新登陆或重启中间件。打开[外部交换平台维护]-[交换平台日志]，点击[参数设置]，在弹出对话框中逐个输入各参数值，确认后即可生效。用友网络科技股份有限公司下面逐个介绍各参数：外部系统默认账套:一般指定为当前登陆账套，指定默认账套后，如果发送时没有指定账套，则取该默认账套。单篇最大传输上限：设置要传输的单个数据文件大小的上限。如要导入的数据文件大小比该值大，系统将会提示文件超长，要求整理数据文件。如不需整理文件，可把该值改大。导入过程中是否记录中间文件：为提高外部交换平台的导入效率而设置。因记录中间文件需要一定时间，用户在日常发送时建议不勾选该选项，如发送时出现错误，再勾选，查找错误原因。回执文件后台备份：从其他系统通过http协议发送文件到u8c系统时，回执文件有时会被外系统吃掉，无法查找问题原因，勾选该选项后会在u8c服务器端备份一份回执文件，便于查找问题原因，日常发送时建议不勾选该选项。回执和导出文件编码格式：u8c系统支持导出UTF-8和gb2312两种格式的XML文件，由用户根据自身系统编码格式决定需要u8c导出的XML文件的编码格式。单据导入规则设置：用户可根据自身需要选择同一文档中的单据一并发送还是逐个发送，如凭证等可选择逐个发送，成功的发送过去，有错的再次发送，提高发送效率并减小并发错误几率。发送方IP范围设置：为提高外部交换平台的安全性而设立该参数，用户可指定发送方IP地址或IP范围，防止通过外部交换平台向u8c系统发送垃圾数据。外部系统信息配置（必须）外部系统要和u8c系统交换数据，彼此间必须相互可以识别，外部系统信息配置就是用来配置u8c系统可识别的外部系统。根据协议，发送的数据文件属性头中必然包括sender字段，配置外系统为sender字段内容后，u8c系统便可以识别该外系统文件，并根据随后配置的匹配规则、辅助信息、基础数据对照表及交换规则对文件进行处理，翻译转化为u8c系统中数据。用友网络科技股份有限公司打开[外部交换平台维护]-[外部系统信息设置]，增加外系统及匹配规则，增加时注意外系统编码填写数据文件属性头sender中内容。匹配规则用来配置数据文件中需参照u8c基本档案翻译字段的翻译规则，其优先级低于基础数据对照表中配置的对照关系，表体中基础数据类型匹配规则高于表头的默认匹配规则。配置匹配规则是为了免去用户逐条配置基础数据对照表的繁琐，提高易用性，请用户根据自身实际情况灵活使用。配置方法：默认匹配规则一般看数据文件中需参照基本档案的字段多数和NC系统中基本档案的编码或名称哪项一致，即设置成依据哪项默认匹配，其他档案在表体中设成按其他规则匹配，都不一致的就只能增加对照表了。Eg.发送一张凭证到u8c系统，其中科目、凭证类别、币种、辅助核算内容（如客户辅助核算）等字段都需要根据u8c基本档案进行翻译，文件中科目为现金、银行存款等，需要对应的u8c科目名称也同样为现金、银行存款；凭证类别为记，对应u8c凭证类别编码为记，名称为记账凭证；币种为人民币，对应u8c名称为人民币；客户辅助核算值和u8c对应客户档案编码、名称都不一致。对于这张凭证，较简单的配置方法是默认匹配规则设置为按名称，表体中设置凭证类别按编码，在基础数据对照表中设置客户辅助核算的对照关系，这样就省去配置科目、凭证类别、币种等设置对照表的步骤，如下图所示。用友网络科技股份有限公司辅助信息配置（可配）对于存货基本档案、客商基本档案、项目基本档案等在集团增加可分配到下级公司的档案，支持导入到集团的同时分配给公司，只需在辅助信息中配置。对于存货管理档案，可分配到库存组织。对于凭证，配置凭证各字段是否允许修改、删除。对于银行对账单，配置对账单的对账账户和业务类型信息。打开[外部交换平台维护]-[辅助信息配置]，增加客商档案、存货档案、项目档案的分配关系、凭证的修改和删除权限及银行对账单的业务信息。在配置时客商、项目档案的接收公司为集团，在表体中增加要分配到的公司，在导入档案到集团的同时，系统自动把基本档案分配到辅助信息中配置的公司。客商、项目的接收公司不能为公司，没有意义。下图为配置的客商档案辅助信息。用友网络科技股份有限公司存货档案可以分三种形式导入：存货基本档案(简称基本档案)、存货基本档案+管理档案(简称管理档案)、存货基本档案+管理档案+物料生产档案(简称综合档案)。存货基本档案有两种发送方式：集团(不分配给公司)、集团(分配给公司)，如果选择导入集团同时分配给公司，则需要在辅助信息设置界面设定待分配的公司，并且单据类型要选择invbas，如下图所示。管理档案也有三种发送方式：集团(不分配给公司)、公司、集团(分配给公司)，如要分配给公司，同样需要配置辅助信息，只是配置辅助信息时单据类型要选择bsinvbas。如下图。可以看出管理档案发送方式和基本档案差不多，只是可以在数据文件中默认带一些管理档案的信息。用友网络科技股份有限公司综合档案有两种发送方式：公司(不分配给多库存组织，此时物料生产档案直接增加到数据文件中定义的库存组织)、公司(分配给多库存组织，可以在辅助信息界面配置待分配的库存组织及相应的主仓库，配置辅助信息时单据类型要选择bsinvbas，如下图所示。)以上各种导入方式用户可根据业务需要，灵活选择。下图为U8配置界面。辅助信息配置只定义修改删除权限，并且必须保证配置正确，下图为凭证配置界面。用友网络科技股份有限公司在配置银行对账单时，配置信息需和数据文件中对应信息一致，如下图所示：基础数据对照表（可配）对于需要参照基础档案进行翻译的字段，配置匹配规则只能翻译外系统值和档案名称或编码一致的，对于不一致的，需要在基础数据对照表中作对应。打开[外部交换平台维护]-[基础数据对照表]，配置按翻译匹配规则(编码、名称翻译方式)无法翻译的字段与相应值的对照关系。如按匹配规则能翻译过来，不建议逐个档案都增加对照，过于繁琐。用友网络科技股份有限公司比如外系统人员字段值为C001，系统中于此对应人员的编码也为C001，那么就不需要建立数据对照，指定人员档案按编码匹配即可；如人员名称为C001，则指定人员档案按名称匹配；但如果外系统编号为C001的人员，对应系统中的B002，则需要在基础数据对照中建立C001到B002的对照关系，如下图所示。基础数据对照表增加自动增加和文件导入两种增加方式，方便用户使用。选择外系统和基础数据分类后，点击[基础数据自动增加]按钮，选择按编码或名称导入，系统会自动增加该基础数据类型表中所有数据，[外部系统值]同基础数据的编码或名称。用户可以在此基础上修改部分[外部系统值]，达到快速增加对照关系的目的。用友网络科技股份有限公司基础数据文件导入支持Excel文件和XML文件导入。Excel文件导入时，系统自动取文件的第一列添入[外部系统值]中；XML文件导入时，系统根据用户指定按编码或名称导入取编码或名称值添入[外部系统值]中。用户自行选择对应的基础数据，对于没有输入基础数据的[外部系统值]，系统将自动按照具体外系统的默认数据对照关系进行翻译转换。手动加载界面（可选）外部交换平台的异步发送方式有两种，手动加载方式和预警加载方式，在手动加载界面完成对外系统文件的加载。打开[外部交换平台维护]-[手动加载界面]，发送数据文件到NC系统。在加载数据的同时，系统会返回回执文件，如未发送成功，用户可根据提示内容调整配置，再次发送。加载成功转移目录：输入加载成功转移目录后，如果数据文件中全部单据成功完成，该文件就被转移到该目录下，如有未成功单据，则不被转移，仍在原目录下。用友网络科技股份有限公司压缩传输：支持压缩传输与非压缩传输两种传输模式，如果机器性能较差但网络状况很好(比如局域网内)，可以采用非压缩传输，相反，则采用压缩传输，在远程传输较大的数据文件时，压缩传输能大大提高传输效率。目标URL地址：由服务器地址、服务、发送账套、接收方地址等组成，登陆时自动生成，可手工修改。如发送主体账簿类型的档案或凭证，需手工在receiver=公司后加@要发送的主体账簿编码，如下图所示。如不加主体账簿，表示发送到公司的主账簿。系统会对接收公司和文件中组织字段值一致性判断，如二者不相同，将无法导入。如文件中组织字段内容为空，交换平台会自动将接收公司值写入公司字段。但要注意如交换规则定义中组织字段不允许为空，仍通不过检查，如用户需要此功能，需把交换规则定义中组织字段该为允许为空，如下图所示。交换平台日志（可选）用友网络科技股份有限公司在每次发送数据文件返回回执的同时，外部交换平台会生成平台日志，在该节点可进行日志的查询、删除等操作。打开[外部交换平台维护]-[交换平台日志]，查询、删除日志信息。在交换平台日志节点，刷新操作的结果为查询当天的日志，删除操作的结果为删除当前界面显示的所有日志。交换规则定义（可配）（原校验文件管理节点）外部系统数据文件的格式和内容差异性很大，要转化成系统可识别的数据才可导入，就需要在交换规则定义节点定义数据的校验规则、转换规则、导出格式等。因本文档的适用读者为实施人员及用户，只介绍导入文件时经常涉及到的内容，二次开发人员请参考实施和二次开发指南。打开[外部交换平台维护]-[交换规则定义]，打开要修改的单据类型，对应外系统的校验文件，修改后保存即可，修改后即时生效，不需要重新登陆或重启中间件。用友网络科技股份有限公司常用字段属性说明：该字段在外系统中的名称：系统字段和外系统中相同意义的字段名称并不一定一致，修改该值为外系统中字段名，导入时将外系统中字段转换为系统中对应字段。是否允许为空：在插件检查前外部交换平台会先根据交换规则检查必输字段内容是否已输入，一般情况下不需要修改，用户也可根据自身需要修改各字段是否必输。需要参照的基础档案：单据的某些字段值需要参照基本档案进行翻译，类似于界面的参照选择，如导入凭证时，会计科目值需要参照科目档案翻译，这里定义字段需要参照的基本档案。添加默认值：如字段为系统必输项，外系统中无此字段或字段值为空，可点右键添加默认值，在文件中字段为空的情况下，交换平台会取默认值写入字段。规则：一般情况下该字段不需要用户自行修改。Eg.外系统中值为True或False，而系统存储值为0或1，可定义规则：True=0;False=1，交换平台将外系统值转换为系统值。需要与接收方一致：在手动加载界面已经介绍过，本版增加了数据文件中组织字段值和接收方公司的一致性校验。这里要注意组织字段的选择，公司类型档案一般选择公司字段作为组织字段，而主体账簿类型档案一般选择主体账簿字段作为组织字段。是否需要导出：该字段用于需从系统导出文件时，如用户不需要系统中某些字段信息，可把对应字段设为不需要导出。单据备用编号字段：选中交换文档从右键菜单中增加，值根据用户需要输入数据文件中某个字段名。该字段用于数据文件的ID号为空时，取定义的字段值作为单据的ID号。Eg.科目的数据文件根标签为，流水号为空，如下图所以，定义科目的交换规则文件的备用字段为id，则发送时取该单据的id字段值作为流水号，如单据中有语句1，则交换平台处理时将流水号置为1，相当于数据文件的根标签为，仍可通过发送文件对这张单据进行编辑。为了使流水号不重复，选择作为备用流水号的字段应为值满足唯一性字段。如不增加该字段，交换平台处理时将流水号置为永不重复值，只能导入不能通过交换平台对单据进行编辑了。用友网络科技股份有限公司以上介绍的是在导入导出过程中常用的属性，其他属性非二次开发人员不建议修改。导入文件介绍2.1文件格式介绍：以凭证样本数据文件为例介绍导入文件：下面逐条介绍文件：1.文件的编码头：为XML文件必须的格式定义，包括版本号（在本例中为version=”1.0”）和编码格式（包括gb2312及utf_8两种，本例中为gb2312格式）。2.文件的属性头：以ufinterface开头，内容为XML文件各属性。下面对文件属性进行逐个说明：roottag:根标签，其内容和单据的根标签值一致。(本例中roottag值为voucher，单据的根标签（3）也为voucher。)billtype:单据类型，必有，表示要传输的文件类型。（本例中billtype值为gl，表示传输的文件为财务凭证）。单据类型值可参考交换规定定义。sender:发送方编码，必有，值任意。发送文件时在外系统信息配置中配置编码和该值用友网络科技股份有限公司一致的外系统。receiver:接收方地址，其值可以为系统接收公司、接收主体账簿或为空。当加载界面的接收方地址为空或通过http协议发送无接收方时取该值作为接收方。replace:是否覆盖标志，表示文件已经被正确导入后是否允许再次导入，值为Y/N，默认为Y。isexchange:是否参照基本档案进行翻译。值为Y/N，默认为Y。filename:文件名，值任意。proc:动作，必有，表示发送的文件要对系统进行的操作，值有add（增加）、update（修改）、delete（删除）、query（查询）、audit(审批)、unaudit（反审）等。3.根标签：内容和属性头中roottag值一致，每张单据有且只有一个，所以可以作为单据的开始，后跟单据的流水号（即ID号）。ID号是一张单据的唯一标识，相同的ID号代表同一张单据，如果ID号为空，系统会自动为单据生成流水号。（具体规则请见）4.单据头：单据的表头，一般一张单据只有一个单据头。5.单据体：单据的表体，可有可无，也可有多个体，格式根据外系统文件各异。6.分录：单据体中的子层次，内容和格式根据外系统文件各异。（本例中凭证有三条分录，故有三个entry）下图为单据头voucher_head打开后的内容：从上图可见，凭证单据头由若干简单字段组成，各字段含义和注意事项在发版盘附带的样本数据中均有介绍。下两图为单据体一条分录打开后的内容：用友网络科技股份有限公司从上图可见，分录中科目、金额等信息简单字段组成，辅助核算项目和现金流量信息由多层结构组成，这说明外系统文件的层次和格式内容都是可由外系统自行定义的，但各字段的层次结构在交换规则定义中定义。发版盘提供的样本数据文件是NC默认格式，用户可参考。如发送文件和样本数据文件格式相同，则可使用发版盘提供的已定义好的默认交换规则定义，无需自行修改，二次开发人员请参阅二次开发指南。2.2基本档案：用友网络科技股份有限公司支持导入的基本档案：公司目录、自定义项档案、部门档案、人员类别、人员档案、地区分类、客商档案、存货分类、仓库档案、计量档案、存货基本档案、存货管理档案、存货综合档案、项目基本档案、结算方式、会科目。支持导入的U8基本档案：部门档案、人员类别、人员档案、地区分类、客户档案、供应商档案、存货分类、会计科目。支持导出的基本档案：部门档案、人员类别、人员档案、客商管理档案、会计科目。下面逐个说明各基本档案导入时的注意事项：公司目录： 发送方为集团。 导入后公司一律不建账，建账操作要登陆界面进行。 封存标志和封存时间的输入与否保持一致。自定义项档案： 不支持通过再次发送update。 所属自定义项（pk_defdoclist）字段需填写自定义项名称。 上级档案（pk_defdoc1）字段需根据导入内容修改交换规则定义的需要参照的基本档案，选择档案所属自定义项即可。部门档案： 发送方为公司。 部门封存标志和封存时间的输入与否保持一致。 发送U8部门档案后，在基础数据对照表界面调整导入的部门级次。人员档案： 发送方为公司。 满足集团设置的人员档案约束条件。地区分类： 发送U8地区分类后，如存在上下级关系，请登陆界面手工调整级次。客商档案：用友网络科技股份有限公司 可配置辅助信息将发送到集团的档案同时导入到公司。 客商属性（custtype）字段支持公司导入及集团导入分配给公司，但不支持导入后update。 发送U8客户和供应商档案时应根据导入客户还是供应商修改交换规则定义根标签和外系统定义的表标签为customer或vendor。如果导入到公司或集团分配给公司，系统可自动将客商属性置为客户或供应商。 发送U8客户或供应商档案时，地区分类可能为空，可在校验文件中增加地区分类（pk_areacl）字段的默认值。存货分类： 发送的存货分类编码级次必须和系统中定义编码级次完全一致。仓库档案： 发送方为公司。计量档案： 发送方为集团。 是否基本单位要与系统中是否存在所属量纲的基本单位保持一致。如果系统中已存在基本单位，导入的档案不能再为基本单位，如不存在基本单位，导入的档案必须为基本单位。 基本单位的换算率必为1。存货基本档案：（指只由基本档案文件组成的数据文件） 发送方为集团。 可配置辅助信息将发送到集团的档案同时导入到公司，单据类型选择invbas。 所属存货分类必须是末级分类。 是否辅计量管理和默认单位的输入与否保持一致。存货管理档案：（指由基本档案和管理档案文件组成的数据文件） 可配置辅助信息将发送到集团的档案同时导入到公司，单据类型选择bsinvbas。 所属存货分类必须是末级分类。 是否辅计量管理和默认单位的输入与否保持一致。 管理档案的单据头中要增加needproduce="N"语句。用友网络科技股份有限公司存货综合档案：（指由基本档案、管理档案和物料生产档案文件组成的数据文件） 发送方为公司。 可配置辅助信息将发送到公司的档案同时导入到库存组织，单据类型选择bsinvbas。 所属存货分类必须是末级分类。 是否辅计量管理和默认单位的输入与否保持一致。项目基本档案： 可配置辅助信息将发送到集团的档案同时导入到公司。 是否完工和完工日期的输入与否保持一致。会计科目： 集团支持按科目方案发送，公司支持按主体账簿发送。如果没有输入科目方案或主体账簿，则默认集团发送到基准科目方案，公司发送到主账簿。 末级标志（endflag）字段应与所导科目是否末级保持一致。 科目级次（subjlev）字段应与所导科目实际级次一致。 设置必输字段时必须保证和相应字段的勾选一致。Eg.要设置单价和数量必输必须保证该科目按数量核算。 输入多个辅助核算时，辅助核算的写法应符合规范，且辅助核算的个数最好不要超过9个。 受控系统的输入必须和界面可参照的内容一致。 集团科目类型需要根据科目方案翻译。 导入U8科目时，如有项目辅助核算，需在基础数据对照表中增加基础档案资源列表的对照，将U8系统的97、98、00等对应项目管理档案、现金流量项目及自定义项档案。用友网络科技股份有限公司
