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

图3.1.2 可编辑交换规则轮廓

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

图3.1.3 外部XML数据文件样本

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

第 18 页

图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，也是校验文件管理界面中右部结构树上记录

第 19 页

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

【表类型】表示该记录定义的类型，有“表头”、“表体”和“内嵌结构”三种，一般也不用做修改。“表头”值表示该记录是表头记录。表头记录的字段是为该记录对应表头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定义的，我们正是根据这些字段定义去转换翻译每个表体分录元素的。我们将会在字段属性项的配置一节中详细介绍如何配置每个字段。

第 20 页

1.3 字段属性项的配置

接下来，我们需要配置表头和表体记录中的每个字段。先介绍两个概念：字段元素和实体元素。DOM树中的叶子节点（简单元素）我们称之为简单字段元素，因为一般情况下它与我们NC系统中的一个数据对象的属性或者数据库表中的一个字段对应。除了简单字段元素之外，还有复杂字段元素。关于复杂字段元素的介绍请参考高级篇。图3.1.3.1示例了数据文件中的简单字段元素。

图3.1.3.1 数据文件中简单字段元素示例

由字段元素（简单字段元素或者复杂字段元素）组成的父元素我们称之为实体元素。实体元素可能是表头数据元素，也可能是表体分录元素，还有可能是高级篇中的VO类型的复杂字段元素、简单数组类型的复杂字段元素以及简单集合类型的复杂字段元素（参考高级篇复杂字段配置）。图3.1.3.2示例数据文件中的一个表头数据元素形式的实体元素和一个表体分录元素形式的实体元素。

第 21 页

图3.1.3.2 数据文件中实体元素示例

下面介绍字段的各个属性的含义和配置：

? 【该字段在NC里的名称】

这个字段在NC的数据结构中的名称，这个名称是由NC系统的数据结构决定的，由校验文件自动生成时自动填充，用户一般不需要修改它。

? 【该字段在外系统中的名称】 表示字段元素的标签名。数据交换的本质是数据映射，让一个系统中有意义的数据变为另一个系统中同样有意义的数据，但两者的名称可能不一样。在这个地方我们要正确填写外系统数据文件中跟NC中某字段对应的字段元素的标签名，否则就会丢失信息。如表体记录定义的字段customerNumber默认的外系统名称为，与数据文件中相应字段元素的标签名不一致，需要将该字段的这个属性值设置为相应字段元素的标签名“cust-num”，否则在转换过程中就会丢失这个字段的值。

图3.1.3.3 校验文件默认生成的“该字段在外系统中的名称”

第 22 页

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