外部数据交换平台实施使用指南20040212修订

1、外部数据交换平台实施使用指南1 进入NC系统的外部数据1， 外部交换平台结构：功能特点：（1） 按照业务流程的顺序要求，业务数据从外系统流向NC系统时（或者从NC系统流向外系统时），可以通过外部交换平台支持这种数据的自动实时流动，实现异构系统间的无缝连接。（2） 基于NC中间件的监听服务，可随时接收外系统传来的数据，并实时处理完成后，即时返回结果回执，整个过程全部自动完成，无需人为干预。可以触发业务的自动实时处理。（3） 采用消息机制，外系统按照HTTP协议把规定格式的XML数据包（或XML文件形式）发送到NC服务器所在的URL地址，支持局域网和广域网传输，可穿越企业防火墙。（4） 灵活配置，

2、自由扩充。外部交换平台接到XML数据包以后根据配置做相应判断，然后由XML处理器翻译成NC业务模块可以接收的形式。支持自定义扩充单据，通过二次开发完成NC业务模块适配器实现。（5） 智能对照外系统与NC系统间基础数据的映射，大大降低了实施过程中的工作量，并在后期维护时提供了方便。智能对照支持NC基础数据自动导入，从外部文件导入以及大批量数据（例如存货数据）的后台自动导入。（6） 实时反馈处理结果，详细明确错误位置，业务模块处理完以后会以编码形式返回结果，正确是1，错误是其他编码，并有相应详细错误说明，便于确定错误原因。（7） 由外系统按照约定产生基础档案的主键，在传入的XML文件中可以直接写入

3、，无须在基础档案对照表中设置对照关系，降低实施工作量。（8） 外系统基础数据编码约定与NC编码一致，可以使用自动基础数据对照功能。如果外系统可以把基础数据按指定格式导出，可以支持文件导入基础数据对照功能。2， 数据文件示例虽然我们的系统支持从NC系统向外发布数据，但NC接收外部数据并作相应的处理是本系统设计的重点和实现的难点。把标准XML格式包装的相应单据数据转换为NC能够识别的数据并写入对应的数据库表，需要做很多复杂的处理，为了顺利完成这些处理事前必须进行一系列仔细的配置工作。外部数据XML文件示例（会计凭证）：<ufinterface roottag="voucher&qu

4、ot; billtype="gl" subtype="" replace="Y" sender='1101' proc="add" operation="req" isexchange="Y" filename="增加凭证ReqParam.xml" receiver='2000'> <voucher id="1234560102"><voucher_head><

5、;company>1001</company><voucher_type>付</voucher_type><fiscal_year>2002</fiscal_year><accounting_period>10</accounting_period><voucher_id>1</voucher_id><attachment_number>1</attachment_number><date>2002-08-18</date><e

6、nter>薛明</enter><cashier>UFSOFT</cashier><signature>N</signature><checker>demo</checker><posting_date></posting_date><posting_person></posting_person><voucher_making_system>GL</voucher_making_system></voucher_head>

7、<voucher_body><entry><entry_id>4</entry_id><account_code>40504</account_code><abstract>购买办公用品</abstract><settlement></settlement><document_id></document_id><document_date></document_date><currency></currency

8、><unit_price></unit_price><exchange_rate1></exchange_rate1><exchange_rate2>0</exchange_rate2><debit_quantity>0</debit_quantity><primary_debit_amount>0</primary_debit_amount><secondary_debit_amount></secondary_debit_amount><

9、;natural_debit_currency>0</natural_debit_currency><credit_quantity>0</credit_quantity><primary_credit_amount>0</primary_credit_amount><secondary_credit_amount></secondary_credit_amount><natural_credit_currency>300</natural_credit_currency><

10、aux_accounting><!- 辅助核算，一个item表示一种辅助核算-><item name="部门档案">车间一</item><item name="人员档案">zsd</item></aux_accounting></entry></voucher_body>XML文件属性头说明：1, roottag表示根结点标签，其值voucher应该与后面文档内容标签 <voucher id="1234560102"&

11、gt;中的voucher一致，其中id号唯一标示该voucher.该id号表示在外部交换平台接收外部数据时唯一标示一张单据，与单据体里的id号（例如凭证号）是两个概念，单据体里的id号是业务处理时使用的，这里的id号是接收单据时判断是否重复的。不能重复，可以是数字或字符，不能超过30位长。2, billtype表示传输文件的类型,如gl表示会计凭证,该类型以单据类型参照中数据为准，或者与voregister.xml文件中注册的类型为准。3, subtype表示billtype类型的子类型，如果没有子类型则不需要指定，值为空。，目前在传送基础档案时，subtype为invbas时表示存货基础档案

12、，为invman时表示存货管理档案，为invproduce时表示生产档案，为cubas时表示客商基础档案。4, replace=”Y”表示如果该文档已经正确的收到过并正确处理过时是否进行覆盖处理.5, isexchange表示文档解析时是否需要基础档案对照，值是”Y/N”，默认是Y.6, filename表示当前传送的文件名.7, sender表示外部系统的编号，该编号由接口双方约定，是四位长的一个编码，值可以是任意，例如1101，但一旦约定后就不能再随意更改，该编号应该与“外部系统与对应帐套设置”界面、“外部系统注册登记”界面和“基础数据对照表维护”界面中填写的外部系统编号一致。8, 凭证的

13、voucher_head和voucherbody部分的标签需要注意凭证头部分(head)的标签必须以head结尾，凭证体部分(body)的标签必须以body结尾，凭证的分录(entry)包括再凭证体(body)内，一个凭证体可以包括多个分录(entry)部分。9,proc 表示进行的操作，参数有 add(增加),query(查询),delete(删除),abandom(作废)，post（发送）,默认是add。10,operation 表示操作单据响应的方向，外系统传入单据是参数req表示请求操作，外部交换平台反馈信息是res表示应答操作。新增加的属性：11,autocontrast 在2003

14、-03-18 release 3.5 版本（NC220）以后增加了支持客商和存货基础数据自动对照的功能，如果aotucontrast=C，基础档案按编码自动在收到时增加对照关系，如果aotucontrast=M，基础档案按名称自动在收到时增加对照关系.12, receiver 表示接收单位编码或名称，在2003-03-18 release 3.5以后的版本中该属性可以省略或为空。13, isDebug 属性表示是否输出调试信息，等于“Y/N”，默认值是“N”，用于出错时帮助查询错误原因的用途。21 帐套的配置与外部系统的注册登记第一步，外系统与NC帐套对应关系的配置：NC是支持多数据源（帐套）

15、的系统，不同的外部系统传来的数据可能要求进入不同的数据源（帐套）。所以必须首先就外部系统与所属帐套进行配置。以下的界面负责这个任务的实施。外部系统与所属帐套配置完成，将在Webserver的根目录webappsnc_webufxx下形成一个文件regconfig.xml，它的一个示例如下，该示例只是方便大家理解概念，实际当中，请尽量不要手动编辑该文件。在NC开发环境中(VisualAge中)，该界面定义的数据源应该与D:ierpbinprop.xml文件中定义的数据源一致。<registerconfigs><xsystem account='ufsoft' a

16、ccountname=帐套1 datasource='design'>2201</xsystem><xsystem account='ufsoft' accountname=帐套1 datasource='design'>5555</xsystem></registerconfigs>界面使用方法：该界面中“系统编号”列表示外部系统的编号，应该是4位数字。“对应帐套”列表示NC的帐套。由于默认的帐套名可能与NC定义的帐套名不一样，注意在第一次进入该界面时要修改“对应帐套”列。注意做完了该界面的

17、修改后需要重起中间件修改才有效。第二步，外系统与对应公司帐和单据类型的配置：该步骤进行外部系统与NC对应公司帐和单据类型的注册和登记。实施该功能的界面如下：界面使用介绍：首先确定“对应帐套”下拉框是与外系统编号所对应的，“对应帐套”下拉框表示针对某一个帐套设置注册信息，表格中第一列的系统编号应该与第一个配置界面中的“系统编号”一致，如果一个外部系统编号的数据只需对应NC中一个公司的数据，“外系统对应公司名称”列可以任意输入，如果一个外系统编号的数据可能对应NC多个公司的数据，则该列的填写另有规则，这一点在稍后的部分会介绍。“NC对应公司主键”表示针对哪一个公司帐传送数据，“单据类型”表示传送的

18、单据类型，“是否启用”应该选是。辅助信息是针对某些类型(例如预算表，银行对帐单，会计凭证和物料生产档案等，该功能的使用需要另外提供辅助信息文件 ) 的单据增加一些辅助信息使用的。NC220以前，对于每一种传入的单据，要求一条记录里的外系统编号只对应NC一个公司，但对于传入的基础数据可以注册多条记录（单据类型设为bs），实现一个外系统的基础数据对应到NC多个公司的基础数据，在导入基础档案时实现基本档案自动分配为管理档案的操作。该界面提供了增加、修改和删除注册信息的功能。l 在NC220以后，外部交换平台的外部系统注册登记界面做了一些修改，第二列改为“外系统对应公司名称“，以前一个外系统编号应该是

19、对应一个NC的公司帐的，在该界面中也只能就某种单据类型设置一个外系统数据与NC某个公司账的对应关系，NC220以后可以在该界面中设置一个外系统对应多个NC公司帐的对应关系，确认为启用后有效，可以支持在一个XML文件中，一个外系统编号的数据可以对应到NC不同公司的数据。l 例如：如果外系统1101需要导入凭证（gl类型）到公司1001和1002，如上图界面中注册两条记录，对于一个外系统编号1101，“外系统对应公司名称”列分别填写了不同的两个外系统对应公司名“测试公司”和“测试公司二”。需要注意的是：l 对于一个XML文件内的每张凭证，在凭证头需要加入”corp”属性标示该凭证属于哪一个公司，如

20、：<voucher id="89991" corp="测试公司">，“corp”的内容应该与XML凭证文件里 外系统的公司名称以及上述界面中“外系统对应公司名称”列公司名一致。l 第二列“外系统对应公司名称”应该填写的内容需要与外系统导入的XML文件中外系统公司名称一致。关于辅助信息配置界面：辅助信息配置界面目前主要是导入银行对帐单、存货基础数据和会计凭证时会用到。l 导入银行对帐单时辅助信息配置界面示例：l 导入会计凭证如果需要根据凭证来源或凭证类别控制修改和删除权限时，需要使用辅助信息配置界面。该功能目前主要是应用于U8接入NC系统时的配

21、置。l 导入存货档案时如果需要分配公司下的物料生产档案到库存组织，也需要用到辅助信息配置界面。在基础数据的多公司分配模式下需要把存货管理档案分配到相应公司的库存组织时，需要使用辅助信息配置界面配置每个公司对应的库存组织。22 基础数据对照关系的配置NC中的基础档案数据，如客商档案、存货档案、人员档案等等，在引用时都是用NC自己定义的20位长主键来标识的。当一个外部业务单据传来时，需要对应到NC系统相应的业务单据，如果其中包含有基础档案数据（例如：人员信息、部门信息等），这些基础数据也应该对应到NC系统相应的基础数据。由于NC业务单据中所用到的基础数据是通过20位长的主键引用的，因此需要把外系统

22、业务单据中所使用的基础数据转换为与NC中对应的基础数据的主键值。基础数据对照关系的配置界面来完成这个功能。 如果传入的xml文件中有基础档案并且需要进行主键转换（在凭证中还需要包括会计凭证中的辅助核算项目），则需要在基础档案对照设置界面定义基础档案对应关系。左边两列是外部系统的基础数据，右边两列是NC中的基础数据。对于会计凭证的导入，凭证头部分中<company>标签、<voucher_type>标签、<enter>标签的内容和凭证体部分中的<account_code>标签和<currency>标签不能为空，其中<currenc

23、y>的内容是币种，即使NC设置了默认币种为人民币并且外系统使用的币种也是人民币，此处仍需要指定对应关系。如果凭证的科目使用了辅助核算，也需要指定与基础数据的对应关系。其界面如下： 第三步，基础数据对应配置：1， 要设置某一个公司的基础数据对照关系，首先要以该公司登录进去。2， 首先填写外部系统编号，此处的外系统编号应该与前面的两个配置界面中的外系统编号一致。3， 确定基础数据分类，例如，设置会计科目的对应关系，增加一行对应关系，设置外系统的会计科目编号是217102，对应NC的会计科目是“现金”，然后保存。4， 导入方式：分手工添加对照关系、自动建立对照关系和外部文件导入加载方式。a)

24、手工添加方式：手工添加一条外系统与NC基础数据的对照关系记录，外部数据应该是导入单据中会出现的数据。适用于对照关系不多，外系统基础数据与NC对应基础数据编码不一致的情况。b) 自动建立对照关系：对于数据对应关系设置工作量比较大的基础数据（例如会计科目），并且外系统导入的单据中使用的基础数据与NC对应基础数据编码或名称一致的情况，提供了自动建立对照关系的功能，这里建立对照关系的依据是假设外系统的基础数据值（编码或名称）与NC的数据值（编码或名称）相同的前提。c) 外部文件导入加载方式：文件格式支持XML格式和TXT格式，XML格式：由外系统提供下面示例XML格式的文件，然后先在该界面中指定基础数

25、据类别后，再导入指定路径下外系统提供的XML文件，导入时按照编码或者名称相同原则建立对照关系，即如果外系统的XML文件中有编码（名称）为001的数据，并且NC中也有编码（名称）为001的数据，则按照编码（名称）001自动建立对照关系；如果外系统的XML文件中有编码（名称）为001的数据，但NC中没有编码（名称）为001的数据，则按照编码（名称）001建立一条不完整的对照关系，外系统有数据，NC端没有对应数据，用户可以通过修改的方式指定NC的对应数据。TXT格式：导入规则与XML格式类似。XML格式：<?xml version='1.0' encoding='gb2

26、312'?><!- 供应商档案 编码和名称是必须有的，其余数据项可以省略，大小写必须和下面的相符-><ufinterface roottag='vendor' billtype='' docid='' receiver='' sender='' proc='' codeexchanged='' exportneedexch='' version='2.0'><vendor id=''>&

27、lt;code>A0001</code><name>vendorA01</name></vendor><vendor id=''><code>ven001</code><name>vendorname1</name></vendor></ufinterface>TXT格式：Code1,name1Code2,name2Code3,name323 XML校验文件当外部数据发往NC时，它的数据是以公共标准XML（见XML传输标准）包装的，它的数据的

28、合理性由校验文件中定义的规则来校验，同时公共标准中XML的tag与NC中间表示的tag之间的对应关系也在校验文件中定义，该tag包含数据所属的基础档案的类型（如果有的话）也在校验文件中定义。如果单据类型是头（主）、体（子）结构的，必须分别设置头、体的校验文件，头校验文件的命名规则是：“header单据类型.xml”；体校验文件的命名规则是：“body单据类型.xml”；如果不是头体结构的，只需设置头校验文件。与上面的几个配置文件一样，校验文件必须放置在Webserver的根目录webappsnc_webufxx目录下。销售单据的头和体校验文件如下所示（注意文件名的命名，因为销售订单的单据类型是

29、30）：头检验文件header30.xml<订单头><单据号 datatype='String' nullallowed='no' maxLength='30' matchtag='vreceiptcode'/><公司编码 datatype='String' nullallowed='no' maxLength='20' matchtag='pk_corp' basicdoc=公司目录/><单据类型 datatype='

30、;String' nullallowed='no' maxLength='2' matchtag='creceipttype'/><单据日期 datatype='UFDate' nullallowed='no' maxLength='10' matchtag='dbilldate'/><客户 datatype='String' nullallowed='no' maxLength='20' matchta

31、g='ccustomerid' basicdoc='客户档案'/><收款协议 datatype='String' nullallowed='yes' maxLength='20' matchtag='ctermprotocolid'/><收货地址 datatype='String' nullallowed='yes' maxLength='100' matchtag='vreceiveaddress'/>&

32、lt;收货单位 datatype='String' nullallowed='yes' maxLength='100' matchtag='creceiptcustomerid'/><收票单位 datatype='String' nullallowed='yes' maxLength='20' matchtag='creceiptcorpid'/><运输方式 datatype='String' nullallowed='

33、yes' maxLength='20' matchtag='cdeptid'/><自由项 datatype='String' nullallowed='yes' maxLength='20' matchtag='vdef1'/><备注 datatype='String' nullallowed='yes' maxLength='100' matchtag='vnote'/><状态 dataty

34、pe='Integer' nullallowed='yes' maxLength='1' matchtag='fstatus'/></订单头>体校验文件body30.xml<订单体 id=""><编码 datatype='String' nullallowed='no' maxLength='20' matchtag='corder_bid'/><名称 datatype='String'

35、; nullallowed='no' maxLength='20' matchtag='cinventoryid'/><单位 datatype='String' nullallowed='no' maxLength='20' matchtag='cunitid'/><数量 datatype='UFDouble' nullallowed='no' maxLength='16' matchtag='nnumb

36、er'/><税率 datatype='UFDouble' nullallowed='no' maxLength='7' matchtag='ntaxrate'/><单价 datatype='UFDouble' nullallowed='no' maxLength='16' matchtag='noriginalcurtaxprice'/><金额 datatype='UFDouble' nullallowed=

37、'no' maxLength='16' matchtag='noriginalcurnetprice'/><原币 datatype='String' nullallowed='no' maxLength='20' matchtag='ccurrencytypeid'/><税额 datatype='UFDouble' nullallowed='yes' maxLength='16' matchtag='no

38、riginalcurtaxmny'/><交货日期 datatype='UFDate' nullallowed='no' maxLength='10' matchtag='ddeliverdate'/><存货档案 datatype='String' nullallowed='no' maxLength='20' matchtag='cinvbasdocid'/><包装单位 datatype='String' n

39、ullallowed='no' maxLength='20' matchtag='cpackunitid'/><包装数量 datatype='UFDouble' nullallowed='no' maxLength='16' matchtag='npacknumber'/><批号 datatype='String' nullallowed='no' maxLength='20' matchtag='cba

40、tchid'/><行备注 datatype='String' nullallowed='no' maxLength='100' matchtag='frownote'/></订单体>请注意“公司编码”和“客户”数据项的配置，除和其他一些数据项一样的属性信息以外，还包括basicdoc属性，它的意义是与上面的基础数据对照关系设置相配合的，当翻译模块读到该数据项时，它会访问2.2配置好的基础数据对照表，按照配置将该数据项包含的值翻译成配置好的对应的值。校验文件是放在webappsnc_webufx

41、x目录下，一般不需要实施人员修改。24 传输单据的对应处理VO的注册在得到所传输单据的中间表示以后，该单据进入NC数据库的方式有两条可能的线索，一是调用NC的流程平台提供的接口函数，但前提条件是流程平台必须支持该单据；对于流程平台不支持的单据，典型的如“财务凭证”，则必须在文件voregister.xml中注册这种的单据的vo，并把该文件同样放置在Webserver的根目录webappsnc_webufxx目录下，目前由于单据走流程平台缺乏灵活性，每一种业务单据的处理都有不同的要求，因此目前处理单据主要是通过注册voregister.xml文件提供的业务接口插件实现，这种方式实现灵活，扩充性强

42、，与系统其它部分相互影响小。Voregister.xml文件的一个示例如下：<voregister><vo type='gl' name='财务凭证' proc='add' operation='req' voclasstype='C' voclass='nc.bs.gl.pfxx.XMLVoucherProcess'/><vo type='gl' name='财务凭证' proc='query' operation=&#

43、39;req' voclasstype='Q' voclass='nc.bs.gl.pfxx.XMLQueryVoucher'/><vo type='TB' name='执行情况' proc='add' operation='req' voclasstype='A' voclass='nc.bs.tb.xml2vo.ImportDataBO'/><vo type='bc' name='银行对帐' proc

44、='add' operation='req' voclasstype='A' voclass='nc.bs.gl.contrastpub.XMLBankContrastProcess'/></voregister>voclasstype 的可选值包括：A、C、B、QA：表示有辅助配置信息的接口C：普通业务接口，默认接口类型值B：有文件属性头和返回值的接口，主要用于基础数据Q：单据查询业务接口目前新版本的外部交换平台支持传送的文档包括：NC230可以支持的单据类型清单列表：会计凭证、支持凭证的增加、修改和删除等操作

45、应收单，应付单，收款单，付款单，收款结算单，付款结算单，划帐结算单，对外收款结算单，对外付款结算单等NC的应收应付系统可以支持的收付单据存货核算所支持的各种出库入库单、供应链库存系统所支持的出库入库单、银行对帐单、固定资产增加卡片，固定资产减少卡片，固定资产变更卡片，凭证查询单，各种基础数据，主要包括存货基础档案、客商基础档案、项目档案、人员档案和BOM档案。供应链采购订单、采购发票、销售订单、销售发票。生产订单调拨订单等2 5 手动或自动传输加载外部数据外部交换平台可以支持手动加载外部数据，或直接将外部数据通过http传输到平台的方式。外部系统接入NC时有两种方案方案一：从外部系统登陆NC外

46、部交换平台的手动加载界面，在指定的目录下选定文件后，按按钮导入。方案二：外部系统开发一个遵循HTTP协议能够向NC外部交换平台发送文件的发送器，按照指定地址实时发送。1，手动方式是指xml打包好的外部数据可以通过email或文件共享传到本地的某客户机的目录下，然后通过以下两个界面加载外部数据。加载时，新版本的加载界面兼容了以前的加载方式，可以使用C:url.xml地址文件的方式，也可以在界面中直接指定URL地址，如果C:url.xml文件和界面指定都存在，以界面指定为准。该界面指定一个包含XML文件的目录，然后在前一个界面中显示出该目录下的所有XML文件。2， 外部系统也可以直接通过自己的程序

47、直接将外部数据的XML文件通过HTTP的POST方法传输到交换平台，其URL地址一般为（特殊配置的情况除外）http:/webserver地址/servlet/nc.bs.pfxx.manualload.ServletForXchange。外部交换平台支持外系统自动的，顺序的，实时的，传输多个XML文件，并可以选择是否进行重复检查（设置ufinterface属性后replace=”N”），传输可由外系统触发。3， 在NC230以后，增加了一个代理平台，可以自动抓取某一个目录下的XML文件按照配置发送到NC服务器端。可以定时运行或者按一定的时间间隔运行。4，26 文件发送回执问题：1， 外系统在

48、向NC的外部交换平台发送了文档后会实时收到回执信息，接收该回执不需要另外指定URL地址，在Web服务的响应对象中会包含回执信息。如果是采用手工加载界面发送，返回的回执信息会在当前目录下产生一个backMessage.xml的文件。2， backMessage.xml回执示例：<?xml version="1.0" encoding="gb2312"?><ufinterface roottag="voucher" billtype="gl" subtype="" replace=

49、"N" sender="1101" proc="add" operation="res" isexchange="Y" filename="交易结果backMessage.xml" receiver="2000"><sendresult><!-单据主键- ><billpk></billpk><!-文档编号-><bdocid>123456789</bdocid><

50、!-发送文件名-><filename>存货综合档案new.xml</filename><!-传输返回值-><resultcode>1</resultcode><!-发送结果描述-><resultdescription>文档应收应付.xml正确收到，进入业务插件！应收应付.xml文档已被正确处理</resultdescription><content></content></sendresult></ufinterface>XML文件传输返回值re

51、sultcode标识含义:传输成功 1;文档重复 -1;发生未知错误 -2;文档属性错误或标签对照错误 -3;文档翻译错误 -4;业务插件处理错误 -5;其他错误 -6;另外NC220后传入凭证的返回值有专门的规定27 文件发送的日志记录每接收到单据后，外部交换平台会记录日志，该日志记录了收到单据的文档编号，该编号应该是应每张单据而不同的，在凭证中对应<voucher id=”12345676789”>中的id号，文档类型记录单据的类型，对应ufinterface的billtype属性，目的一般就是“NC”，来源是发送方的IP地址或机器名，发生时间是指交换平台收到单据的时间，说明会

52、包括接收结果记录和处理结果记录，一般正确收到一张单据后会产生两条记录，一条是接收结果记录，一条是处理结果记录，该如果结果记录是正确处理了，则会在一定的时间后被自动删掉，该参数控制是在webappsnc_webufxx目录下的agentconfig.xml文件中，有两个参数控制日志会自动定时（隔A小时）整理，删除到某时间点（B时间点）以前的正确接收记录，但处理出错的记录会保留下来。参数： <xlogManageInterval unit=“hour”>1</xlogManageInterval>表示每隔1小时整理一次，最小时间单位是小时；参数：<logRetainI

53、nterval unit=“hour”>24</logRetainInterval>表示保留12小时以内的正确接收的日志记录，超出这个时间的记录会被删除。最小时间单位是小时。参数：<xxchangefileholdtime unit="hour">48</xxchangefileholdtime>表示保留多少小时以内的NC安装目录xxchange目录下的翻译后的XML文件。如果该参数值为0，则不进行XML原文件的翻译。3 实施中应注意的问题：下面是在实施的过程当中需要注意的问题，这些问题的理解有助于当发生问题时准确地定位问题的所在：

54、1 XML文件的中间表示：符合标准的XML文档传入NC交换平台后，首先被翻译成一种中间表示方式，这种中间表示方式是NC可以识别的，中间表示方式必须先转换为与具体的单据相对应的VO才可能写入与单据对应的数据库表，该中间表示方式的数据文档 被存放在newcenturyxxchange目录下，文件名为对应文件名加序列号。2 校验文件：一个单据进入NC的前提首先是必须制定相应的XML业务文档传输标准，这个标准应由总体组和单据所属的产品组来共同制订，充分考虑类似哪些字段插入数据库时不能为空的情况（即哪些字段必须包含在XML的业务文档传输标准里），传输过来的文件应满足头和体校验文件的要求，例如不能为空的数

55、据项就一定要有内容，要求是数字类型的数据项必须是数字。该校验文件在webappsnc_web下面，文件名形如headergl.xml和bodygl.xml，其中gl是相应的单据类型。3 改进的基础数据对照功能：外部数据交换的正确实施，基础数据对照表的配置与维护是一个非常重要的部分，也是公共XML标准到NC中间表示正确翻译的基础，在配置的过程当中，基础数据使用了很多参照，而这些参照必须在有关的基础数据都已添加完毕或配置好的前提下才有数据显示，所以基础数对照表的配置需要先准备好基础数据然后再建立对照，对于外部系统导入的基础数据，如果该数据是和NC中的对应基础数据值相等，则可以利用自动建立对照功能完

56、成。例如，外系统传入的制单人是“张三”，在NC中的制单人也是“张三”，则在建立操作员的基础数据对照时可以使用自动建立对照按钮自动按名称建立对照。在自动建立对照时可以选择按编码或名称建立对照，选择何种方式取决于外系统传入的基础数据是编码还是名称，例如客商档案的对照，如果传入的单据中使用的是客商档案的编码，并且该编码值等于NC中该客商的编码，就按编码自动建立对照，同理按名称建立对照亦然。在NC230中，增加了支持按照文件导入数据对照关系的功能，文件格式支持XML文件和txt文件，XML文件格式见前面“基础数据对应配置”部分的说明。文本文件的格式如下所示。导入数据时，可以指定按编码或按名称建立对照关

57、系。Code1,name1Code2,name2Code3,name34 关于外部交换平台导入基础档案的说明：l 导入基础档案时，需要外系统给出基础数据主键，以存货档案为例，<pk_invbasdoc>0001C188888888888883</pk_invbasdoc> 在20位长的主键中，前6位是与NC约定好的值，后14位是由外系统产生的。l 一份外系统基础数据可以导入到NC多个公司账中，也可以只导入到NC一个公司账中，这里导入时有两种基本档案分配到公司管理档案的模式，只要在“外系统注册登记”界面注册登记了，默认是多公司基本档案分配模式，该模式下基础数据的主键的前四

58、位会在基本档案分配到公司管理档案时自动替换为对应公司的主键。如果在“外系统注册登记”界面注册登记时“外系统对应公司名称”列填写了保留字“onecorp”，则分配基本档案时采用单一公司分配模式，该模式下，NC原样采用外系统的基础数据主键值。如果是导入存货档案并且要分配到库存组织作为物料生产档案，则不需要使用辅助信息配置界面，只要完成了库存组织的对照设置就可以自动完成存货管理档案到库存组织的分配。l NC230中，由于总账增加了三个与客商相关的辅助合算项（客商辅助合算、供应商辅助合算和客户辅助核算），因此在导入客商档案时为了可以支持自动增加这三个辅助核算数据的对照关系，需要在导入的XML文件中指定

59、属性 contrastitem="客商辅助核算,供应商辅助核算,客户辅助核算,客商档案,供应商档案"，该属性放在ufinterface的后面。l 目前可以支持导入的基础数据包括存货档案、客商档案、人员档案和项目档案l4 关于NC数据的导出：NC数据的导出主要指外系统获得NC的相关数据，有两种实现方式：1， 外系统向NC发送查询请求，NC收到查询请求后按条件查询出结果数据，然后给外系统返回。该处理过程是在一个请求响应过程中完成的。数据导出由外系统的查询请求动作触发。目前对凭证的查询就是这种方式。2， 由NC的业务驱动触发数据发送，例如：单据审核后，如果在流程平台中设置了数据发

60、送脚本，就可以实现单据发送。目前只是应收应付核销单支持该功能。5 关于数据交换代理平台：目前的数据交换代理平台主要功能是抓取客户端本地的XML文件自动定时发送到NC应用服务器，该工具主要有两个配置文件sendurl.xml和runtimeclock.ini。sendurl.xml文件中记录发送单据类型和发送地址，例如：<url roottag="voucher" billtype="bs" billname="基础数据" subbilltype="" corp="1001" sysno=&

61、quot;1101" sysindex="1" proc="post" isexchange="Y" operation="res" urladdress="http:/cxy:8083/servlet/nc.bs.pfxx.manualload.ServletForXchange" />说明：<!- roottag:默认写voucher（不能省略）,billtype：单据类型（不能省略），billname：单据名称，subbilltype:单据子类型，corp：对应公司，

62、sysno：外系统编号（不能省略），sysindex：多线程序号（默认1），isexchange：是否转换（默认Y），operation：响应方式（默认res）,urladdress：发送地址（不能省略） ->runtimeclock.ini文件记录工具运行时间：该工具可以有两种工作方式: 一种是整点定时工作方式，一种是间隔定时工作方式。- 整点定时方式是以24小时方式设定一天中的某一时刻（可以设定多个时刻，例如runclock=20:20,如果要使某一时刻失效，用'#'注释即可，注意这种方式下，必须注释掉runclock=99:99行，而且sleepminute应该设的

63、小一些，不超过10为宜），该工具就会在该时刻到达时运行。- 间隔定时工组方式是按照sleepminute指定的时间间隔工作一次。注意这种方式下，必须有runclock=99:99行存在并且不能注释，sleepminute设置的时间可以稍大一些，例如30分钟。主要参数：sleepminute=10表示发送线程运行间隔时间（单位：分钟）startrunnercount=3表示启动几个发送线程服务并发完成文件发送任务，默认值1,如果启动多个发送线程服务，每个发送服务可对应一个接收系统的URL地址（一般是NC应用服务器的地址），该地址是在sendurl.xml文件中通过sysindex属性区分的.ru

64、nclock=99:99标示整点定时运行方式和间隔定时运行方式#runclock=9:00定时运行方式下表示具体的运行时刻#runclock=10:00#runclock=12:00#runclock=13:006 关于U8总账与NC总账的无缝集成：1， 从NC230以后外部交换平台可以支持U8总账与NC总账的无缝集成，在U8中经过配置后可以在保存U8凭证的同时在NC中也增加一张相同的凭证。2， 可以配置从U8传过来的凭证按照单据来源和凭证类别控制删除和修改的权限 ，该配置通过外部数据交换平台外部系统注册登记界面的辅助信息配置界面完成：3， 支持单据导出功能7 外部交换平台导入数据时常见问题说

65、明：1 导入凭证的前期步骤和相关问题：安装NC系统：以集团身份登陆，设置集团主辅币，会计期间，：以集团身份增加公司目录，建公司帐，建立用户并给用户分配权限，：以集团身份给公司分配会计科目（基础档案>财务会计信息>会计科目）：以公司身份登陆，设置公司本位币，然后定义会计凭证类别（基础档案>财务会计信息>凭证类别）：在外部交换平台的“外部系统与对应帐套设置”界面中设置外部系统编号与NC帐套的对应关系：在“外部系统注册登记”界面中设置外部系统与NC中某一个公司的对应关系以及采用的单据类型，凭证应该是gl，并选中“是否启用”；：以要导入的对应公司登录，在“基础数据对照表维护”界面中设置该外部系统的基础数据与NC