跳至主要內容
文件
文件
Administrator Guide
上次更新時間 ：2023-06-23
使用文字結構描述檔案將文字轉換為 XML

使用文字結構描述檔案將文字轉換為 XML

建立包含
文字結構描述
 步驟的程序集。取得將構成文字結構描述基礎的範例文字。
文字結構描述
 步驟可讓您使用文字結構描述將文字轉換為 XML。若要開發文字結構描述，您必須知道要轉換的資料結構。透過包含代表性資料的小型範例文件，此流程可大幅簡化。本主題假設您有這樣的範例。
您可以使用
文字架構
 步驟將 XML 轉換為文字，或轉換分隔檔案的檔案，但在大多數情況下，分別使用
XTT
 步驟和
csv-to-xml
 步驟會更簡單。
  1. 在
    文字結構
     描述步驟的
    屬性
     檢視中，按一下
    建立文字結構描述檔案
    。
  2. 選取文字結構描述檔案的上層資料夾並提供檔案名稱。如果需要，請指定目標名稱空間 URI。
  3. Studio 會開啟文字結構描述編輯器，並在
    樹狀
     目錄檢視中顯示新的文字結構描述。
  4. 將範例文字剪下並貼到文字結構描述編輯器右上角的區域中，取代
    initial-text
    。
    若要從輸入檔案中移除終止換行符，請將此屬性內容新增至根結構描述元素︰
    ts:eofStrip="
"
    。
  5. 開始說明範例文字。選取第一個欄位，按一下滑鼠右鍵並選取
    「建立欄位」
    。
    如果您沒有要轉換的文字範例，但知道其結構，則可直接編輯文字結構描述的
    「來源」
     檢視。
  6. 在
    「建立欄位精靈」
    的
    「身分」
     頁面上，提供欄位的基本說明。執行此任務時，請參考以下說明︰
    選項 說明
    名稱
    欄位的名稱。
    週期
    選項包括︰
    • 預設值
      ︰此欄位為必填欄位，且只會出現一次。
    • 必填
      ︰與預設值相同。
    • 選填
      ︰欄位為選填欄位，只能出現一次。
    • 多個選填
      ︰欄位為選填，可出現多次。
    • 多個必填
      ︰此欄位為必填欄位，可出現多次。
    開始標記
    規則運算式，用於指定導致產生元素的文字。請注意，符合此運算式的文字不會構成輸出值的一部分。如果您希望在輸出值中顯示相符的文字，請使用
    ts:format
     選項。
    結束標記
    規則運算式，指定用來標示元素結尾的文字。請注意，符合此運算式的文字不會構成輸出值的一部分。如果您希望在輸出值中顯示相符的文字，請使用
    ts:format
     選項。
    截斷
    指定是否要截斷固定長度欄位中的溢位資料，或拋出錯誤。預設值為
    true
    。
    分隔符號
    規則運算式，用於指定分隔重複欄位的字元。僅當您選取
    「多個選填項目」
     或
    「多個必填
     項目」選項時啟用。
    省略
    指定在
    文字至 XML
     或
    XML 至文字的
     轉換中，是否要省略輸出中的欄位。預設為無遺漏。
  7. 在
    「建立欄位精靈」
    的
    「分隔
     符號」頁面上，說明範例文字中有多少字元可代表一個欄位︰
    選項 說明
    格式
    識別欄位有效文字模式的規則運算式。使用此運算式來代替
    開始標記
     和
    結束標記
     ，可確保輸出中顯示所有相符的文字。您也可以在處理多次出現的值時使用它，以便在序列結束時清楚顯示。
    固定長度
    指定固定長度欄位的長度。包含引號和逸出字元。
    已報價
    表示是否將字串值視為帶引號的字串。選項包括︰
    • 預設值
      ︰
    • 一律
      ︰
    • 始終包含空白
      ︰
    • 選填
      ︰
    • 從不
      ︰
    內邊距
    識別固定長度欄位內任何填補文字的規則運算式。
    偏好的填補
    指定
    填補
     運算式可比對 1 個以上可能字串時要使用的值。
    對齊
    指定需要填補的固定長度欄位的對齊方式。
  8. 在
    「建立欄位精靈」
    的
    「解釋」
     頁面上，說明範例文字中有多少字元可代表一個欄位︰
    選項 說明
    類型
    欄位的資料類型。
    預設值
    欄位的預設值。
    日期格式
    指定日期或日期時間的模式。支援 Java 允許的任何模式
    SimpleDateFormat
    。
    日期語言
    指定解釋日期時要使用的日期語言。當日期格式使用月份名稱時，請確保以適當的語言處理名稱。預設值為
    EN
    。
    兩位數的年份
    指定用於解釋 2 位數年份日期的值。文字結構描述剖析器會將在該值之前的 2 位數年份日期解釋為目前的世紀。範例︰如果您輸入
    18
    ，剖析器會解釋
    14
     身分
    2014
     和
    96
     身分
    1996
    。
    數字格式
    指定數字的模式。支援 Java 允許的任何模式
    DecimalFormat
    。
    小數點分隔符號
    指定用於十進位數字的分隔符號。
    分組分隔符號
    指定數字的千分位分組分隔符號。
  9. 對范例文字中的每個欄位重複步驟 6-9，在
    樹狀
     目錄檢視中新增元素。建立所有必填欄位定義後，請刪除其餘的欄位定義。
    Unparsed
     子元素
  10. 若要將所有已建立的元素合併為一個複雜類型，請選取元素並按一下滑鼠右鍵，然後選取
    「合併元素」
    。然後提供包裝元素的名稱和出現值。
  11. 在包裝元素的
    屬性
     檢視中，從
    結束標記
     下拉清單中選取
    /n
    。
  12. 預設結構描述根元素名為
    File
    。在元素
    屬性
     檢視的
    結構描述
     分頁上，提供更有意義的名稱。
  13. 在最上層的
    「屬性」
     檢視中
    schema
     元素，則
    「根元素」
     屬性值為
    tns:File
    。取代
    File
     並使用您為根元素選取的有意義的名稱。
  14. 若要從產生的輸出中移除任何多餘的空格，請選取最上層的
    「屬性」
     檢視
    schema
     元素從
    填補
     下拉清單中選取
    +
    。儲存結構描述。