FSD 字段标记

字段元素可指定输入或输出数据内的单个字段。

属性

• name

  指定字段的名称。如果 output 属性设置为“yes”，则这个名称在输出过程中将作为 XML 标记名称，在输入过程中则与 XML 标记进行选择匹配。

• output

  指定字段是否包括在输出中。该属性的有效值是：

  • “是”

    记录将导致输出内生成一个标记

  • “否”

    该字段仅说明数据结构，可用来跳过数据。

  默认值为“yes”。

• record-sep

  为字段指定一个可选的字段分隔符字符串。可以是任意字符串值。也可使用以下特定值：

  • \r

    回车字符

    \n

  • 换行字符

  • \t

    Tab 字符。

  数据是固定长度的。如果未指定字段分隔符，则会使用最大长度属性。

  记录中的最后一个字段使用记录分隔符，而不是字段分隔符。

• valid-value

  设置该字段的固定值。将用于验证平面数据，并作为选择元素中模式匹配的一部分。如果平面数据的输出属性设置为“no”，那么“valid-value”将写到平面文件中。

• leading-chars

  如果存在，则指定必须从字段开头移除的字符串。如果未指定“trailing-chars”属性，且字符串长度小于“min-length”属性中指定的长度，那么这些字符中的第一个将用作值的左垫。

• trailing-chars

  如果存在，则指定必须从字段结尾移除的字符串。如果字符串长度小于“min-length”属性中指定的长度，那么这些字符中的第一个将用作值的右垫。

• output-if-empty

  指定在字段为空时是否输出。该属性的有效值是“yes”和“no”。默认值为“no”。

• max-length

  设置数据的最大长度。该值指定必须读取多少数据。默认值为“128”。

• min-length

  设置数据的最小长度。该值被用于有效性检查和“choice”元素的模式匹配，同时还可以在“leading-chars”或“trailing-chars”属性已指定时用作筛选器。默认值为“0”。

• truncate

  如果该属性设置为“yes”，那么写到平面文件的数据将被截至指定 max-length。默认值为“否”。

• quoted

  指定在数据前后是否必须放引号。这会使字段分隔符可以出现在输出数据中，因为 FSD 处理器不会在引用字符串内查找字段分隔符。该属性的值为：

  • “否”

    数据不作为引用字符串，将逐字写入和写出平面文件。

  • “是”

    数据作为引用字符串。当从平面格式向 XML 转换时，系统会去除数据中的引号，同时任何遗留的引号将转换为单个引号。

  当从 XML 格式向平面格式转换时，数据会包含在引号内。所有现有的引号将被“转义”，即单引号会转变为成双引号。因此 " 将被转换为 ""，等等。

• 自动

  该选项仅适用于将符号分隔的平面文件数据转换为 XML 的情况。如果数据包含字段分隔符，该选项的处理将会假设 quoted 选项设置为“yes”。

  默认值为“自动”。