共用方式為


如何:將文字文件轉換成 XML,並使用路線傳閱名單路由至檔案位置

目標

本節示範如何建立管線,將文字檔轉換成 XML,然後選取適當的路線,並將訊息路由至 FILE 位置。

在此操作說明主題中,您將完成下列步驟:

  • 使用管線接收一般檔案檔,並將其轉換成 XML。

  • 設定路線選取器管線元件,以解決適當的傳閱名單。

  • 建立使用自訂管線的遞增。

  • 測試一般檔案訊息的路線型路由。

必要條件

本操作說明主題中的程式需要完成 開發活動的必要條件

開始之前

請先完成下列工作,再執行本操作說明主題稍後的步驟:

  • 部署 DataFormatTransformation 路線。

  • 建立測試訊息。

    下列程式說明如何執行這些動作。

部署 DataFormatTransformation 路線

  1. 在 Visual Studio 中,開啟 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln。

  2. 在方案總管,在 [行程][程式庫] 專案中,按兩下[DataFormatTransformation.itinerary],在 [路線] Designer中開啟。

  3. 在 Visual Studio 中,按一下 DataFormatTransformation.itinerary的設計介面。 在DataFormatTransformation.itinerary屬性視窗中,設定下列屬性:

    1. 在 [ 路線狀態 ] 下拉式清單中,按一下 [已部署]。

    2. 在 [ 模型匯出工具 ] 下拉式清單中,按一下 [資料庫路線匯出工具]。

    3. 按一下 [路線資料庫 ] 屬性旁的省略號按鈕 (...) 。

    4. 在 [連線屬性] 對話方塊中,選擇裝載路線存放庫資料庫的SQL Server,然後指定資料庫名稱, (預設名稱為EsbItineraryDb) 。

  4. 儲存所有專案成品。

  5. 在 Visual Studio 中,以滑鼠右鍵按一下 DataModelTransformation 路線的設計介面,然後按一下 [ 匯出模型]。

建立接收管線

  1. 在 Visual Studio 中,以滑鼠右鍵按一下[DataFormatTransformation.Schemas],然後按一下 [屬性]。 按一下[應用程式],然後在 [元件名稱] 方塊中輸入GlobalBank.ESB.DataFormatTransformation.Schemas

  2. 以滑鼠右鍵按一下 [DataFormatTransformation.Schemas],然後按一下 [ 屬性]。 按一下 [簽署],然後確認已選取 [ 簽署元件 ] 核取方塊,且元件位置指向 .\。\..\..\..\..\keys\Microsoft.Practices.ESB.snk

  3. 以滑鼠右鍵按一下 [DataFormatTransformation.Pipelines],然後按一下 [ 移除]。

  4. 以滑鼠右鍵按一下 [DataFormatTransformation],指向 [ 新增],然後按一下 [ 新增專案]。 按一下 [Biztalk 專案],然後按一下 [ 空白 Biztalk Server 專案]。 在 [ 名稱] 方塊中,輸入 DataFormatTransformationReceive.Pipeline

  5. 以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],然後按一下 [ 屬性]。 按一下 [ 簽署],然後確認已選取 [ 簽署元件 ] 核取方塊,且元件位置指向 C:\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk

  6. 以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],指向 [ 新增],然後按一下 [ 新增專案]。

  7. 在 [ 新增專案 ] 對話方塊中,按一下 [範本] 窗格中的 [ 接收管線 ]。 在 [ 名稱] 方塊中,輸入 ItinerarySelectReceiveFF,然後按一下 [ 新增]。

  8. 以滑鼠按右鍵 DataFormatTransformationReceive.Pipeline 專案的 [參考],然後按一下 [加入參考]。 按一下 [ 專案] 索引 標籤,然後按一下 [DataFormatTransformation.Schemas]。 按一下 [確定 ] 以新增參考。

  9. 從 [工具箱] 中,將一 般檔案反組譯程式 管線元件拖曳至管線的 可反組譯 階段。

  10. 在一般檔案反組譯的屬性視窗中,按一下[檔架構] 下拉式清單中的[DataModelTransformation.Schemas.NAOrderDocFF]。

  11. 從 [工具箱] 中,將 ESB 路線選取器 管線元件拖曳至管線的 解決方 階段。

  12. 從 [工具箱] 中,將 ESB 發送器 管線元件拖曳至管線的 解析方 階段,然後將它放在 ESB 路線選取器 管線元件之下。

  13. 儲存所有專案成品。

建立測試訊息

  1. 在 DataFormatTransformation.Schemas 專案的 NAOrderDocFF.xsd 架構檔案中按一下一次。 在 Visual Studio 的 [屬性] 窗格中,變更下列兩個屬性:

    • 產生實例輸出類型。 按一下此屬性的下拉式清單,將它變更為 [原生]。

    • 輸出實例檔案名。 按一下此屬性的省略號按鈕 (...) ,並接受 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 的預設路徑。 在 [ 檔案名] 方塊中,輸入 NAOrderDocFF,然後按一下 [ 儲存]。

  2. 以滑鼠右鍵按一下[DataFormatTransformation.Schemas] 底下的[NAOrderDocFF.xsd],然後按一下 [產生實例]。 此時,您應該會在 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 目錄中產生新的檔案。

  3. 複製 (不會將) 檔案 NAOrderDocFF.txt 從 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 移至 C:\HowTos。

    注意

    這是您將接收並轉換成 XML 的訊息。 本檔代表北美洲訂單檔的一般檔案版本。

步驟

部署接收管線和架構

  1. 以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],然後按一下 [ 屬性]。 按一下[部署],然後在 [應用程式名稱] 方塊中輸入Microsoft.Practices.ESB

  2. 以滑鼠右鍵按一下 DataFormatTransformation.Schemas 專案,然後按一下 [ 屬性]。 按一下[部署],然後在 [應用程式名稱] 方塊中輸入Microsoft.Practices.ESB

  3. 關閉 DataFormatTransformationReceive.PipelineDataFormatTransformation.Schemas的 [屬性] 窗格。

  4. 在方案總管中,以滑鼠右鍵按一下DataFormatTransformation專案,然後按一下 [部署方案]。

若要建立和設定 ESB On-Ramp

  1. 按一下工作列上的 [開始],指向 [所有程式],指向[BizTalk Server],然後按一下[BizTalk Server管理]。

  2. 在 BizTalk Server 管理主控台中,依序展開[BizTalk 群組]、[應用程式] 和 [Microsoft.Practices.ESB]。

  3. 以滑鼠右鍵按一下 [接收位置],指向 [ 新增],然後按一下 [單向接收位置]。

  4. 在 [ 選取接收埠 ] 對話方塊中,按一下 [OnRamp.Itinerary],然後按一下 [ 確定]。

  5. 在 [ 接收位置屬性 ] 對話方塊的 [ 名稱 ] 方塊中,輸入 OnRamp.Itinerary.FlatFile.FILE

  6. 在 [ 類型] 下拉式清單中,按一下 [ 檔案],然後按一下 [ 設定]。

  7. 在 [ 檔案傳輸屬性 ] 對話方塊的 [ 接收資料夾 ] 方塊中,輸入 C:\HowTos\DropFolder

  8. 在 [ 檔案傳輸屬性 ] 對話方塊的 [ 檔案遮罩 ] 方塊中,輸入 *.txt,然後按一下 [ 確定]。

設定路線選取器管線元件

  1. 在 [接收位置屬性] 對話方塊中,按一下 [接收管線] 下拉式清單中的[路線][選取][ReceiveFF],然後按一下省略號按鈕 (...) 。

  2. 使用 [ 設定管線 ] 對話方塊來設定下列 路線選取器 元件屬性:

    1. 按一下 [行程][FactKey ] 屬性,然後輸入 Resolver.Itinerary

    2. 按一下 ResolverConnectionString 屬性,輸入 ITINERARY:\\name=DataFormatTransformation; 然後按一下 [ 確定]。

  3. 按一下 [確定 ] 關閉 [ 接收位置屬性 ] 對話方塊。

  4. 在 BizTalk Server 管理主控台中,以滑鼠右鍵按一下OnRamp.Itinerary.FlatFile.FILE接收位置,然後按一下 [啟用]。

測試一般檔案訊息的路線型路由

  1. 在 Windows 檔案總管中,流覽至 C:\HowTos。

  2. 複製 (不會將) NAOrderDocFF.txt 移至 C:\HowTos\DropFolder。

  3. 流覽至 C:\HowTos\Out。確認已將 DFT%MessageID%.xml 訊息寫入目錄。

  4. 在 BizTalk Server 管理主控台中,以滑鼠右鍵按一下OnRamp.Itinerary.FlatFile.FILE接收位置,然後按一下 [停用]。

  5. 停用 OnRamp.Itinerary.FlatFile.FILE 接收位置之後,以滑鼠右鍵按一下它,然後按一下 [ 刪除]。 在 [ 確認刪除接收位置 ] 對話方塊中,按一下 [ ]。

其他資源

如需詳細資訊,請參閱下列相關主題: