如何:將文字文件轉換成 XML,並使用路線傳閱名單路由至檔案位置
目標
本節示範如何建立管線,將文字檔轉換成 XML,然後選取適當的路線,並將訊息路由至 FILE 位置。
在此操作說明主題中,您將完成下列步驟:
使用管線接收一般檔案檔,並將其轉換成 XML。
設定路線選取器管線元件,以解決適當的傳閱名單。
建立使用自訂管線的遞增。
測試一般檔案訊息的路線型路由。
必要條件
本操作說明主題中的程式需要完成 開發活動的必要條件。
開始之前
請先完成下列工作,再執行本操作說明主題稍後的步驟:
部署 DataFormatTransformation 路線。
建立測試訊息。
下列程式說明如何執行這些動作。
部署 DataFormatTransformation 路線
在 Visual Studio 中,開啟 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln。
在方案總管,在 [行程][程式庫] 專案中,按兩下[DataFormatTransformation.itinerary],在 [路線] Designer中開啟。
在 Visual Studio 中,按一下 DataFormatTransformation.itinerary的設計介面。 在DataFormatTransformation.itinerary屬性視窗中,設定下列屬性:
在 [ 路線狀態 ] 下拉式清單中,按一下 [已部署]。
在 [ 模型匯出工具 ] 下拉式清單中,按一下 [資料庫路線匯出工具]。
按一下 [路線資料庫 ] 屬性旁的省略號按鈕 (...) 。
在 [連線屬性] 對話方塊中,選擇裝載路線存放庫資料庫的SQL Server,然後指定資料庫名稱, (預設名稱為EsbItineraryDb) 。
儲存所有專案成品。
在 Visual Studio 中,以滑鼠右鍵按一下 DataModelTransformation 路線的設計介面,然後按一下 [ 匯出模型]。
建立接收管線
在 Visual Studio 中,以滑鼠右鍵按一下[DataFormatTransformation.Schemas],然後按一下 [屬性]。 按一下[應用程式],然後在 [元件名稱] 方塊中輸入GlobalBank.ESB.DataFormatTransformation.Schemas。
以滑鼠右鍵按一下 [DataFormatTransformation.Schemas],然後按一下 [ 屬性]。 按一下 [簽署],然後確認已選取 [ 簽署元件 ] 核取方塊,且元件位置指向 .\。\..\..\..\..\keys\Microsoft.Practices.ESB.snk。
以滑鼠右鍵按一下 [DataFormatTransformation.Pipelines],然後按一下 [ 移除]。
以滑鼠右鍵按一下 [DataFormatTransformation],指向 [ 新增],然後按一下 [ 新增專案]。 按一下 [Biztalk 專案],然後按一下 [ 空白 Biztalk Server 專案]。 在 [ 名稱] 方塊中,輸入 DataFormatTransformationReceive.Pipeline。
以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],然後按一下 [ 屬性]。 按一下 [ 簽署],然後確認已選取 [ 簽署元件 ] 核取方塊,且元件位置指向 C:\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk。
以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],指向 [ 新增],然後按一下 [ 新增專案]。
在 [ 新增專案 ] 對話方塊中,按一下 [範本] 窗格中的 [ 接收管線 ]。 在 [ 名稱] 方塊中,輸入 ItinerarySelectReceiveFF,然後按一下 [ 新增]。
以滑鼠按右鍵 DataFormatTransformationReceive.Pipeline 專案的 [參考],然後按一下 [加入參考]。 按一下 [ 專案] 索引 標籤,然後按一下 [DataFormatTransformation.Schemas]。 按一下 [確定 ] 以新增參考。
從 [工具箱] 中,將一 般檔案反組譯程式 管線元件拖曳至管線的 可反組譯 階段。
在一般檔案反組譯的屬性視窗中,按一下[檔架構] 下拉式清單中的[DataModelTransformation.Schemas.NAOrderDocFF]。
從 [工具箱] 中,將 ESB 路線選取器 管線元件拖曳至管線的 解決方 階段。
從 [工具箱] 中,將 ESB 發送器 管線元件拖曳至管線的 解析方 階段,然後將它放在 ESB 路線選取器 管線元件之下。
儲存所有專案成品。
建立測試訊息
在 DataFormatTransformation.Schemas 專案的 NAOrderDocFF.xsd 架構檔案中按一下一次。 在 Visual Studio 的 [屬性] 窗格中,變更下列兩個屬性:
產生實例輸出類型。 按一下此屬性的下拉式清單,將它變更為 [原生]。
輸出實例檔案名。 按一下此屬性的省略號按鈕 (...) ,並接受 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 的預設路徑。 在 [ 檔案名] 方塊中,輸入 NAOrderDocFF,然後按一下 [ 儲存]。
以滑鼠右鍵按一下[DataFormatTransformation.Schemas] 底下的[NAOrderDocFF.xsd],然後按一下 [產生實例]。 此時,您應該會在 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 目錄中產生新的檔案。
複製 (不會將) 檔案 NAOrderDocFF.txt 從 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation 移至 C:\HowTos。
注意
這是您將接收並轉換成 XML 的訊息。 本檔代表北美洲訂單檔的一般檔案版本。
步驟
部署接收管線和架構
以滑鼠右鍵按一下 [DataFormatTransformationReceive.Pipeline],然後按一下 [ 屬性]。 按一下[部署],然後在 [應用程式名稱] 方塊中輸入Microsoft.Practices.ESB。
以滑鼠右鍵按一下 DataFormatTransformation.Schemas 專案,然後按一下 [ 屬性]。 按一下[部署],然後在 [應用程式名稱] 方塊中輸入Microsoft.Practices.ESB。
關閉 DataFormatTransformationReceive.Pipeline 和 DataFormatTransformation.Schemas的 [屬性] 窗格。
在方案總管中,以滑鼠右鍵按一下DataFormatTransformation專案,然後按一下 [部署方案]。
若要建立和設定 ESB On-Ramp
按一下工作列上的 [開始],指向 [所有程式],指向[BizTalk Server],然後按一下[BizTalk Server管理]。
在 BizTalk Server 管理主控台中,依序展開[BizTalk 群組]、[應用程式] 和 [Microsoft.Practices.ESB]。
以滑鼠右鍵按一下 [接收位置],指向 [ 新增],然後按一下 [單向接收位置]。
在 [ 選取接收埠 ] 對話方塊中,按一下 [OnRamp.Itinerary],然後按一下 [ 確定]。
在 [ 接收位置屬性 ] 對話方塊的 [ 名稱 ] 方塊中,輸入 OnRamp.Itinerary.FlatFile.FILE。
在 [ 類型] 下拉式清單中,按一下 [ 檔案],然後按一下 [ 設定]。
在 [ 檔案傳輸屬性 ] 對話方塊的 [ 接收資料夾 ] 方塊中,輸入 C:\HowTos\DropFolder。
在 [ 檔案傳輸屬性 ] 對話方塊的 [ 檔案遮罩 ] 方塊中,輸入 *.txt,然後按一下 [ 確定]。
設定路線選取器管線元件
在 [接收位置屬性] 對話方塊中,按一下 [接收管線] 下拉式清單中的[路線][選取][ReceiveFF],然後按一下省略號按鈕 (...) 。
使用 [ 設定管線 ] 對話方塊來設定下列 路線選取器 元件屬性:
按一下 [行程][FactKey ] 屬性,然後輸入 Resolver.Itinerary。
按一下 ResolverConnectionString 屬性,輸入 ITINERARY:\\name=DataFormatTransformation; 然後按一下 [ 確定]。
按一下 [確定 ] 關閉 [ 接收位置屬性 ] 對話方塊。
在 BizTalk Server 管理主控台中,以滑鼠右鍵按一下OnRamp.Itinerary.FlatFile.FILE接收位置,然後按一下 [啟用]。
測試一般檔案訊息的路線型路由
在 Windows 檔案總管中,流覽至 C:\HowTos。
複製 (不會將) NAOrderDocFF.txt 移至 C:\HowTos\DropFolder。
流覽至 C:\HowTos\Out。確認已將 DFT%MessageID%.xml 訊息寫入目錄。
在 BizTalk Server 管理主控台中,以滑鼠右鍵按一下OnRamp.Itinerary.FlatFile.FILE接收位置,然後按一下 [停用]。
停用 OnRamp.Itinerary.FlatFile.FILE 接收位置之後,以滑鼠右鍵按一下它,然後按一下 [ 刪除]。 在 [ 確認刪除接收位置 ] 對話方塊中,按一下 [ 是]。
其他資源
如需詳細資訊,請參閱下列相關主題: