NCV5-外部交换平台技术红皮书 - 图文

第三章 单据交换规则定义

本章介绍在“交换规则定义”界面上如何为在外部交换平台中注册的单据进

行外系统与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标准数据之间在名称、结构和语义上的差异，需要通过手工配置来修改自动生成的单据交换规则，以保证内外系统交换时数据的完整性和有效性。

第 18 页

图3.1.2 可编辑交换规则轮廓

现在假设有一外部的XML数据样本文件，如图1.2所示。 我们将单据根标签定义的元素称为单据数据元素，一个外系统数据文档可以包含多张单据，也就是说可以有多个根标签打头的单据数据元素。由单据表头标签定义的元素称为表头记录元素，一个单据数据元素只包含一个单据表头元素。由单据表体标签定义的元素称为表体记录元素，每个单据数据元素也只有一个单据表体元素，但每个单据表体元素包含多个表体分录元素，表示单据表头元素对应表头数据项的多个表体数据项。在图3.1.3中所示的数据文件中表体分录元素的标签是entry。

图3.1.3 外部XML数据文件样本

由于外系统数据文件的单据根标签为，我们首先需要将该交换文档的根标签属性值设置为billdata。如图3.1.4所示。

第 19 页

图3.1.4 修改交换文档根标签

接下来，就需要分别配置表头和表体记录定义了。

1.1 表头记录的配置

表头记录定义了NC系统里单据表头VO的信息及与外系统文件相应单据表头元素的对照关系。由于各种类型的记录其属性项的意义并不完全相同，我们对于每种记录类型，依次介绍其属性项的意义和配置。首先让我们来看默认生成的表头记录定义，如图3.1.1.1所示。

图3.1.1.1 名为billhead的表头记录定义

【转换后标准的表标签】是生成NC标准XML文件时使用的标签名，由NC统一发布，用户一般不应该做修改。 【外系统定义的表标签】是外系统数据文件中单据表头元素的标签名，在上述数据文件中是，因此需要将该属性值设置为customer_EX。如果数据文件中单据表头元素的标签名与默认生成的【外系统定义的表标签】项属性值不同，必须将该值修改为单据表头元素的标签名，否则就会在导入的过程中报找不到单据表头元素的错误。如图3.1.1.2所示。

图3.1.1.2 设置表头记录“外系统定义的表标签”属性项的值

【表定义名称】该记录定义的ID，也是校验文件管理界面中右部结构树上记录

第 20 页

定义节点的显示名称，用户可以修改。

【表类型】表示该记录定义的类型，有“表头”、“表体”和“内嵌结构”三种，一般也不用做修改。“表头”值表示该记录是表头记录。表头记录的字段是为该记录对应表头VO类型定义的字段。我们将会在字段属性项的配置一节中详细介绍如何配置每个字段。

1.2 表体记录的配置

表体记录定义了NC系统里单据表体VO的信息及与外系统数据文件相应单据表体元素和表体分录元素的对照关系。图3.1.2.1是默认生成的表体记录。

图3.1.2.1 名为billbody的表体记录定义

【转换后标准的表标签】是生成NC标准文件时使用的标签名，由NC统一发布，用户一般不应该做修改。如图3.1.2.2所示。 【外系统定义的表标签】在此处是外系统数据文件中单据表体元素的标签名，在本例的数据文件中是〈person_EX〉，因此该属性值设置为person_EX。

图3.1.2.2 设置表体记录“外系统定义的表标签”属性项的值

【表体记录标签】表示表体分录元素的标签名，因为在此处数据文件中的表体分录元素的标签名跟默认生成的表体记录标签名相同，都为，因此不必作修改。

【表定义名称】该记录定义的ID，也是校验文件管理界面中右部结构树上记录定义节点的显示名称，用户可以修改。

【表类型】属性项在自动生成时默认为“表体”，表示该记录是表体记录，不用修改。

需要提醒大家注意的是，表体记录所有字段是为表体VO定义的，我们正是根据这些字段定义去转换翻译每个表体分录元素的。我们将会在字段属性项的配置一节中详细介绍如何配置每个字段。

第 21 页