软件系统实施技术规范(2)

和DataType参数，批量写入操作中提供的这三个参数忽略。

读取和查询操作中使用批量数据可以根据实际逻辑定义批量数据反馈格式。

四、 数据格式规范

要想让同一种数据在不同的软件接口中使用，必须让数据遵循共同的描述方式，为了让数据通俗易懂便于计算机处理和人理解特采用XML格式作为所有数据的标准格式，按照特定的XML格式定义的数据描述称做数据规范。采用数据规范后应用软件的功能实现就具备一定的灵活性

数据规范在应用软件接口中涉及写入和读取操作中的“XML数据”，查询操作中的“XML查询命令”和“XML查询结果”。大型应用软件的数据规范聘请专业单位进行独立设计，小型应用软件的数据规范由软件开发单位负责设计。

1. 数据规范的基本结构

基本的数据规范必须符合下面的基本格式：

属性=\内容\

<属性节点 Type=\类型\其他属性=\内容\属性值 ……

根节点命名为Document表示这是一个按本文数据规范定义的数据。

应用标识表示数据规范与哪一个应用有关。在某项应用的数据规范设计中必须首先明确应用标识采用的值。例如：\就表示是组织结构管理功能的数据。一个应用软件可以包含多个应用，不同应用具备独立的应用标识，可以独立开发。

数据标识表示数据的唯一值，对于元数据应用软件就是依靠该值执行增加、删除和修改操作。在数据规范设计中该值不要明确具体的内容，在实际数据生成时必需按照GUID的标准生成具体值，这样可以保证不同的系统生成的数据不会重复。

数据类型表示数据对应哪一个类型，一个应用可以包含多个数据类型，相同类型的数据必须遵守相同的格式。调用系统接口的软件和系统接口实现的软件都依靠数据类型来确定数据的分析和生成方法。

文档根节点还可以叠加与整个文档有关的其他属性，具体可以根据不同的设计方案扩展。

属性节点表示数据属性，一个数据有多少个属性就列多少个属性节点。属性节点名称可

6

以重复，名称相同的属性值可以存在次序关系，不同属性名称的节点不存在先后次序关系。

类型表示属性节点的具体类型。类型及其表示方式将在第2节中详细介绍。 属性值表示属性节点的具体内容。

属性节点还可以叠加与属性相关的其他内容，具体可以根据不同的设计方案扩展。

2. 数据类型描述

? 标准数据类型及其格式。标准数据类型共定义八种，主要有：LOGICAL、LONG、DOUBLE、CURRENCY、DATE、BINARY、TEXT、GUID。它们的含义、取值范围、格式和默认值如下：

LOGICAL

LONG DOUBLE CURRENCY DATE BINARY TEXT GUID

逻辑型，值为：true或false，不能为空且必须为小写，默认值false。 整数型，数据位数在设计时不限长度，不能为空，默认值0。 小数型，数据位数和小数位数在设计时不限长度，不能为空，默认值0.0。

货币型，仅含两位小数的数据，不能为空，默认值0.00。 日期型，格式为“YYYY-MM-DD HH:MM:SS”，默认值为空。 二进制型，二进制数据的BASE64编码，默认值为空。 文本型，长度不限，默认值为空。

数据标识型，格式“7adab85a-e2cd-4a17-a23b-4044b0d72560”小写格式，每一位必须是’0-9’，’a-f’十六个字符之一，按照标准GUID算法生成的内容。

? 扩展数据类型及其格式。扩展数据类型在本文中先定义四种，今后将根据情况进行补充，主要有：文件数据、附件数据、枚举数据和组织结构数据。

? 文件数据。文件数据以二进制的方式读入内存后转换成BASE64的字符串写入文档中。文件数据包含文件名，扩展名，MIME信息等属性。数据格式例子：

<属性节点 FileName=\文件名\扩展名\数据格式描述\二进制的BASE64编码

? 附件数据。用于描述一组文件数据，由于涉及多个文件数据，附件数据由两级节点组成。数据格式例子：

<属性节点 Type=\

制的BASE64编码

制的BASE64编码

……

? 枚举数据。用于描述一组字符串，实际数据只能是这组字符串数据中的一个。数据格式例子：

<属性节点Type=\枚举名称\枚举值一|枚举值二|枚举值三|……]

7

? 组织单元数据。用于描述单个组织单元信息。组织单元数据包括：标识、名称、类型、所属单位标识等信息。数据格式例子：

其中类型定义了Company（单位）、Branch（部门）、Member（人员）、Group（群组）、Application（应用软件）等五种。

? 组织单元列表数据。用于描述一组组织单元信息。数据格式例子：

3. 常用数据规范设计原则

在这里列举了一些常用数据规范的设计方式，一般情况下需要遵循这些方式设计数据规范。

? 元数据的规范设计。元数据是指信息系统中的最基本数据，如果一个数据被拆开后在整个信息系统中不再具备其他意义，那么这个数据就叫做元数据。在系统完成功能设计后就可以初步分析出系统建设需要的各类元数据，系统开发和系统试运行过程中元数据可能会存在一些变化，系统投入正式运行前元数据基本可以固定下来。

元数据以Document为根节点的，元数据包含的子节点就是具体的数据属性，如果属性过多（20个以上）并且可以进一步分类那么可以多设计一层子节点，但是一般不要超过三层节点。

下面是组织结构管理模块中的人员数据定义：

应用标识统一为：\，人员标识由生成人员数

8

据的模块按标准GUID算法生成，数据类型为：Member，数据属性中的Guid和DataGuid取同一个值，适度的属性冗余可以用来验证数据完整性。其他数据属性是描述人员信息需要提供的附加内容。

从这个例子可以看出，任何一个属性独立出来后在组织结构管理功能中都不在具备其它意义，因此人员数据可以认为是元数据。

元数据中的属性可以引用其它元数据，但是不能包含其它元数据，如果包含其它元数据那么它本身就不是元数据。

元数据可以包含状态属性，状态属性在设计文档中可以定义多种状态，但是在元数据的实例中状态属性只有一个值。

元数据中相同名称的属性如果存在多个那么对应的属性值是有先后次序的，不同名称的属性是不存在先后次序的，下面两个数据规范可以认为是同一个规范。

规范一

规范二

9

元数据的实例可以包含元数据定义的节点以外的其他数据节点，只要数据规范定义的节点数据都存在依旧可以认为是一个符合元数据规范的实例数据。

元数据主要用于写入和读取操作，执行写入操作时应用标识、数据标识和数据类型在参数和数据中要同时出现并且值要相同，应用软件负责符合性检查，如果值不相同应用软件可以不执行写入操作。读取操作时返回的元数据包含应用标识、数据标识和数据类型与读取参数要相同。数据标识和类型相同的元数据表示同一个元数据，写入操作执行时老的数据会被覆盖。

? 数据集合的规范设计

数据集合是一组数据的集合，其中的数据可以是元数据也可以是中间数据。集合数据以Document为根节点，根节点中增加集合中数据的数量属性，DataGuid属性根据需要可以定义具体值，也可以空缺。集合中的数据一般以Data做为子节点，子节点中包含数据所属类型的描述，数据的属性和属性值在Data下面进一步定义数据节点和节点值，属性不多的情况下也可以使用Data节点的属性和属性值来定义。特殊情况下可以用集合中数据的节点名称做为子节点名称，但不要使用Document做为子节点的名称。集合中包含的数据是按次序出现的，在实际应用中可以根据需要认为是有序的还是无序的。

数据集合举例一。网站回音壁问题列表：