オーケストレーション式からの BAM API (BizTalk Server サンプル)

[アーティクル]
07/21/2023

このサンプルでは次の操作を行います。

BizTalk Server オーケストレーション式から BAM API を使用します。
メッセージ内の繰り返し項目を個別のアクティビティインスタンスとして追跡する。
追跡プロファイルを使用して追跡される BAM データと、BAM API を使用して追跡される BAM データの間の関係を作成する。

このサンプルの場所

このサンプル <は、サンプルパス>\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	プロパティスキーマ : プロパティスキーマは、BizTalk Server がプロパティの昇格機能として備えている 2 つのメカニズムのいずれかと組み合わせて使用されます。
Setup.bat	サンプルをコンパイルし、展開するバッチファイル。
QueryBam.sql	SQL スクリプト。

追跡プロファイルを作成する

管理者としてコマンドプロンプトを開き、[サンプルパス>]\BAM\BAMFromExpression\Setup.bat を実行<します。 Setup.bat はこのサンプル用に BAM インフラストラクチャを初期化し、BAM アクティビティを展開します。
プログラム>Microsoft BizTalk Serverから、[追跡プロファイルエディター] を右クリックし、[管理者として実行] をクリックします。
[追跡プロファイルエディター] ウィンドウの左側のウィンドウで、[ここをクリックして BAM アクティビティ定義をインポートします] をクリックします。
[BAM アクティビティ定義のインポート] ダイアログボックスの [BAM アクティビティ定義名] セクションで、[FromExpressionPo] を選択し、[OK] をクリックします。
[ 追跡プロファイルエディター ] ウィンドウの右側のウィンドウで、[ ここをクリックしてイベントソースを選択します] をクリックします。
[イベントソース親アセンブリの選択] ダイアログボックスの [アセンブリ名] セクションで、[Microsoft.Samples.BizTalk.BamFromExpression] を選択し、[次へ] をクリックします。
[オーケストレーションの選択] ダイアログボックスの [オーケストレーション名] セクションで、BamFromExpression.Orchestration1 を選択し、[OK] をクリックします。
Receive_1図形を右クリックし、[メッセージペイロードスキーマ] をクリックします。
[スキーマ] を>展開<し、[PurchaseOrder] を展開し、[開始] を展開し、右側のウィンドウで [PoID] を左側のウィンドウの [ActivityID] にドラッグします。
右側のウィンドウから次の要素をドラッグし、左側のウィンドウの名前付きノードにドロップします。

ソース終了

名前ソース

State State

City City

電話番号電話番号

合計 PoTotal
矢印付きのフォルダーアイコン ( のボタン) をクリックしてオーケストレーションを表示します。
右側のウィンドウで Receive_1 図形を左ペインの Received にドラッグします。
右側のウィンドウで Send_1 図形を左ペインの [送信 ] にドラッグします。
追跡プロファイルを <Samples Path>\BAM\BamFromExpression\ BamFromExpression.btt に保存します。
[ ツール ] メニューの [ 追跡プロファイルの適用] をクリックします。

ソース	終了
名前	ソース
State	State
City	City
電話番号	電話番号
合計	PoTotal

このサンプルをビルドして初期化する

BamFromExpression.btt 追跡プロファイルを展開します。追跡プロファイル管理ユーティリティを使用して追跡プロファイルを展開する方法に関するページを参照してください。

このサンプルを実行する

サンプルパス\BamFromExpression\InputMessage.xml> ファイル<を Samples Path>\BamFromExpression\Input に<コピーします。

約 10 秒で、出力メッセージが Samples Path>\BamFromExpression\Output に<表示されます。

BAM データを表示する

SQL Server Management Studio を開きます。
SQL Server Management Studioで、サーバーを展開し、[データベース]、[BAMPrimaryImport]、[テーブル] の順に展開します。
dbo.bam_FromExpressionPo_Completedを右クリックし、[テーブルを開く] をクリックします。 SQL Serverを使用している場合は、[上位 1000 行を選択] をクリックします。

bam_FromExpressionPo_Completed テーブルの内容が、右側のウィンドウに表示されます。アクティビティ ID が 123 の 1 行は、入力メッセージに含まれていた $345 の注文を表します。
dbo.bam_FromExpressionPoItem_Completedを右クリックし、[テーブルを開く] をクリックします。 SQL Serverを使用している場合は、[上位 1000 行を選択] をクリックします。

bam_FromExpressionPoItem_Completed テーブルの内容が、右側のウィンドウに表示されます。アクティビティ ID が 123_0 および 123_1 の 2 行は、注文のアイテム Flash MC と Infrared Decoder を表します。
dbo.bam_FromExpressionPoItem_CompletedRelationshipsを右クリックし、[テーブルを開く] をクリックします。 SQL Serverを使用している場合は、[上位 1000 行を選択] をクリックします。

bam_FromExpressionPoItem_CompletedRelationships テーブルの内容が、右側のウィンドウに表示されます。テーブルの各行は、FromExpressionPoItem アクティビティと FromExpressionPo アクティビティの関係を表します。 ActivityID 列の値は、FromExpressionPoItem アクティビティのアクティビティ ID を参照します。 ReferenceData 列の値は、FromExpressionPo アクティビティのアクティビティ ID を参照します。この場合、2 つのレコードは、Flash MC アイテムと Infrared Decoder アイテムが $345 の注文で関連付けられていることを示します。

サンプルを再実行する

管理者としてコマンドプロンプトを開き、[サンプルパス>]\BAM\BamFromExpression\Cleanup.bat を実行<して追跡プロファイルとその他の BAM インフラストラクチャを削除します。
サンプルパス>\BAM\BamFromExpression\Setup.bat を実行<して、サンプルをコンパイルしてデプロイします。

参照

ビジネスアクティビティの監視 (BizTalk Server Samples フォルダー)
アクティビティリレーションシップ

次の方法で共有