数据交换平台的使用

业务插件处理错误 -5; 其他错误 -6;

另外NC220后传入凭证的返回值有专门的规定

2．7 文件发送的日志记录

每接收到单据后，外部交换平台会记录日志，该日志记录了收到单据的文档编号，该编号应该是应每张单据而不同的，在凭证中对应中的id号，文档类型记录单据的类型，对应ufinterface的billtype属性，目的一般就是“NC”，来源是发送方的IP地址或机器名，发生时间是指交换平台收到单据的时间，说明会包括接收结果记录和处理结果记录，一般正确收到一张单据后会产生两条记录，一条是接收结果记录，一条是处理结果记录，该如果结果记录是正确处理了，则会在一定的时间后被自动删掉，该参数控制是在webapps\\nc_web\%ufxx目录下的agentconfig.xml文件中，有两个参数控制日志会自动定时（隔A小时）整理，删除到某时间点（B时间点）以前的正确接收记录，但处理出错的记录会保留下来。

–参数： 1表示每隔1小时整理一次，最小时间单位是小时；

–参数：24表示保留12小时以内的正确接收的日志记录，超出这个时间的记录会被删除。最小时间单位是小时。 –参数：

3． 实施中应注意的问题：

下面是在实施的过程当中需要注意的问题，这些问题的理解有助于当发生问题时准确地定位问题的所在：

1． XML文件的中间表示：

符合标准的XML文档传入NC交换平台后，首先被翻译成一种中间表示方式，这种中间表示方式是NC可以识别的，中间表示方式必须先转换为与具体的单据相对应的VO才可能写入与单据对应的数据库表，该中间表示方式的数据文档 被存放在newcentury\\xxchange目录下，文件名为对应文件名加序列号。

2． 校验文件：

一个单据进入NC的前提首先是必须制定相应的XML业务文档传输标准，这个标准应由总体组和单据所属的产品组来共同制订，充分考虑类似哪些字段插入数据库时不能为空的情况（即哪些字段必须包含在XML的业务文档传输标准里），传输过来的文件应满足头和体校验文件的要求，例如不能为空的数据项就一定要有内容，要求是数字类型的数据项必须是数字。该校验文件在webapps\\nc_web\\下面，文件名形如headergl.xml和bodygl.xml，其中gl是相应的单据类型。

3． 改进的基础数据对照功能：

外部数据交换的正确实施，基础数据对照表的配置与维护是一个非常重要的部分，也是公共XML标准到NC中间表示正确翻译的基础，在配置的过程当中，基础数据使用了很多参照，而这些参照必须在有关的基础数据都已添加完毕或配置好的前提下才有数据显示，所以基础数对照表的配置需要先准备好基础数据然后再建立对照，对于外部系统导入的基础数据，如果该数据是和NC中的对应基础数据值相等，则可以利用自动建立对照功能完成。例如，外系统传入的制单人是“张三”，在NC中的制单人也是“张三”，则在建立操作员的基础数据对照时可以使用自动建立对照按钮自动按名称建立对照。在自动建立对照时可以选择按编码或名称建立对照，选择何种方式取决于外系统传入的基础数据是编码还是名称，例如客商档案的对照，如果传入的单据中使用的是客商档案的编码，并且该编码值等于NC中该客商的编码，就按编码自动建立对照，同理按名称建立对照亦然。在NC230中，增加了支持按照文件导入数据对照关系的功能，文件格式支持XML文件和txt文件，XML文件格式见前面“基础数据对应配置”部分的说明。文本文件的格式如下所示。导入数据时，可以指定按编码或按名称建立对照关系。

Code1,name1 Code2,name2 Code3,name3 …

4．

? 导入基础档案时，需要外系统给出基础数据主键，以存货档案为例，

0001C188888888888883 在20位长的主键中，前6位是与NC约定好的值，后14位是由外系统产生的。

? 一份外系统基础数据可以导入到NC多个公司账中，也可以只导入到NC

一个公司账中，这里导入时有两种基本档案分配到公司管理档案的模式，只要在“外系统注册登记”界面注册登记了，默认是多公司基本档案分配模式，该模式下基础数据的主键的前四位会在基本档案分配到公司管理档案时自动替换为对应公司的主键。如果在“外系统注册登记”界面注册登记时“外系统对应公司名称”列填写了保留字“onecorp”，则分配基本档案时采用单一公司分配模式，该模式下，NC原样采用外系统的基础数据主键值。如果是导入存货档案并且要分配到库存组织作为物料生产档案，则不需要使用辅助信息配置界面，只要完成了库存组织的对照设置就可以自动完成存货管理档案到库存组织的分配。

? NC230中，由于总账增加了三个与客商相关的辅助合算项（客商辅助合

算、供应商辅助合算和客户辅助核算），因此在导入客商档案时为了可以支持自动增加这三个辅助核算数据的对照关系，需要在导入的XML文件中指定属性 contrastitem=\客商辅助核算,供应商辅助核算,客户辅助核算,客商档案,供应商档案\，该属性放在ufinterface的后面。 关于外部交换平台导入基础档案的说明：

? 目前可以支持导入的基础数据包括存货档案、客商档案、人员档案和项目

档案 ?

4． 关于NC数据的导出：

NC数据的导出主要指外系统获得NC的相关数据，有两种实现方式：

1， 外系统向NC发送查询请求，NC收到查询请求后按条件查询出结果数据，然

后给外系统返回。该处理过程是在一个请求响应过程中完成的。数据导出由外系统的查询请求动作触发。目前对凭证的查询就是这种方式。

2， 由NC的业务驱动触发数据发送，例如：单据审核后，如果在流程平台中设置

了数据发送脚本，就可以实现单据发送。目前只是应收应付核销单支持该功能。

5． 关于数据交换代理平台：

数据交换代理平台NC服务器XML文件

目前的数据交换代理平台主要功能是抓取客户端本地的XML文件自动定时发送到NC应用服务器，该工具主要有两个配置文件sendurl.xml和runtimeclock.ini。sendurl.xml文件中记录发送单据类型和发送地址，例如：

runtimeclock.ini文件记录工具运行时间：

该工具可以有两种工作方式: 一种是整点定时工作方式，一种是间隔定时工作方式。

-- 整点定时方式是以24小时方式设定一天中的某一时刻（可以设定多个时刻，例如runclock=20:20,如果要使某一时刻失效，用'#'注释即可，注意这种方式下，必须注释掉runclock=99:99行，而且sleepminute应该设的小一些，不超过10为宜），该工具就会在该时刻到达时运行。

-- 间隔定时工组方式是按照sleepminute指定的时间间隔工作一次。注意这种方式下，必须有runclock=99:99行存在并且不能注释，sleepminute设置的时间可以稍大一些，例如30分钟。

主要参数：

sleepminute=10 表示发送线程运行间隔时间（单位：分钟） startrunnercount=3 表示启动几个发送线程服务并发完成文件发送任务，默认值1,如果启动多个发送线程服务，每个发送服务可对应一个接收系统的URL地址（一般是NC应用服务器的地址），该地址是在sendurl.xml文件中通过sysindex属性区分的.

runclock=99:99 标示整点定时运行方式和间隔定时运行方式 #runclock=9:00 定时运行方式下表示具体的运行时刻 #runclock=10:00 #runclock=12:00 #runclock=13:00

6． 关于U8总账与NC总账的无缝集成：

1， 从NC230以后外部交换平台可以支持U8总账与NC总账的无缝集成，在U8

中经过配置后可以在保存U8凭证的同时在NC中也增加一张相同的凭证。 2， 可以配置从U8传过来的凭证按照单据来源和凭证类别控制删除和修改的权

限 ，该配置通过外部数据交换平台外部系统注册登记界面的辅助信息配置界面完成：

3， 支持单据导出功能

7． 外部交换平台导入数据时常见问题说明：

1．

导入凭证的前期步骤和相关问题： ：：安装NC系统 ：：以集团身份登陆，设置集团主辅币，会计期间， ：：以集团身份增加公司目录，建公司帐，建立用户并给用户分配权限，