共用方式為


如何使用 BizTalk 一般檔案結構描述精靈

在舊版 BizTalk Server 中,您必須在 BizTalk 結構描述編輯器中手動將註解新增至 XML 結構描述定義語言 (XSD) 結構描述,讓這些結構描述可被「一般檔案管線」元件所瞭解,例如一般檔案解譯器和一般檔案組合器。 您仍然可以使用BizTalk Server架構編輯器來執行此動作。 若要減少手動步驟的次數以及建立方案所需的時間,您可使用 BizTalk 一般檔案結構描述精靈,此精靈提供下列功能:

  • 使用真正的一般檔案執行個體做為輸入。

  • 包含視覺化設計介面,可處理分隔和位置一般檔案結構描述。

  • 使用可重新進入的精靈程序,可新增項目至結構描述和以互動方式定義一般檔案的相關註解。

  • 提供標記識別項和字元以及十六進位分隔符號的支援。

  • 自動決定標記識別線偏移以及子分隔順序。

  • 提供檔案格式的預覽功能。

  • 可讓您在交換執行個體中選取要用來定義一般檔案結構描述的慣用子資料。

如何啟動 BizTalk 一般檔案結構描述精靈

您可從 Microsoft Visual Studio [方案總管] 或 BizTalk 結構描述編輯器啟動此精靈。

從方案總管啟動此精靈

  1. 在 Microsoft Visual Studio 中,開啟方案總管

  2. 若要新增一般檔案架構,請以滑鼠右鍵按一下 BizTalk 專案,然後選取 [ 新增]。

  3. 按一下 [新增專案]。

    方案總管功能表

  4. 在 [ 新增專案] 視窗中,執行下列動作:

    1. 在 [ 類別] 區段中,選取 [ 架構檔案]。

    2. 在 [ 範本] 區段中,選取 [一般檔案架構精靈]。

    3. 在 [ 名稱] 文字方塊中,輸入新架構的名稱。

    4. 按一下 [新增]。

      BizTalk 一般檔案結構描述精靈會開啟。

從結構描述編輯器啟動此精靈

  1. 在 Visual Studio 中,開啟方案總管

  2. 若要新增一般檔案架構,請以滑鼠右鍵按一下 BizTalk 專案,然後選取 [ 新增]。 選取 [新增專案 ],然後按一下 [ 新增專案]。

  3. 在 [ 新增專案] 視窗中,執行下列動作:

    1. 在 [ 類別] 區段中,選取 [ 架構檔案]。

    2. 在 [ 範本] 區段中,選取 [一般檔案架構]。

    3. 在 [ 名稱] 文字方塊中,輸入新架構的名稱。

    4. 按一下 [新增]。

    5. 以滑鼠右鍵按一下 [根] ,然後 從一般檔案實例選取 [定義記錄]。

      BizTalk 一般檔案結構描述精靈現在會啟動。

注意

如果您在架構編輯器中開啟工作架構,只需要以滑鼠右鍵按一下選取的節點,然後 從一般檔案實例選取 [定義記錄]。

注意

如果選取的節點是沒有子項目的記錄,則會啟用 [從一般檔案實例定義記錄 ] 選項。 如果選取的節點包含子項目,此精靈就會刪除目前所有的子項目,然後產生新的子項目。 在刪除現有的子項目之前,精靈會先提示您進行確認。

使用一般檔案結構描述精靈的考量

此節描述在使用 BizTalk 一般檔案結構描述精靈時,您應考量的問題。

使用多位元組字元集 (MBCS)

根據預設,[一般檔案架構資訊] 畫面上未核取 [ 以位元組為單位的計數位置 ] 核取方塊。 精靈會以字元為單位計算位置;也就是說,如果在位置一般檔案執行個體中有 MBCS 字元,位置就無法被正確計算。 藉由選取 [ 以位元組為單位計算位置] 核取方塊,精靈會顯示 MBCS 字元,並顯示其位置長度的額外指示。 字元會在顯示器上接受一個位置,而剩餘的長度會填入點符號 「•」。 所填入的點號數量將取決於以雙位元組字元集 (DBCS)、Unicode 或 UTF-8 格式儲存的檔案。

一般檔案結構描述精靈中支援的字碼頁

以下是此精靈支援的字碼頁清單:

  • 阿拉伯文 (1256)

  • ASCII (20127)

  • 波羅的海文 (1257)

  • Big-Endian-UTF16 (1201)

  • 中歐語系 (1250)

  • 斯拉夫文 (1251)

  • 希臘文 (1253)

  • 希伯來文 (1255)

  • 日文 (Shift-JIS) (932)

  • 韓文 (949)

  • Little-Endian-UTF16 (1200)

  • 簡體中文 (GBK) (936)

  • 簡體中文 (GB18030) (54936)

  • 泰文 (874)

  • 繁體中文 (Big5) (950)

  • 土耳其文 (1254)

  • UTF-7 (65000)

  • UTF-8 (65001)

  • 越南文 (1258)

  • 西歐語系 (1252)

一般檔案結構描述精靈中的記錄類型

一般檔案在位置記錄中不可包含分隔記錄。 由於精靈是以重新進入為基礎,因此會根據您在精靈中定義子系之子系的父記錄格式,啟用或停用定義 By 分隔符號符號 和 By 相對位置 類型的選項按鈕。 例如

  • 如果精靈是對分隔記錄的子系執行,則兩個選項按鈕都會被選取。

  • 如果精靈針對位置記錄的子系執行,則會清除 [依分隔符號符號 ] 選項按鈕。

一般檔案結構描述精靈中的分隔符號

子分隔符號屬性下拉式清單包含下列常見的分隔符號:

  • {CR}{LF}

  • {CR}

  • {LF}

  • {TAB}

  • {SPACE}

  • {0x1A}

  • |

  • ,

  • ;

    此屬性的預設值為 {CR}{LF}。 此屬性也是一個可編輯的文字方塊,可讓您指定子分隔符號做為字元序列或字元的十六進位值。 使用子分隔符號的字元範例為 「a」 或 「street」。十六進位分隔符號是使用下列格式來指定:

  • {0xnnnn}。 例如,{0x0D}{0x0A}、{0x09} 或 {0x20}。

    使用十六進位值序列的範例為 {0x0D}{0x0A}、{0x09}{0x20}。

    如果您使用 \、{ 或 } 做為分隔符號,您必須取代分隔符號之前的額外反斜線符號,否則您會收到錯誤訊息。 例如

  • \\、\{ 或 \}。

一般檔案結構描述精靈中的相對位置

設定位置標記

使用滑鼠左鍵按一下位置選取方塊中的位置標記,以設定新的位置標記線。 位置標記會以實線表示。 依照預設,位置標記行是在位置零的記錄開頭。 若要移除現有的位置標記線,請使用滑鼠左鍵按一下它。

一般檔案結構描述精靈中的逸出字元

逸出字元是單一字元,用來抑制跟隨在它後面之字元的任何特殊意義。 如需詳細資訊,請參閱將特殊字元解譯為域值的一部分下方的逸出字元主題。 您可在精靈中使用逸出字元,以指定在剖析一般檔案執行個體時要使用的逸出字元。 預設值為空值,表示會使用在結構描述層級所指定的預設逸出字元。

逸出字元可指定為字元或十六進位值。 十六進位值使用下列格式指定:

  • {0xnnnn}。 例如,{0x0D}{0x0A}、{0x09} 或 {0x20}。

    如果您使用 \、{ 或 } 做為逸出字元,您必須取代分隔符號之前的額外反斜線符號,否則您會收到錯誤訊息。例如,

  • \\, \{, \}.

一般檔案結構描述精靈中的子項目

每個子項目都包含 專案名稱元素類型資料類型內容。 您可以使用 [ 元素名稱] 文字方塊,為節點輸入有意義的名稱。 元素類型是具有下列值的下拉式清單:

  • Field 元素:指定此節點將會在架構中建立為 元素。

  • 欄位屬性:指定此節點將會在架構中建立為屬性。

  • 記錄:指定在架構中建立不含子系的記錄。

  • 重複記錄:指定在架構中建立沒有子系的記錄,且其最大出現次數設定為 Unbounded

  • 忽略:此節點的架構中不會建立任何專案。

    根據預設,所有元素的類型都是 Field 元素 ,而其資料類型為 字串

注意

只有當子專案宣告為Field 元素RecordRepeating 記錄之前沒有子系時,才可以宣告為Field 屬性

注意

您會在下列實例的 子節點 前面看到驚嘆號:

  • Field 屬性定義于Field 元素、RecordRepeating 記錄之後。

  • 此子項目沒有名稱。

  • 此子項目有重複的名稱。

  • 子項目的選定資料類型不適合內容。

另請參閱

BizTalk 一般檔案結構描述精靈逐步解說