NCV5-外部交换平台技术红皮书(2)

9) 进一步约束外部交换平台导入单据的语义。对每个单据需要定义一个组

织字段，用于确保往某个接收方，比如说A公司做加载数据时，导入的数据能真正进入A公司，这个组织字段一般是公司或者主体账簿。为单据定义组织字段之后，如果数据里相应组织字段的值不为空，则要求其值与接受方保持一致，如果数据里相应组织字段的值为空，则取接受方的内容为组织字段的值。 10) 易用性改进。【手动加载界面】对文件目录、回执目录、目标URL地址、

加载成功转移目录的配置增加记忆功能，就是说以相同公司相同用户登陆时，上述各项的配置内容默认显示为最后一次用户设置的值，避免用户每次都需要重新设置。【交换规则定义】增加了查找、定位字段的功能，单据交换规则树上的右击菜单也更加简练明确，同时为字段的导入导出公式定义增加新版本的公式编辑器，定义公式更加方便简洁。

上述功能我们在接下来的内容中会具体提到。

第 3 页

第二章 实施简介及相关注意点

NC外部交换平台的主要功能就是将不同外系统的数据导入NC系统。由于不

同系统之间对于相同单据的数据在表示上千差万别，需要外部交换平台对单据的XML格式的外系统数据进行格式转换和数值翻译，然后将转换后生成的XML格式的NC标准数据实例化为NC系统对应单据的数据对象，并调用业务模块的接口（服务）进行保存或者更新。

NC系统在后台有一个Servlet伺候服务，等待并处理客户端的POST方法请求（外部交换平台提供界面客户端和预警客户端，对于同步集成方式，外系统可以自定义发送客户端）。客户端往根据Servlet的URL建立的连接的输出流中写待发送数据文件的内容，而后台服务端则从请求的输入流中读取数据文件内容，然后再进行后续处理。关于客户端发送数据的具体内容请参考2.3节。

2.1节介绍了要将某个外系统的某种单据类型的数据文件导入至NC系统的最简单方法。其余小节介绍了在实施数据导入过程中容易混淆而需要注意的地方，或者是一些常用的工具等。

1. 实施方法简介

1.1 外系统数据导入的一般步骤

外系统根据单据类型将相同单据类型的数据组织在一个XML文件中，然后将其发送到NC系统的某个账套下的某个公司或集团中（对于有账簿信息的单据而言，比如会计科目或者凭证，则是某个公司的某个账簿之下）。一般来说，如果需要发送某种单据类型的数据至NC系统中，需要如下几步：

一、注册外部系统。如果不存在可用的外系统的话，请在“外部系统信息注册”界面中注册一个外部系统。

二、准备外系统数据。这份数据可能是外系统直接输出的，也可能是二次开发人员通过写程序从第三方系统数据库中抓出来的，或者由Excel格式或其他格式文件转换过来的。写这份数据时，可以参考NC安装盘附带的XML模板，XML文件头或者说文档头的属性项请参照2.2节详细说明。

三、配置辅助信息（可选）。如果要导入的单据数据需要辅助信息配置，在“辅助信息配置”界面根据外部系统、单据类型、接收公司及主体帐簿（如果带的话）为此次文件发送配置辅助信息。

四、设置基础数据对照（可选）。如果要导入的单据数据需要作基础数据对照（对于需要参照基本档案的字段，如果其值不能按名称或者编码自动翻译过来

第 4 页

的话，在导入过程中系统会自动提示必须为该值做基础数据对照），在“基础数据对照”界面根据需要参照的外部系统、需要参照的基本档案、公司（取当前登陆公司）及主体帐簿（如果带的话）为需要对照的值做基础数据对照。

六、配置Servlet的URL地址。将要发送至的帐套编码作为account属性值写入要发送到的Servlet的URL中（或者写入XML文件的头中），将接收公司和主体帐簿（如果带的话）的代码拼成接收方（接收公司编码@接收主体账簿编码）作为receiver属性写入要发送到的Servlet的URL中（或者XML文件的头中）。详细说明请参见2.2节。

最后，就可以利用客户端触发该单据类型的数据文件的发送了。

NC外部交换平台内置了常用单据类型数据的导入功能，对于这些单据类型， 如果外系统数据遵照了这些单据类型的交换规则定义(即如果外系统的数据严格按照NC安装盘附带的相应单据的XML模板生成)，那么按上述步骤相对比较简单地就可以导入数据。但是如果外系统数据未能遵照单据类型的交换规则定义，则需要修改该单据类型的交换规则定义。做法就是将该单据的普通交换规则定义文件另存为特定该外部系统的交换规则定义文件，并根据单据交换规则定义规范修改该特定交换规则定义文件，具体需要参见第三章[单据交换规则定义]，然后再行导入。对于非系统内置或者自定义的单据的导入，需要基于外部数据交换平台做二次开发，这部分内容可参见第四章。

1.2 外部交换平台服务器端文件目录结构

外部交换平台服务端的目录结构安排如图2.1.1所示，其中NC_COMMON为安装盘根目录，也是中间件的工作目录。

从上图可以看出，外部交换平台配置文件目录pfxx与webapps一样同在安装盘根路径下，其中：

pfxxtemp目录，存贮外部交换平台接受到的原始数据文件、转换翻译完毕的标准XML文件、传送失败的文件。

xmleditor 目录，存放校验文件管理的样式文件，可不用考虑。 exportbills 目录，存放外部交换平台发送给外系统的数据文件。 billdefine目录，存放所有需要交换的档案和单据的交换规则文件。 auxiregister目录，每个模块在这个目录下注册一个文件，文件的内容是模块所涉及单据的辅助信息格式。详细情况参考4.3节辅助信息项设置。

businessprocessor目录，每个模块在这个目录下注册一个文件，文件的内容

第 5 页

是模块所涉及单据在外部交换平台的注册信息，如单据类型、业务插件类名称、业务操作、单据导入范围、单据加锁级别等。详细内容参考4.1节注册单据相关信息。

billconfiginfo目录，每个模块在这个目录下注册一个文件，文件的内容是模块所涉及单据的基本信息，如表和VO对象名。详细内容参考4.1节注册单据相关信息。

sendurl.xml 文件，定义了NC系统通过HTTP回发数据给外系统时的各种参数，如发送地址、业务操作、发送方、接受方、单据类型等等。

globalset.xml 用于存放外部交换平台的全局参数，如默认帐套、单篇最大传输上限等。

图 2.1.1 外部交换平台服务端文件目录结构

第 6 页

2. Servlet的URL地址参数与XML交换文档头属性的关系

在外系统的单据数据的导入过程中需要用到一些初始化信息，如帐套、接收方（包括接收公司和主体账簿）、数据所属外部系统（发送方）、单据类型、业务处理（新增、更新还是查询）等。这部分数据可以在Servlet的URL地址的参数中指定，也可以在XML数据文件的文档头属性中指定，但是在Servlet的URL地址的参数中指定的信息比在XML数据文件的文档头属性中指定的信息有更高的优先级别。比如在Servlet的URL地址参数中指定receiver=yk，而在XML数据文件的文档头属性中指定receiver=yy，则最终还是将数据发送到yk公司。

下面我们依据实例来逐一介绍各个常用属性。图2.2.1是一个典型的NC服务器的Servlet的URL地址，“http://10.7.3.226:80/service/XChangeServlet”是后台Servlet的服务名，V50之前的版本直接指定Servlet的类名，现在指定的是包装之后的服务名。“?”号之后的“account=0001&receiver=yy”就是设置的URL地址参数，一般情况下这个地方只设置帐套编码和接收方两个属性。至于这两个属性的含义下面会介绍到。

图2.2.1 典型Servlet的URL地址

图2.2.2是一个典型的XML文档头，文档头的根标签名是ufinterface，后面跟着就是各种初始化信息的设置。我们将这些属性分为三类：必须设置的属性、根据Servlet的URL参数设置决定是否必设的属性和根据需要决定是否设置的属性。

图2.2.2 典型XML文档头

【必须设置的属性】：

billtype属性，这个属性值决定了这个XML文件（文档）中所有单据的单据类型，外部交换平台所有的处理都是围绕单据类型的。

sender属性，这个属性值设置的是外系统编码，指定的是数据的来源系统，即习惯上所说的发送方。

proc属性，这个属性值设置对文件中所有单据要做的操作，如新增add、更新update、删除delete、查询query等等。单据具体支持哪些业务操作可以到[二次开发工具]-[交换平台设置]-[交换单据设置]中查询。 【根据Servlet的URL参数设置决定是否必设的属性】：

这些属性其实也是必设属性，但如果Servlet的URL参数里面设置了这几个属性的话，XML文档头里面可以不设置这几个属性值，即使设置了也不会起作用。

account属性,这个属性指定要将数据导入至NC系统的哪个帐套。

receiver属性，这个属性指定数据的接收方。接收方又是有一定格式的，可以将这个格式用一个正则表达式表示为：

接收方=（公司编码|公司主键）(@主体帐簿编码)？

第 7 页

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库NCV5-外部交换平台技术红皮书(2)在线全文阅读。