共用方式為


逐步解說:從文件執行個體建立一般檔案結構描述

此逐步解說為您顯示如何根據下列範例訂單,使用 BizTalk 一般檔案結構描述精靈從文件執行個體建立一般檔案結構描述。 如需 BizTalk 一般檔案架構精靈的簡介,請參閱 如何使用 BizTalk 一般檔案架構精靈

範例採購單

訂單的每一行都會以換行字元 (CRLF) 結尾 (以綠色標示)。 訂單會以紅色顯示的 PO 標記開頭,其後為日期。 兩個重複的固定位置欄位會包含客戶資訊,並以紫色顯示。 在註解欄位後面會有以 ITEMS 標記開頭的重複欄位,內含多筆以逗號 (,) 分隔的記錄和以垂直號 (|) 分隔的資料值 (以藍色顯示)。

必要條件

執行此逐步解說之前,請確定已在您的伺服器上安裝和設定下列軟體:

  • Microsoft Visual Studio

  • 已安裝開發人員工具的 Microsoft BizTalk Server

    若要準備逐步解說的檔實例,請將下列內容複寫到文字編輯器中,並將其儲存為文字檔。 請務必複製所有換行字元和歸位字元。

PO1999-10-20
US        Alice Smith         123 Maple Street    Mill Valley    CA 90952
US        Robert Smith        8 Oak Avenue        Old Town       PA 95819
ITEMS,ITEM872-AA|Lawnmower|1|148.95|Confirm this is electric,ITEM926-AA|Baby Monitor|1|39.98|Confirm this is electric

啟動精靈

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

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

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

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

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

    3. 在 [ 名稱] 欄位中,輸入新架構的 PurchaseOrder.xsd

    4. 按一下 [新增]。

  4. 當 BizTalk 一般檔案結構描述精靈開啟時,會出現歡迎頁面。
    若要在未來執行精靈時略過此畫面,請選取 [不要再次顯示此簡介頁面 ] 方塊。 選取 [下一步] 以繼續操作。

選取採購單實例

  • [一般檔案結構描述資訊] 畫面上,選取您的執行個體,然後輸入下列資訊。 完成時,按一下 [下一步] 繼續進行。

    • 執行個體檔案:按一下 [瀏覽] 按鈕,找到據以產生結構描述的一般檔案。 流覽至資料夾,其中包含您在逐步解說:從檔實例建立一般檔案架構的必要條件一節中建立的文字檔。

    • 記錄名稱: 輸入 PO ,因為它會是架構根名稱。

    • 目標命名空間:http://Flat_File_Project.PurchaseOrder架構目標命名空間的類型。

    • 字碼頁: 從下拉式選取清單中選取 UTF-8 (65001)

    • 以位元組為單位計算位置: 如果您想要依位元組計算位置資料欄位,請核取此方塊。 依預設值,位置資料欄位會以字元為單位計算。 在此逐步解說中,取消核取 [ 以位元組為單位計算位置] 核取方塊。

選取採購單資料

  • [選取文件資料] 畫面上會顯示一般檔案的內容。 選取建立結構描述所需的資料,然後按一下 [下一步]

    注意

    如果您想要使用整個檔實例,您可以按 Ctrl-A 以選取全部。

    注意

    如果您想要檢視整個檔實例內容包裝在精靈中的編輯方塊中,請核取 [ 換行長行 ] 方塊。

    注意

    如果您從交換執行個體建立結構描述,只要選取表示個別文件結構的部分。

分隔採購單記錄

  • 當採購單的每一行以歸位字元換行字元結尾 (CRLF) ,請選取[依據分隔符號符號],然後按 [選取記錄格式] 畫面上的 [下一步]。

指定採購單記錄屬性

  • [分隔記錄] 畫面中,輸入下列項目,定義第一層結構描述,完成時按一下 [下一步]

    • 子分隔符號: 選取 {CR}{LF}

      注意

      [子分隔符號] 屬性是具有下拉式選擇清單的可編輯方塊,清單中包含一組預設值。 [子分隔符號] 可以指定為字元或十六進位值。 例如 \{{0x0D0A}

    • 逸出字元:逸出字元是單一字元,用來抑制跟隨在它後面之字元的任何特殊意義。 如需詳細資訊,請參閱 逸出字元 。 在此逐步解說中,將它留白。

      注意

      針對子分隔符號逸出字元使用 \{和}時,必須使用反斜線。 例如 \\\{

    • 核取[記錄] 具有標籤識別碼方塊,並在[標記] 中輸入PO。 在多個記錄檔中, PO 將用來識別每個個別記錄。 選取 [下一步] 以繼續操作。

      分隔的 [記錄] 畫面

在採購單記錄中定義專案

  1. 精靈已在訂單記錄中識別四個項目;您現在必須定義項目屬性。 在第一個資料列中,執行下列動作:

    1. 輸入專案名稱日期

    2. 針對[元素類型] 選取[欄位] 元素

    3. 從 [資料類型] 的下拉式選取清單中選取日期

  2. 對下列項目重複步驟 a 到 c。 完成之後,按 [下一步]。

    元素名稱 項目類型 資料類型
    客戶 重複記錄
    忽略
    items 記錄

    子項目畫面

    注意

    您可以選取多個資料列,然後使用滑鼠和 SHIFT 或 CTRL 鍵將其 [元素類型] 變更為單一類型。

    注意

    [子元素] 畫面上按一下 [下一步] 之後,就無法再按 [上一步] 重新定義或變更子元素。 您可能必須關閉精靈再加以重新啟動,以定義一般檔案結構描述。

  3. 當您完成此程序中的步驟之後,就會產生結構描述的第一個層級,如下列擷取畫面所示。 至此已定義三個唯一元素,而您將繼續進一步為訂單記錄中的元素定義子記錄。 按一下 [下一步]。

    顯示架構第一層的影像。

定義客戶記錄

  1. 由於我們已將customer元素定義為[重複記錄類型],並將 items 元素定義為[記錄類型],所以 BizTalk 一般檔案架構精靈現在會繼續進一步定義這兩元素。 在 [ 架構檢視 ] 畫面上,選取 客戶,然後按 [ 下一步 ] 繼續。

  2. 若要使用客戶記錄,您必須選取代表該元素的資料。 由於這是重複記錄,因此其中一行可用來定義記錄。 請選取客戶資料的第一行,然後按 [下一步] 繼續作業。

  3. 在 [選取記錄格式] 頁面上,選取 [依相對位置],然後按 [下一步]

  4. 精靈會提供視覺化工具,用以顯示及計算欄位之間的距離。 在 [ 位置記錄 ] 頁面上,使用滑鼠左鍵按一下位置標記 10 來代表名稱欄位的開始位置。 按一下以下位置標記,可顯示其餘資料欄位:

    欄位名稱 位置標記
    街道 30
    城市 50
    狀態 65
    postalcode 68

    選取 [下一步] 以繼續操作。

    位置記錄畫面

  5. 在 [子元素] 頁面上,您可以指定子元素的屬性。 選取第一個資料列,然後輸入 國家/地區 作為 元素名稱。 請保留其他資料行中的預設值。 針對 專案名稱的其他屬性輸入下列值:

    元素名稱
    customer_Child2 fullName
    customer_Child3
    customer_Child4 city
    customer_Child5 state
    customer_Child6 郵遞區號

    選取 [下一步] 以繼續操作。

    顯示 [子項目] 畫面的影像。

  6. 客戶記錄的子項目會被建立,如下列擷取畫面所示。 按 [下一步] 可定義項目記錄的子元素。

    顯示客戶記錄子項目的影像。

定義專案記錄

  1. 在 [結構描述檢視] 頁面上,選取 items,然後按 [下一步] 繼續作業。

  2. 在 [ 選取檔資料] 頁面上,選取整個行的開頭為 ITEMS,然後按 [ 下一步 ] 來定義其子項目。

  3. [選取記錄格式] 頁面上,選取 [依分隔符號],然後按一下 [下一步]

  4. 在項目記錄中,會使用逗號來分隔每個項目。 因此,請在 [分隔記錄] 頁面上輸入下列項目,以定義項目記錄。 完成之後,按 [下一步]。

    • 在 [子分隔符號] 下拉式選擇清單中,選取 ,

    • [逸出字元] 文字方塊保留空白。

    • 選取[記錄] 具有標籤識別碼,並在[標記] 中輸入ITEMS

      在多個專案記錄中, ITEMS 是用來識別每個個別記錄。

  5. 精靈會使用 [分隔記錄] 頁面中的值來識別兩個子元素。 由於其中之一是重複記錄,因此請選取第一個元素,然後輸入 item 作為 [元素名稱],然後從下拉式選擇清單中選取 [重複記錄],作為 [元素類型]。 請保留資料行中其餘的預設值。 選取第二個資料列,然後從 [元素類型] 清單中選取 [忽略]。 當您按 [下一步] 時,將會在結構描述中建立項目記錄的下一個層級。 您將繼續定義訂單結構描述的最終部分。

  6. 選取 專案 ,然後按 [ 下一步] 繼續在 [ 架構檢視 ] 頁面上。

  7. 在 [選取文件資料] 頁面上,選取 [ITEM872-AA|割草機|1|148.95|確認這是電動]。 選取 [下一步] 以繼續操作。

  8. 在 [選取記錄格式] 頁面上,選取 [依分隔符號] 選項,因為個別項目會以垂直號 (|) 分隔。

  9. 在 [分隔記錄] 頁面上輸入下列項目,以定義項目記錄。 完成之後,按 [下一步]。

    • [子分隔符號]下拉式清單選取範圍清單中選取 |

    • [逸出字元] 文字方塊保留空白。

  10. 在 [子元素] 頁面上,精靈已識別五個子元素。 選取第一個資料列,然後針對[元素名稱] 輸入productCode。 請保留其餘資料行中的預設值。 針對 [ 元素名稱] 屬性的其餘部分,輸入下列內容:

    元素名稱
    item_Child2 description
    item_Child3 quantity
    item_Child4 unitPrice
    item_Child5 筆記

    選取 [下一步] 以繼續操作。

  11. 您已定義訂單結構描述的所有節點。 在 [結構描述檢視] 頁面上,按一下 [完成]

  12. 您現在可以檢視最後的訂單結構描述。 您也可以使用 BizTalk 結構描述編輯器修改此結構描述。 請參閱一般檔案屬性名稱資料表和 架構節點屬性中的屬性資料表。 如需有關此屬性的詳細資訊,請參閱 UI 指引和開發人員 API 命名空間參考

摘要

在此逐步解說中,您學習到如何使用 BizTalk 一般檔案結構描述精靈,從文件執行個體建立一般檔案結構描述。

後續步驟

驗證 PO 實例

若要確定 PurchaseOrder.xsd 結構描述可以正確剖析 PO 執行個體,請執行下列動作:

  1. 在 方案總管中,以滑鼠右鍵按一下PurchaseOrder.xsd,然後選取 [屬性]。

  2. [屬性頁] 中,確定 [ 輸入實例檔案名 ] 欄位指向您在逐步解說:從檔實例建立一般檔案架構的必要條件一節中建立的 PO 實例位置。 按一下 [確定] 關閉對話方塊。

  3. 在 方案總管中,以滑鼠右鍵按一下[PurchaseOrder.xsd],然後選取 [驗證實例]。 驗證元件就會開啟。

  4. 驗證完成後,會提供一個連結,讓您根據使用 PurchaseOrder.xsd 結構描述所得到的 PO 執行個體剖析結果來檢視 XML 輸出。 若要檢視 XML 輸出,請按住 Ctrl 並按一下該連結。

建立架構的管線

現在您可根據 PurchaseOrder.xsd 結構描述建立接收或傳送管線,以搭配 BizTalk 應用程式使用。

若要建立新的管線,請參閱 如何建立新的管線。 若要設定一般檔案管線元件,請參閱 如何設定一般檔案組合器管線元件如何設定一般檔案反組譯程式管線元件

另請參閱

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