逐步解說:從文件執行個體建立一般檔案結構描述
此逐步解說為您顯示如何根據下列範例訂單,使用 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
啟動精靈
在 Visual Studio 中,開啟方案總管。
若要新增一般檔案架構,請以滑鼠右鍵按一下專案,然後選取 [ 新增]。 按一下 [新增專案]。
在 [ 新增專案] 視窗中,執行下列動作:
在 [ 類別] 區段中,選取 [ 架構檔案]。
在 [ 範本] 區段中,選取 [一般檔案架構精靈]。
在 [ 名稱] 欄位中,輸入新架構的 PurchaseOrder.xsd 。
按一下 [新增]。
當 BizTalk 一般檔案結構描述精靈開啟時,會出現歡迎頁面。
若要在未來執行精靈時略過此畫面,請選取 [不要再次顯示此簡介頁面 ] 方塊。 選取 [下一步] 以繼續操作。
選取採購單實例
在 [一般檔案結構描述資訊] 畫面上,選取您的執行個體,然後輸入下列資訊。 完成時,按一下 [下一步] 繼續進行。
執行個體檔案:按一下 [瀏覽] 按鈕,找到據以產生結構描述的一般檔案。 流覽至資料夾,其中包含您在逐步解說:從檔實例建立一般檔案架構的必要條件一節中建立的文字檔。
記錄名稱: 輸入 PO ,因為它會是架構根名稱。
目標命名空間:http://Flat_File_Project.PurchaseOrder架構目標命名空間的類型。
字碼頁: 從下拉式選取清單中選取 UTF-8 (65001) 。
以位元組為單位計算位置: 如果您想要依位元組計算位置資料欄位,請核取此方塊。 依預設值,位置資料欄位會以字元為單位計算。 在此逐步解說中,取消核取 [ 以位元組為單位計算位置] 核取方塊。
選取採購單資料
[選取文件資料] 畫面上會顯示一般檔案的內容。 選取建立結構描述所需的資料,然後按一下 [下一步]。
注意
如果您想要使用整個檔實例,您可以按 Ctrl-A 以選取全部。
注意
如果您想要檢視整個檔實例內容包裝在精靈中的編輯方塊中,請核取 [ 換行長行 ] 方塊。
注意
如果您從交換執行個體建立結構描述,只要選取表示個別文件結構的部分。
分隔採購單記錄
- 當採購單的每一行以歸位字元換行字元結尾 (CRLF) ,請選取[依據分隔符號符號],然後按 [選取記錄格式] 畫面上的 [下一步]。
指定採購單記錄屬性
在 [分隔記錄] 畫面中,輸入下列項目,定義第一層結構描述,完成時按一下 [下一步]。
子分隔符號: 選取 {CR}{LF}。
注意
[子分隔符號] 屬性是具有下拉式選擇清單的可編輯方塊,清單中包含一組預設值。 [子分隔符號] 可以指定為字元或十六進位值。 例如 \{ 或 {0x0D0A}。
逸出字元:逸出字元是單一字元,用來抑制跟隨在它後面之字元的任何特殊意義。 如需詳細資訊,請參閱 逸出字元 。 在此逐步解說中,將它留白。
注意
針對子分隔符號或逸出字元使用 \ 、 {和}時,必須使用反斜線。 例如 \\ 和 \{。
核取[記錄] 具有標籤識別碼方塊,並在[標記] 中輸入PO。 在多個記錄檔中, PO 將用來識別每個個別記錄。 選取 [下一步] 以繼續操作。
在採購單記錄中定義專案
精靈已在訂單記錄中識別四個項目;您現在必須定義項目屬性。 在第一個資料列中,執行下列動作:
輸入專案名稱的日期。
針對[元素類型] 選取[欄位] 元素。
從 [資料類型] 的下拉式選取清單中選取日期。
對下列項目重複步驟 a 到 c。 完成之後,按 [下一步]。
元素名稱 項目類型 資料類型 客戶 重複記錄 忽略 items 記錄 注意
您可以選取多個資料列,然後使用滑鼠和 SHIFT 或 CTRL 鍵將其 [元素類型] 變更為單一類型。
注意
在 [子元素] 畫面上按一下 [下一步] 之後,就無法再按 [上一步] 重新定義或變更子元素。 您可能必須關閉精靈再加以重新啟動,以定義一般檔案結構描述。
當您完成此程序中的步驟之後,就會產生結構描述的第一個層級,如下列擷取畫面所示。 至此已定義三個唯一元素,而您將繼續進一步為訂單記錄中的元素定義子記錄。 按一下 [下一步]。
定義客戶記錄
由於我們已將customer元素定義為[重複記錄類型],並將 items 元素定義為[記錄類型],所以 BizTalk 一般檔案架構精靈現在會繼續進一步定義這兩個元素。 在 [ 架構檢視 ] 畫面上,選取 客戶,然後按 [ 下一步 ] 繼續。
若要使用客戶記錄,您必須選取代表該元素的資料。 由於這是重複記錄,因此其中一行可用來定義記錄。 請選取客戶資料的第一行,然後按 [下一步] 繼續作業。
在 [選取記錄格式] 頁面上,選取 [依相對位置],然後按 [下一步]。
精靈會提供視覺化工具,用以顯示及計算欄位之間的距離。 在 [ 位置記錄 ] 頁面上,使用滑鼠左鍵按一下位置標記 10 來代表名稱欄位的開始位置。 按一下以下位置標記,可顯示其餘資料欄位:
欄位名稱 位置標記 街道 30 城市 50 狀態 65 postalcode 68 選取 [下一步] 以繼續操作。
在 [子元素] 頁面上,您可以指定子元素的屬性。 選取第一個資料列,然後輸入 國家/地區 作為 元素名稱。 請保留其他資料行中的預設值。 針對 專案名稱的其他屬性輸入下列值:
元素名稱 值 customer_Child2 fullName customer_Child3 街 customer_Child4 city customer_Child5 state customer_Child6 郵遞區號 選取 [下一步] 以繼續操作。
客戶記錄的子項目會被建立,如下列擷取畫面所示。 按 [下一步] 可定義項目記錄的子元素。
定義專案記錄
在 [結構描述檢視] 頁面上,選取 items,然後按 [下一步] 繼續作業。
在 [ 選取檔資料] 頁面上,選取整個行的開頭為 ITEMS,然後按 [ 下一步 ] 來定義其子項目。
在 [選取記錄格式] 頁面上,選取 [依分隔符號],然後按一下 [下一步]。
在項目記錄中,會使用逗號來分隔每個項目。 因此,請在 [分隔記錄] 頁面上輸入下列項目,以定義項目記錄。 完成之後,按 [下一步]。
在 [子分隔符號] 下拉式選擇清單中,選取 ,。
將 [逸出字元] 文字方塊保留空白。
選取[記錄] 具有標籤識別碼,並在[標記] 中輸入ITEMS。
在多個專案記錄中, ITEMS 是用來識別每個個別記錄。
精靈會使用 [分隔記錄] 頁面中的值來識別兩個子元素。 由於其中之一是重複記錄,因此請選取第一個元素,然後輸入 item 作為 [元素名稱],然後從下拉式選擇清單中選取 [重複記錄],作為 [元素類型]。 請保留資料行中其餘的預設值。 選取第二個資料列,然後從 [元素類型] 清單中選取 [忽略]。 當您按 [下一步] 時,將會在結構描述中建立項目記錄的下一個層級。 您將繼續定義訂單結構描述的最終部分。
選取 專案 ,然後按 [ 下一步] 繼續在 [ 架構檢視 ] 頁面上。
在 [選取文件資料] 頁面上,選取 [ITEM872-AA|割草機|1|148.95|確認這是電動]。 選取 [下一步] 以繼續操作。
在 [選取記錄格式] 頁面上,選取 [依分隔符號] 選項,因為個別項目會以垂直號 (|) 分隔。
在 [分隔記錄] 頁面上輸入下列項目,以定義項目記錄。 完成之後,按 [下一步]。
從[子分隔符號]下拉式清單選取範圍清單中選取 | 。
將 [逸出字元] 文字方塊保留空白。
在 [子元素] 頁面上,精靈已識別五個子元素。 選取第一個資料列,然後針對[元素名稱] 輸入productCode。 請保留其餘資料行中的預設值。 針對 [ 元素名稱] 屬性的其餘部分,輸入下列內容:
元素名稱 值 item_Child2 description item_Child3 quantity item_Child4 unitPrice item_Child5 筆記 選取 [下一步] 以繼續操作。
您已定義訂單結構描述的所有節點。 在 [結構描述檢視] 頁面上,按一下 [完成]。
您現在可以檢視最後的訂單結構描述。 您也可以使用 BizTalk 結構描述編輯器修改此結構描述。 請參閱一般檔案屬性名稱資料表和 架構節點屬性中的屬性資料表。 如需有關此屬性的詳細資訊,請參閱 UI 指引和開發人員 API 命名空間參考。
摘要
在此逐步解說中,您學習到如何使用 BizTalk 一般檔案結構描述精靈,從文件執行個體建立一般檔案結構描述。
後續步驟
驗證 PO 實例
若要確定 PurchaseOrder.xsd 結構描述可以正確剖析 PO 執行個體,請執行下列動作:
在 方案總管中,以滑鼠右鍵按一下PurchaseOrder.xsd,然後選取 [屬性]。
在 [屬性頁] 中,確定 [ 輸入實例檔案名 ] 欄位指向您在逐步解說:從檔實例建立一般檔案架構的必要條件一節中建立的 PO 實例位置。 按一下 [確定] 關閉對話方塊。
在 方案總管中,以滑鼠右鍵按一下[PurchaseOrder.xsd],然後選取 [驗證實例]。 驗證元件就會開啟。
驗證完成後,會提供一個連結,讓您根據使用 PurchaseOrder.xsd 結構描述所得到的 PO 執行個體剖析結果來檢視 XML 輸出。 若要檢視 XML 輸出,請按住 Ctrl 並按一下該連結。
建立架構的管線
現在您可根據 PurchaseOrder.xsd 結構描述建立接收或傳送管線,以搭配 BizTalk 應用程式使用。
若要建立新的管線,請參閱 如何建立新的管線。 若要設定一般檔案管線元件,請參閱 如何設定一般檔案組合器管線元件 和 如何設定一般檔案反組譯程式管線元件。