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

图3.1.3.21 需要定义字段“该字段在外系统中的位置”属性的数据

图3.1.3.22 为字段定义“该字段在外系统中的位置”属性

第 28 页

图3.1.3.23 根据字段的位置属性转换后的数据

2. 高级篇—复杂字段配置

复杂字段在NC数据结构中对应属性的数据类型不是简单类型，而是ValueObject、数组和集合等，对应在外系统数据文件中的则是实体元素或者实体元素的集合。我们将外系统数据文件中与复杂字段对应的元素称为复杂字段元素。根据字段属性的数据类型，还可以进一步将分为复杂字段元素分为VO记录元素，VO数组记录元素，简单数组记录元素，VO集合记录元素和简单数组记录元素等。

在校验文件中需要为每个复杂字段建立一个记录定义，来描述该复杂字段对应的数据类型以及与外系统数据文件中复杂字段元素之间的对应关系，我们将这种记录定义称为内嵌结构的记录。根据字段的数据类型，我们又把内嵌结构的记录分为VO记录、VO数组记录、简单数组记录、VO集合记录和简单集合记录五种类型，它们配置规则不尽相同，下面结合示例逐一介绍。

2.1 VO记录的配置规则

VO记录描述NC系统中VO类信息，该记录的字段定义了记录对应的VO类的所有属性。

图3.2.1.1 VO类型的数据结构

假设我们有如图3.2.1.1所示的VO类CustomerVO，其含有对另一个VO类PersonVO的引用。这时候的person字段是一个复杂字段，我们需要在校验文件中为之单独定义一个记录。根据这样的VO结构，我们自动生成的校验文件如图3.2.1.2所示。

第 29 页

图3.2.1.2 根据内部数据结构自动生成的校验文件

对于billhead记录的person字段的属性项定义，我们需要特别注意的是【数据类型】属性项的值默认设为了“复杂类型”，【该字段在外系统中的位置】属性项的值设置为复杂字段描述记录的表定义名称，而且系统为这个复杂字段定义好了名为person的VO记录。另外，假设我们有如图3.2.1.3所示的外系统数据文件，因为复杂字段元素的标签名为，我们需要将该字段的【该字段在外系统中的名称】属性项的值设置为“person_EX”。

图3.2.1.3 数据文件中的VO类型的复杂字段元素

我们再来看名为person的VO记录定义的属性。

图3.2.1.4 VO类型记录的定义

【复杂字段对应的类名称】填写该记录对应的VO类的全名称。如此处“pfxx.example.PersonVO”。这个属性项的值必须设置，否则系统无法实例化对象。

第 30 页

【内嵌结构数据类型】填写复杂字段的具体类型，有“简单数组”，“VO数组”，“VO类型”，“集合”四种类型的值。在这儿系统默认生成的是“VO类型”，用户不必修改。

【表类型】一共有“表头”、“表体”和“内嵌结构”三种类型值。对于描述复杂字段的记录，都应该是“内嵌结构”型。用户也不必修改这个属性值。

【表定义名称】该记录的名称，如果用户为某个记录修改了名称，而又有复杂字段要参照这个记录，则需要同时修改复杂字段的【该字段对应的表结构定义】属性值。

【转换后标准的表标签】和【外系统定义的表标签】这两个属性在VO集合类型的记录定义中没有意义，50版外部交换平台在生成这种类型的记录定义时不再具有这两个属性。

2.2 简单数组记录的配置规则

简单数组记录描述了NC系统中基本数据类型数组的信息。该记录的字段定义有且仅有一个，描述的是该简单数组的元素信息。

图3.2.2.1 简单数组类型的数据结构

假设我们有如图3.2.2.1所示的VO类CustomerVO，其含有对字符串数组persons的引用。这时候的persons字段是一个复杂字段，我们需要在校验文件中为之单独定义一个记录。根据这样的VO结构，我们自动生成的校验文件如图3.2.2.2所示。

对于billhead记录的persons字段的属性项定义，我们需要注意的是【数据类型】属性项的值默认设为了“复杂类型”，【该字段在外系统中的位置】属性项的值设置为复杂字段描述记录的表定义名称，并且系统为这个复杂字段定义好了名为persons的VO记录。另外，假设我们有如图3.2.2.3所示的外系统数据文件，因为复杂字段元素的标签名为，我们需要将该字段的【该字段在外系统中的名称】属性项的值设置为“persons”。这个例子中不用修改。

第 31 页

图3.2.2.2 根据内部数据结构自动生成的校验文件

图3.2.2.3 包含简单数组类型的复杂字段元素的外系统数据

我们再来看名为persons的记录的属性设置。

图3.2.2.4 默认生成的简单数组类型的记录定义

【复杂字段对应的类名称】属性项填写此记录对应的数据对象的类名，因为此记录是简单数组类型的记录，应该填写简单数组类名的全称，此处是“java.lang.String[]”。

【内嵌结构数据类型】属性项指定该内嵌结构记录的具体类型。Persons记录是个基本类型数组的记录。

【表类型】一共有“表头”、“表体”和“内嵌结构”三种类型值。对于描述复杂字段的记录，都应该是“内嵌结构”型。用户也不必修改这个属性值。

【表定义名称】该记录的名称，如果用户为某个记录修改了名称，而又有复杂字段要参照这个记录，则需要同时修改复杂字段的【该字段对应的表结构定义】属性值。

【转换后标准的表标签】和【外系统定义的表标签】这两个属性在VO集合类型的记录定义中没有意义，50版外部交换平台在生成这种类型的记录定义时

第 32 页

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