数据交换平台的使用.docx
《数据交换平台的使用.docx》由会员分享，可在线阅读，更多相关《数据交换平台的使用.docx（35页珍藏版）》请在冰豆网上搜索。
数据交换平台的使用
外部数据交换平台实施使用指南
张时栋02/12/2004修订
1．进入NC系统的外部数据
1，外部交换平台结构：
功能特点：
（1）按照业务流程的顺序要求，业务数据从外系统流向NC系统时（或者从NC系统流向外系统时），可以通过外部交换平台支持这种数据的自动实时流动，实现异构系统间的无缝连接。
（2）基于NC中间件的监听服务，可随时接收外系统传来的数据，并实时处理完成后，即时返回结果回执，整个过程全部自动完成，无需人为干预。
可以触发业务的自动实时处理。
（3）采用消息机制，外系统按照HTTP协议把规定格式的XML数据包（或XML文件形式）发送到NC服务器所在的URL地址，支持局域网和广域网传输，可穿越企业防火墙。
（4）灵活配置，自由扩充。
外部交换平台接到XML数据包以后根据配置做相应判断，然后由XML处理器翻译成NC业务模块可以接收的形式。
支持自定义扩充单据，通过二次开发完成NC业务模块适配器实现。
（5）智能对照外系统与NC系统间基础数据的映射，大大降低了实施过程中的工作量，并在后期维护时提供了方便。
智能对照支持NC基础数据自动导入，从外部文件导入以及大批量数据（例如存货数据）的后台自动导入。
（6）实时反馈处理结果，详细明确错误位置，业务模块处理完以后会以编码形式返回结果，正确是1，错误是其他编码，并有相应详细错误说明，便于确定错误原因。
（7）由外系统按照约定产生基础档案的主键，在传入的XML文件中可以直接写入，无须在基础档案对照表中设置对照关系，降低实施工作量。
（8）外系统基础数据编码约定与NC编码一致，可以使用自动基础数据对照功能。
如果外系统可以把基础数据按指定格式导出，可以支持文件导入基础数据对照功能。
2，数据文件示例
虽然我们的系统支持从NC系统向外发布数据，但NC接收外部数据并作相应的处理是本系统设计的重点和实现的难点。
把标准XML格式包装的相应单据数据转换为NC能够识别的数据并写入对应的数据库表，需要做很多复杂的处理，为了顺利完成这些处理事前必须进行一系列仔细的配置工作。
外部数据XML文件示例（会计凭证）：
1001
付
2002
10
1
1
2002-08-18
薛明
UFSOFT
N
demo
GL
4
40504
购买办公用品
0
0
0
0
0
0
300
--辅助核算，一个item表示一种辅助核算-->
车间一
zsd
XML文件属性头说明：
1,roottag表示根结点标签，其值voucher应该与后面文档内容标签 中的voucher一致，其中id号唯一标示该voucher.该id号表示在外部交换平台接收外部数据时唯一标示一张单据，与单据体里的id号（例如凭证号）是两个概念，单据体里的id号是业务处理时使用的，这里的id号是接收单据时判断是否重复的。
不能重复，可以是数字或字符，不能超过30位长。
2,billtype表示传输文件的类型,如gl表示会计凭证,该类型以单据类型参照中数据为准，或者与voregister.xml文件中注册的类型为准。
3,subtype表示billtype类型的子类型，如果没有子类型则不需要指定，值为空。
，目前在传送基础档案时，subtype为invbas时表示存货基础档案，为invman时表示存货管理档案，为invproduce时表示生产档案，为cubas时表示客商基础档案。
4,replace=”Y”表示如果该文档已经正确的收到过并正确处理过时是否进行覆盖处理.
5,isexchange表示文档解析时是否需要基础档案对照，值是”Y/N”，默认是Y.
6,filename表示当前传送的文件名.
7,sender表示外部系统的编号，该编号由接口双方约定，是四位长的一个编码，值可以是任意，例如1101，但一旦约定后就不能再随意更改，该编号应该与“外部系统与对应帐套设置”界面、“外部系统注册登记”界面和“基础数据对照表维护”界面中填写的外部系统编号一致。
8,凭证的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-03-18release3.5版本（NC220）以后增加了支持客商和存货基础数据自动对照的功能，如果aotucontrast=’C’，基础档案按编码自动在收到时增加对照关系，如果aotucontrast=’M’，基础档案按名称自动在收到时增加对照关系.
12,receiver表示接收单位编码或名称，在2003-03-18release3.5以后的版本中该属性可以省略或为空。
13,isDebug属性表示是否输出调试信息，等于“Y/N”，默认值是“N”，用于出错时帮助查询错误原因的用途。
2．1帐套的配置与外部系统的注册登记
第一步，外系统与NC帐套对应关系的配置：
NC是支持多数据源（帐套）的系统，不同的外部系统传来的数据可能要求进入不同的数据源（帐套）。
所以必须首先就外部系统与所属帐套进行配置。
以下的界面负责这个任务的实施。
外部系统与所属帐套配置完成，将在Webserver的根目录\webapps\nc_web\ufxx下形成一个文件regconfig.xml，它的一个示例如下，该示例只是方便大家理解概念，实际当中，请尽量不要手动编辑该文件。
在NC开发环境中（VisualAge中），该界面定义的数据源应该与D:
\ierp\bin\prop.xml文件中定义的数据源一致。
2201
5555
界面使用方法：
该界面中“系统编号”列表示外部系统的编号，应该是4位数字。
“对应帐套”列表示NC的帐套。
由于默认的帐套名可能与NC定义的帐套名不一样，注意在第一次进入该界面时要修改“对应帐套”列。
注意做完了该界面的修改后需要重起中间件修改才有效。
第二步，外系统与对应公司帐和单据类型的配置：
该步骤进行外部系统与NC对应公司帐和单据类型的注册和登记。
实施该功能的界面如下：
界面使用介绍：
首先确定“对应帐套”下拉框是与外系统编号所对应的，“对应帐套”下拉框表示针对某一个帐套设置注册信息，表格中第一列的系统编号应该与第一个配置界面中的“系统编号”一致，如果一个外部系统编号的数据只需对应NC中一个公司的数据，“外系统对应公司名称”列可以任意输入，如果一个外系统编号的数据可能对应NC多个公司的数据，则该列的填写另有规则，这一点在稍后的部分会介绍。
“NC对应公司主键”表示针对哪一个公司帐传送数据，“单据类型”表示传送的单据类型，“是否启用”应该选是。
辅助信息是针对某些类型（例如预算表，银行对帐单，会计凭证和物料生产档案等，该功能的使用需要另外提供辅助信息文件）的单据增加一些辅助信息使用的。
NC220以前，对于每一种传入的单据，要求一条记录里的外系统编号只对应NC一个公司，但对于传入的基础数据可以注册多条记录（单据类型设为bs），实现一个外系统的基础数据对应到NC多个公司的基础数据，在导入基础档案时实现基本档案自动分配为管理档案的操作。
该界面提供了增加、修改和删除注册信息的功能。
●在NC220以后，外部交换平台的外部系统注册登记界面做了一些修改，第二列改为“外系统对应公司名称“，以前一个外系统编号应该是对应一个NC的公司帐的，在该界面中也只能就某种单据类型设置一个外系统数据与NC某个公司账的对应关系，NC220以后可以在该界面中设置一个外系统对应多个NC公司帐的对应关系，确认为启用后有效，可以支持在一个XML文件中，一个外系统编号的数据可以对应到NC不同公司的数据。
●例如：
如果外系统1101需要导入凭证（gl类型）到公司1001和1002，如上图界面中注册两条记录，对于一个外系统编号1101，“外系统对应公司名称”列分别填写了不同的两个外系统对应公司名“测试公司”和“测试公司二”。
需要注意的是：
●对于一个XML文件内的每张凭证，在凭证头需要加入”corp”属性标示该凭证属于哪一个公司，如：
，“corp”的内容应该与XML凭证文件里外系统的公司名称以及上述界面中“外系统对应公司名称”列公司名一致。
●第二列“外系统对应公司名称”应该填写的内容需要与外系统导入的XML文件中外系统公司名称一致。
关于辅助信息配置界面：
辅助信息配置界面目前主要是导入银行对帐单、存货基础数据和会计凭证时会用到。
●导入银行对帐单时辅助信息配置界面示例：
●导入会计凭证如果需要根据凭证来源或凭证类别控制修改和删除权限时，需要使用辅助信息配置界面。
该功能目前主要是应用于U8接入NC系统时的配置。
●导入存货档案时如果需要分配公司下的物料生产档案到库存组织，也需要用到辅助信息配置界面。
在基础数据的多公司分配模式下需要把存货管理档案分配到相应公司的库存组织时，需要使用辅助信息配置界面配置每个公司对应的库存组织。
2．2基础数据对照关系的配置
NC中的基础档案数据，如客商档案、存货档案、人员档案等等，在引用时都是用NC自己定义的20位长主键来标识的。
当一个外部业务单据传来时，需要对应到NC系统相应的业务单据，如果其中包含有基础档案数据（例如：
人员信息、部门信息等），这些基础数据也应该对应到NC系统相应的基础数据。
由于NC业务单据中所用到的基础数据是通过20位长的主键引用的，因此需要把外系统业务单据中所使用的基础数据转换为与NC中对应的基础数据的主键值。
基础数据对照关系的配置界面来完成这个功能。
如果传入的xml文件中有基础档案并且需要进行主键转换（在凭证中还需要包括会计凭证中的辅助核算项目），则需要在基础档案对照设置界面定义基础档案对应关系。
左边两列是外部系统的基础数据，右边两列是NC中的基础数据。
对于会计凭证的导入，凭证头部分中标签、标签、标签的内容和凭证体部分中的标签和标签不能为空，其中的内容是币种，即使NC设置了默认币种为人民币并且外系统使用的币种也是人民币，此处仍需要指定对应关系。
如果凭证的科目使用了辅助核算，也需要指定与基础数据的对应关系。
其界面如下：
第三步，基础数据对应配置：
1，要设置某一个公司的基础数据对照关系，首先要以该公司登录进去。
2，首先填写外部系统编号，此处的外系统编号应该与前面的两个配置界面中的外系统编号一致。
3，确定基础数据分类，例如，设置会计科目的对应关系，增加一行对应关系，设置外系统的会计科目编号是217102，对应NC的会计科目是“现金”，然后保存。
4，导入方式：
分手工添加对照关系、自动建立对照关系和外部文件导入加载方式。
a）手工添加方式：
手工添加一条外系统与NC基础数据的对照关系记录，外部数据应该是导入单据中会出现的数据。
适用于对照关系不多，外系统基础数据与NC对应基础数据编码不一致的情况。
b）自动建立对照关系：
对于数据对应关系设置工作量比较大的基础数据（例如会计科目），并且外系统导入的单据中使用的基础数据与NC对应基础数据编码或名称一致的情况，提供了自动建立对照关系的功能，这里建立对照关系的依据是假设外系统的基础数据值（编码或名称）与NC的数据值（编码或名称）相同的前提。
c）外部文件导入加载方式：
文件格式支持XML格式和TXT格式，XML格式：
由外系统提供下面示例XML格式的文件，然后先在该界面中指定基础数据类别后，再导入指定路径下外系统提供的XML文件，导入时按照编码或者名称相同原则建立对照关系，即如果外系统的XML文件中有编码（名称）为001的数据，并且NC中也有编码（名称）为001的数据，则按照编码（名称）001自动建立对照关系；如果外系统的XML文件中有编码（名称）为001的数据，但NC中没有编码（名称）为001的数据，则按照编码（名称）001建立一条不完整的对照关系，外系统有数据，NC端没有对应数据，用户可以通过修改的方式指定NC的对应数据。
TXT格式：
导入规则与XML格式类似。
XML格式：
xmlversion='1.0'encoding='gb2312'?
>
--供应商档案编码和名称是必须有的，其余数据项可以省略，大小写必须和下面的相符-->
A0001
vendorA01
ven001
vendorname1
TXT格式：
Code1,name1
Code2,name2
Code3,name3
2．3XML校验文件
当外部数据发往NC时，它的数据是以公共标准XML（见XML传输标准）包装的，它的数据的合理性由校验文件中定义的规则来校验，同时公共标准中XML的tag与NC中间表示的tag之间的对应关系也在校验文件中定义，该tag包含数据所属的基础档案的类型（如果有的话）也在校验文件中定义。
如果单据类型是头（主）、体（子）结构的，必须分别设置头、体的校验文件，头校验文件的命名规则是：
“header单据类型.xml”；体校验文件的命名规则是：
“body单据类型.xml”；如果不是头体结构的，只需设置头校验文件。
与上面的几个配置文件一样，校验文件必须放置在Webserver的根目录\webapps\nc_web\ufxx目录下。
销售单据的头和体校验文件如下所示（注意文件名的命名，因为销售订单的单据类型是30）：
头检验文件header30.xml
<订单头>
<单据号datatype='String'nullallowed='no'maxLength='30'matchtag='vreceiptcode'/>
<公司编码datatype='String'nullallowed='no'maxLength='20'matchtag='pk_corp'basicdoc=’公司目录’/>
<单据类型datatype='String'nullallowed='no'maxLength='2'matchtag='creceipttype'/>
<单据日期datatype='UFDate'nullallowed='no'maxLength='10'matchtag='dbilldate'/>
<客户datatype='String'nullallowed='no'maxLength='20'matchtag='ccustomerid'basicdoc='客户档案'/>
<收款协议datatype='String'nullallowed='yes'maxLength='20'matchtag='ctermprotocolid'/>
<收货地址datatype='String'nullallowed='yes'maxLength='100'matchtag='vreceiveaddress'/>
<收货单位datatype='String'nullallowed='yes'maxLength='100'matchtag='creceiptcustomerid'/>
<收票单位datatype='String'nullallowed='yes'maxLength='20'matchtag='creceiptcorpid'/>
<运输方式datatype='String'nullallowed='yes'maxLength='20'matchtag='cdeptid'/>
<自由项datatype='String'nullallowed='yes'maxLength='20'matchtag='vdef1'/>
<备注datatype='String'nullallowed='yes'maxLength='100'matchtag='vnote'/>
<状态datatype='Integer'nullallowed='yes'maxLength='1'matchtag='fstatus'/>
体校验文件body30.xml
<订单体id="">
<编码datatype='String'nullallowed='no'maxLength='20'matchtag='corder_bid'/>
<名称datatype='String'nullallowed='no'maxLength='20'matchtag='cinventoryid'/>
<单位datatype='String'nullallowed='no'maxLength='20'matchtag='cunitid'/>
<数量datatype='UFDouble'nullallowed='no'maxLength='16'matchtag='nnumber'/>
<税率datatype='UFDouble'nullallowed='no'maxLength='7'matchtag='ntaxrate'/>
<单价datatype='UFDouble'nullallowed='no'maxLength='16'matchtag='noriginalcurtaxprice'/>
<金额datatype='UFDouble'nullallowed='no'maxLength='16'matchtag='noriginalcurnetprice'/>
<原币datatype='String'nullallowed='no'maxLength='20'matchtag='ccurrencytypeid'/>
<税额datatype='UFDouble'nullallowed='yes'maxLength='16'matchtag='noriginalcurtaxmny'/>
<交货日期datatype='UFDate'nullallowed='no'maxLength='10'matchtag='ddeliverdate'/>
<存货档案datatype='String'nulla
升级会员 