協調流程運算式中的 BAM API (BizTalk Server 範例)
這個範例會示範如何：
使用來自BizTalk Server協調流程運算式的 BAM API。
將訊息內的重複專案追蹤為個別的活動實例。
使用追蹤設定檔，以及使用 BAM API 追蹤的 BAM 資料，建立 BAM 資料之間的關聯性。
可在何處找到此範例
您可以在範例 Path > \BAM\BamFromExpression 中找到此範例 <。
下表列出此範例中的檔案，並描述其用途。
| 檔案 | 描述 |
|---|---|
| BamDefinition.xls | BAM 定義樣式表。 |
| BamDefinition.xml | BAM 定義。 |
| BamFromExpression.btproj | Visual Studio 追蹤檔案專案。 |
| BamFromExpression.sln | Visual Studio 解決方案。 |
| Cleanup.bat | 用來解除部署範例的批次檔。 |
| InputMessage.xml | 輸入訊息。 |
| Orchestration1.odx | 協調流程。 |
| PoSchema.xsd | 訂單結構描述。 |
| PropertySchema.xsd | 屬性結構描述。 |
| Setup.bat | 用來編譯和部署範例的批次檔。 |
| QueryBam.sql | SQL 腳本。 |
建立追蹤設定檔
以系統管理員身分開啟命令提示字元，然後執行< 範例路徑 >\BAM\BAMFromExpression\Setup.bat。 Setup.bat 初始化此範例的 BAM 基礎結構，並部署 BAM 活動。
從程式>Microsoft BizTalk Server，以滑鼠右鍵按一下[追蹤設定檔編輯器]，然後以系統管理員身分執行。
在 [ 追蹤設定檔編輯器 ] 視窗的左窗格中， 按一下 [按一下這裡] 以匯入 BAM 活動定義。
在 [匯入 BAM 活動定義] 對話方塊的[BAM 活動定義名稱] 區段中，選取 [FromExpressionPo]，然後按一下 [確定]。
在 [ 追蹤設定檔編輯器 ] 視窗的右窗格中， 按一下 [按一下這裡] 以選取事件來源。
在 [選取事件來源父元件] 對話方塊的 [元件名稱] 區段中，選取[Microsoft.Samples.BizTalk.BamFromExpression]，然後按 [下一步]。
在 [選取協調流程] 對話方塊的 [協調流程名稱] 區段中，選取[BamFromExpression.Orchestration1]，然後按一下 [確定]。
以滑鼠右鍵按一下 Receive_1 圖形，然後按一下 [ 訊息承載架構]。
依序展開 < [架構] >、[PurchaseOrder]、[寄件者]，然後將右窗格中的[PoID] 拖曳至左窗格中的[ActivityID]。
從右窗格拖曳下列元素，並將其放在左窗格中的具名節點：
寄件者 收件者 名稱 寄件者 狀態 狀態 City City 手機 手機 總計 PoTotal 按一下具有
) 的資料夾圖示，以顯示協調流程。將右窗格中 的Receive_1 圖形拖曳至左窗格中 的 [已接收 ]。
將右窗格中 的Send_1 圖形拖曳至左窗格中的 [傳送 ]。
將追蹤設定檔儲存至< Samples Path >\BAM\BamFromExpression\ BamFromExpression.btt。
在 [ 工具] 功能表上，按一下 [ 套用追蹤設定檔]。
建置並初始化此範例
部署 BamFromExpression.btt 追蹤設定檔。 請參閱 如何使用追蹤設定檔管理公用程式部署追蹤設定檔。
執行這個範例
將< 範例路徑 >\BamFromExpression\InputMessage.xml 檔案複製到< Samples Path >\BamFromExpression\Input。
在大約 10 秒內，輸出訊息會出現在範例路徑 > \BamFromExpression\Output 中 <。
檢視 BAM 資料
開啟 [SQL Server Management Studio]。
在SQL Server Management Studio中，依序展開伺服器、[資料庫]、[BAMPrimaryImport] 和 [資料表]。
以滑鼠右鍵按一下 dbo.bam_FromExpressionPo_Completed，然後按一下 [ 開啟資料表]。 如果您使用 SQL Server，請按一下[選取前 1000 個數據列]。
bam_FromExpressionPo_Completed 資料表的內容會顯示在右窗格中。 有一個資料列 (活動識別碼為 123) 代表輸入訊息中所含價值 $345 的訂單。
以滑鼠右鍵按一下 dbo.bam_FromExpressionPoItem_Completed，然後按一下 [ 開啟資料表]。 如果您使用 SQL Server，請按一下[選取前 1000 個數據列]。
bam_FromExpressionPoItem_Completed資料表的內容會顯示在右窗格中。 活動識別碼為 123_0 和 123_1 的兩個數據列代表採購單中的專案：Flash MC 和 Infrared Decoder。
以滑鼠右鍵按一下 dbo.bam_FromExpressionPoItem_CompletedRelationships，然後按一下 [ 開啟資料表]。 如果您使用 SQL Server，請按一下[選取前 1000 個數據列]。
bam_FromExpressionPoItem_CompletedRelationships資料表的內容會顯示在右窗格中。 資料表中的每個資料列都代表 FromExpressionPoItem 活動與 FromExpressionPo 活動之間的關聯性。 ActivityID資料行中的值是指 FromExpressionPoItem 活動的活動識別碼。 ReferenceData資料行中的值會參考 FromExpressionPo 活動的活動識別碼。 在此情況下，這兩筆記錄表示 Flash MC 和 Infrared 解碼器專案與 $345 的採購單相關聯。
重新執行範例
以系統管理員身分開啟命令提示字元，然後執行< 範例路徑 >\BAM\BamFromExpression\Cleanup.bat 以移除追蹤設定檔和其他 BAM 基礎結構。
執行< 範例路徑 >\BAM\BamFromExpression\Setup.bat 來編譯範例並加以部署。