CBRSample (BizTalk Server 範例)
CBRSample 範例會示範如何套用篩選條件和輸出對應，以轉換並根據內容來路由執行個體訊息。
此範例的用途
此範例會示範如何根據國碼，將內含名稱、地址和連絡資訊的訊息路由至兩個資料夾之一。 具體來說，本範例執行下列工作：
定義內含個人基本資訊的範例訊息格式，包括含使用者識別碼和完整名稱的身份識別、含國碼的地址，以及電話連絡資訊。
升級輸入檔中 的 CountryCode 屬性，使其可用於埠篩選，以控制轉換和路由。
當 CountryCode 等於 200 或美國版本時 ，當 CountryCode 等於 100 時，將訊息轉換成加拿大版本。 兩個轉換都會通過中間初始 (初始) 以外的所有數據。 加拿大版本也會將 州 / 省 和 ZipCode 對應至 PinCode。
將美國的訊息路由至 US 目錄，將加拿大的訊息路由至 CAN 目錄。
此範例的設計方式和原因
其設計依賴 BizTalk Server 內的預設傳送和接收 XML 管線、屬性升級、訂閱篩選器和輸出對應來路由訊息。 下表列出設計元素及其原因。
| 設計元素 | 已選取的原因 |
|---|---|
| 預設 XML 接收管線 | - XMLReceive 管線支援屬性升級;PassThruReceive 管線沒有。 - 輸入訊息已經是 XML 格式，不需要處理超過基本反組譯碼和合作物件解析。 |
| 屬性升級 | - 在屬性欄位上執行路由的 BizTalk Serverdepends。 辨別欄位可用於協調流程，不能用於路由。 |
| 訂閱篩選器 | - 訂用帳戶篩選條件會根據屬性字段擷取符合一或多個準則的訊息，以執行實際的路由。 |
| 輸出對應 | - 將數據從一種格式轉換成另一種格式。 範例會將輸入訊息對應至美國或加拿大的格式。 |
| XMLTransmit | - 執行傳出 XML 訊息的基本元件;PassThruTransmit 管線不提供任何其他支援。 |
基本模式擴充後可用於更複雜的情況。
可在何處找到此範例
此範例位於 <Samples Path>\Messaging\CBRSample\。
下表顯示此範例中的檔案，並描述其用途。
| 檔案 | Description |
|---|---|
| CBRDataCAN.Xml, CBRDataUS.Xml | 符合 CBRInputSchema.xsd 檔案中所定義結構描述的範例輸入檔。 |
| CBRInput2CANMap.btm, CBRInput2USMap.btm | 分別對應加拿大和美國格式轉換的檔案。 |
| CBRInputSchema.xsd, CBROutputSchemaCAN.xsd, CBROutputSchemaUS.xsd | 分別為輸入格式、加拿大輸出格式和美國輸出格式的結構描述檔案。 |
| CBRPromotedPropertySchema.xsd | 對應至 XML 輸入檔中 CountryCode 元素之升級屬性的架構檔案。 |
| CBRSample.btproj, CBRSample.sln | 此範例的 BizTalk 專案和方案檔。 |
| Cleanup.bat | 用來解除部署組件，以及將它從全域組件快取中移除。 移除傳送埠和接收埠。 視需要移除 Internet Information Services (IIS) 虛擬目錄。 |
| Setup.bat | 用來建置和初始化此範例。 |
如何使用此範例
使用此範例，做為根據內容路由訊息之必要動作的操作範例。
建置和初始化此範例
若要建置和初始化 CBRSample 範例，必須為此範例建置和部署 BizTalk 專案、設定接收埠和位置，以及設定兩個不同的傳送埠。
若要為此範例建置和部署 BizTalk 專案
在命令視窗中，瀏覽至下列資料夾：
<Samples Path>\Messaging\CBRSample執行 Setup.bat執行下列動作：
針對此範例， 在) 和 輸出資料夾中建立輸入 (， (US 和 CAN) 。
為此範例編譯和部署 Microsoft Visual Studio 專案。
建立並繫結 BizTalk Server 接收位置以及傳送和接收埠。
注意
此範例會在建立和繫結連接埠時顯示警告，如下所示：
警告：未指定接收位置 「CBRReceiveLocation」 的接收處理程式;使用符合傳輸類型的第一個接收處理程式進行更新。
您可以放心地忽略此警告。 (繫結檔案已省略主控件名稱與接收處理常式，以配合使用者安裝中可能的命名差異)。
注意
在嘗試執行此範例之前，您應該確認 BizTalk Server 沒有在建置和初始化程序期間報告任何錯誤。
注意
如果您選擇不執行 Setup.bat 就開啟和建置此範例中的專案，必須先使用 .NET Framework Strong Name Utility (sn.exe) 建立強式名稱金鑰組。 請使用這個金鑰組來簽署產生的組件。
注意
若要復原 Setup.bat 所進行的變更，請執行 Cleanup.bat。 您必須先執行 Cleanup.bat 才能再度執行 Setup.bat。
若要準備設定接收埠和位置以及傳送埠
在 Microsoft SQL Management Studio 中，選取正確的 BizTalk 管理資料庫。
注意
「BizTalk 管理」資料庫也稱為「BizTalk 組態」資料庫。
若要設定、登記及啟動美國傳送埠
在 [BizTalk Server 管理控制台] 中，展開 [傳送埠]，以滑鼠右鍵按兩下 CBRUSSendPort，然後按兩下 [編輯]。
在 [ 靜態 One-Way 傳送埠屬性 ] 對話框中，於對話框左側的資料夾樹狀目錄中，選取 [ 篩選] & [對應] |篩選，然後將 Property 設定為 CBRSample.CountryCode，將 [運算符 ] 資料行設定 ==為 ，然後將 [值 ] 資料行設定為 100，以新增數據列。
在對話框左側的資料夾樹狀目錄中，選取 [篩選] & [對應] |輸出對應，將 Map 設定為將屬性套用 至 CBRSample.CBRInput2USMap，然後按兩下 [ 確定]。 您可能必須按一下捲軸按鈕，才能檢視到對應。
若要設定、登錄和啟動加拿大傳送埠
在 BizTalk Server 管理控制台中，展開 [傳送埠]，以滑鼠右鍵按兩下 CBRCANSendPort，然後按兩下 [編輯]。
在 [ 靜態 One-Way 傳送埠屬性 ] 對話框中，於對話框左側的資料夾樹狀目錄中，選取 [ 篩選] & [對應] |篩選，然後將 Property 設定為 CBRSample.CountryCode，將 [運算符 ] 資料行設定 ==為 ，然後將 [值 ] 資料行設定為 200，以新增數據列。
在對話框左側的資料夾樹狀目錄中，選取 [篩選] & [對應] |輸出對應，將 Map 設定為將屬性套用 至 CBRSample.CBRInput2CANMap，然後按兩下 [ 確定]。
這些步驟會將傳送埠連接至接收埠。 範例使用已升級的屬性來路由文件。
BizTalk Server 現在已準備就緒可使用此範例。
執行此範例
請使用下列程序執行 CBRSample 範例。
執行此範例
將輸入檔案 CBRDataCAN.xml 和 CBRDataUS.xml複製到下列輸入資料夾：
<Samples Path>\Messaging\CBRSample\In根據其 CountryCode 元素的值 (100 與 200) ，觀察這些檔案如何轉換並路由至下列兩個輸出資料夾的其中一個：
BizTalk Server 轉換並將輸入檔案 CBRDataCAN.xml路由傳送至資料夾：
<Samples Path>\Messaging\CBRSample\CANBizTalk Server 轉換，並將輸入檔案 CBRDataUS.xml 路由傳送至資料夾：
<Samples Path>\Messaging\CBRSample\US
在此範例中使用的類別或方法
無。