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」。

  默認值為「自動」。