的回执信息的
5. 外部交换平台总体参数设置
点击：[客户化]→[外部交换平台]→[交换平台日志]→[参数设置]，在交换平台日志界面打开参数设置对话框，如图2.5.1所示。在这个对话框中，可以设置在外部数据导入过程中起到相当作用的参数，您可以根据需要对这些参数的设置进行改动。设置的参数值实时生效，不用重起后台服务器。
图2.5.1 总体参数设置
下面我们来介绍这些参数的功能及需要注意的地方：
5.1 单据导入方式
外部交换平台以交换文档中的单据为单位，支持非独立事务和独立事务两种导入方式，即同一XML文档对象中的所有单据批量处理和同一XML文档对象中的每张单据单独处理。例如，一个凭证类型的XML文档由一百张凭证组成，如果将交换平台总体参数的单据导入规则设置为“同一文档里的所有单据批量处理”的话，那么如果在导入这个文档的过程中有任何一张凭证发生错误，将导致
第 13 页
所有的这一百张凭证导入失败，但是如果单据导入规则设置为“同一文档里的每张单据独立处理”的话，那么即使这一百张凭证里有些凭证在导入过程中失败了，也不会影响到其余单据的成功导入。通俗一点的说话就是，非独立事务就是文档中的所有单据要么一块儿成功，要么一块儿失败，而独立事务就是文档中的每张单据的成功导入与否不会受其他单据导入成功与否的影响，当然如果从文档中导入的单据有先后顺序的话，选择独立事务可能也就起不到作用了。系统默认的单据导入方式是“同一文档里的所有单据批量处理”。
5.2 单篇最大传输上限
对于要导入的单篇文档或者单个文件来说，其大小是受服务器端系统性能影
响的。系统默认单篇最大传输上限是2048KB，这个大小一般系统的存储器都能够满足。如果用户导入的文件大于设置的值，回执文件就会提示“文件长度超过设定长度”的错误。因此，用户可以根据需要，如待导入文件的大小和机器性能调整这个值，最大大概能设置到214–215KB，也就是20000KB左右，建议设置在5000KB以下，以便得到较好的传输性能。
5.3 导入过程是否记录中间文件
这个参数主要用于控制所导入文档的每张单据是否在服务器本地做备份记录，主要做两次备份，分别是原始单据备份和转换翻译后单据的备份，前者备份至目录NC_HOME/pfxx/pfxxtemp/indocs/下，后者备份至目录NC_HOME/pfxx/pfxxtemp/translated/下。这些信息在找错排错中是非常有用的，比如发生找不到某个字段元素的错误，它可能是交换规则定义错误引起，也可能是外系统数据格式错误引起，这个时候将备份的导入原始单据和转换后的单据做一个对比，便可以很快定位问题。系统默认是勾选“导入过程是否记录中间文件”。
5.4 外部系统默认帐套
将某个外系统数据文档导入到哪个帐套是由Servlet的URL地址的account参数或者文档根属性account决定的，但是如果这两个地方都没有申明这个值，那么系统就将外部数据导入至这个参数设置的帐套中。系统默认没有设置这个属性，但打开对话框就会显示当前系统所有帐套编码。
5.5 设置客户端IP范围
这个参数属于外部交换平台安全性方面的设置。我们在这里设置允许向NC系统发送数据文件的地址范围，这样我们可以确保与合法的外部系统进行数据集成。如，假设目前我们只允许地址为10.7.3.255和10.7.3.233两个IP地址的客户端发送数据，那么我们就启用这个属性设置，并将这两个IP地址输入至其输入框中，中间使用；号隔开。设置完这个属性之后，我们再去利用这两个IP地址
第 14 页
上的客户端发送外系统数据的话，回执文件就会提示“发送方地址不合法！”。
5.6 接收公司匹配规则
接收公司匹配规则是指在导入过程中如何对接收方参数中指定的公司值进行翻译，有两个可选值：按编码或者按PK，系统默认值是“按编码”。比如用户现在要将外部数据发送到编码为“yk”，PK为“1046”的公司，如果用户将其设置成“按编码”，那么在Servlet的URL参数或者待导入文档根属性的地方写上：receiver=yk，如果用户将其设置成“按PK”，那么相应写的是receiver=1046。这方面的内容可以参考2.2节。
5.7 回执文件后台备份
对于导入的每一张单据，外部交换平台都会给客户端或者发送方一个回执信
息即一个XML格式的回执文档。如果您使用的数据发送方式是手动界面发送或者后台预警发送的话，回执信息都会以文件的形式保存到指定目录下，但是如果通过自定义程序实时发送数据的话，当出现传输异常时就需要在后台备份一下单据的每个回执文件，目的就是检查返回给发送方的数据是否正确。回执文件后台备份这个参数就是用于控制是否后台备份这个文件，系统默认不进行备份。
5.8 回执和导出文件编码格式
这也是一个便利工具，目的就是使得外部交换平台导出的XML数据文件或者
单据回执文件的编码格式可配置。如果与NC系统交互的第三方系统只能处理gb2312编码格式的文件，经过配置之后就可以相当方便的达到目的，只是此时如果回执信息包含非gb2312编码字符，则可能显示不正常。系统默认回执和导出文件的编码格式是UTF-8，外部交换平台同时支持UTF-8和gb2312格式文件的导入。
6. 单据流水号和单据并发控制
6.1 单据流水号的概念和作用
单据流水号在外部交换平台中是一个相当重要的概念，可以将其看作一张单据在外部交换平台中的标识。一般情况下，需要为待导入的每张单据定义一个流水号，如果未定义的话，系统会自动为导入的每张单据生成一个独一无二的流水号。外部交换平台将同一单据类型并具有相同流水号的单据看作是同一张单据，如果重复往同一接收方发送具有相同流水号的单据时，第一次会在NC系统新增该单据，其后均更新已导入单据。但如果往不同接收方导入具有相同流水号的单据，第一次同样是新增该单据，其后也是新增且是往不同接收方新增，但往往会发生编码名称重复等错误，取决于不同的档案或者单据在不同组织内是否控制编
第 15 页
码或者名称重复。
我们可以将数据导入与界面录入做一比较：往某个接收方如A公司发送某种单据类型的数据，就相当于A公司某个用户登陆并打开相应单据界面进行制单。第一次往A公司发送某个流水号的单据，就相当于在界面新增一个单据；再一次往A公司发送具有相同流水号的单据，就相当于在界面上修改原来新增的单据一样。这个时候如果将具有相同流水号的单据发送至B公司的话，就相当于以B公司某个用户登陆系统，在相应单据界面上新增一张与原来在A公司新增的单据在数据上一模一样的单据。如果根据业务这在很多系统中是不允许的，外部交换平台跟前台界面操作一样，同样会报错。
6.2 单据并发控制
点击：[客户化]→[二次开发工具]→[交换平台设置]→[交换单据设置]，打开业务插件配置界面如下。
图2.5.2 为业务单据设置并发级别
系统为每种单据类型的数据内置了四个并发加锁级别，由低到高分别是：单据类型、单据类型+公司（账簿）、单据类型+流水号、单据类型+公司（账簿）+流水号。
第 16 页
第三章 单据交换规则定义
本章介绍在“交换规则定义”界面上如何为在外部交换平台中注册的单据进
行外系统与NC系统之间交换规则的定义。外部交换平台除了支持内置单据的标
准外系统数据以及U8系统数据的集成之外，利用单据交换规则定义扩展对其他外部系统（Sibeil,SAP等等）的第三方数据的集成的支持。关于单据交换规则的定义，我们分两部分来介绍，基础部分介绍如何完整地为一张单据配置交换规则，高级部分介绍单据交换规则中复杂字段及其对应结构的配置。
1. 基础篇—简单单据配置
简单单据是指没有复杂字段的单子表、主子表单据。单子表只需要在交换规则中定义一个表头记录。主子表则需要同时分别定义表头和表体记录。
我们结合一个主子类型的测试单据的交换规则的配置，来介绍配置外部交换平台交换规则文件的一般知识。关于针对包含复杂字段的单据交换规则文件的配置，需要参考本文的高级篇。
我们建立了一个简单的主子表测试单据，单据类型是“Test6”。在NC系统里为之建立名为pfxx.example6.CustomerVO的表头VO类，名为pfxx.example6.PersonVO的表体VO类，类图如下所示：
图3.1.1 主子单据数据结构类图
借助于我们的交换规则自动生成工具，可以直接将VO结构映射为XML的交换规则。图3.1.2就是根据该单据类型注册的VO信息和表信息自动生成的交换规则。但由于外系统数据与NC标准数据之间在名称、结构和语义上的差异，需要通过手工配置来修改自动生成的单据交换规则，以保证内外系统交换时数据的完整性和有效性。
第 17 页
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库NCV5-外部交换平台技术红皮书(4)在线全文阅读。
相关推荐：