オーケストレーションの呼び出し図形を構成する方法
[オーケストレーションの呼び出し] 図形を使用すると、別のプロジェクトで参照されているオーケストレーションを同期的に呼び出すことができます。 これにより、一般的なオーケストレーション ワークフロー パターンを BizTalk プロジェクト間で再利用できるようになります。 オーケストレーションの 呼び出し 図形を使用して別の入れ子になったオーケストレーションを同期的に呼び出すと、外側のオーケストレーションは入れ子になったオーケストレーションが完了するまで待機してから続行します。
ネストされているオーケストレーションに渡すパラメーターを指定することもできます。 パラメーターとして指定できるのは、メッセージ、変数、ポート参照、ロール リンク、または関連付けセットです。 渡されたポート参照、ロール リンク、および関連付けセットはすべて、自己アドレス指定エンベロープと同様に動作します。これらは、入れ子になったオーケストレーション情報を提供して、外側のオーケストレーションに情報を返送するために使用できます。
注意事項
XmlDocument や XmlNode などのシリアル化できないオブジェクトをパラメーターとしてオーケストレーションに渡すと失敗します。
Call Orchestration 図形の使用方法の例については、「CallOrchestration (BizTalk Server サンプル)」を参照してください。
オーケストレーションの呼び出し図形を構成するには
[ オーケストレーションの選択] ドロップダウン リスト ボックスを使用して、一覧からオーケストレーションを選択します。
[オーケストレーション パラメーター] グリッド コントロールを使用して、オーケストレーションに渡す引数を指定します ([オーケストレーションの選択] ドロップダウン リスト ボックスで指定されている) 呼び出されます。 これらの引数は、[変数] 列の各セルに 1 つずつ変数の名前を入力するか、各セルのドロップダウン リストでいずれかの変数をクリックすることによって指定します。
ダイアログ ボックスで指定したサービスと引数に従って [オーケストレーションの呼び出 し] 図形を構成するには、[OK] をクリック します。 [オーケストレーションの呼び出し] 図形に変更を加えずに [オーケストレーションの構成の呼び出し] ダイアログ ボックスを閉じるには、[キャンセル] をクリックします。
注意事項
BizTalk Serverは再帰的オーケストレーションをサポートしていません。 オーケストレーション A でオーケストレーション B を呼び出すか開始すると、オーケストレーション B でオーケストレーション A を直接呼び出したり開始したりすることはできなくなり、直接または間接的にオーケストレーション A を呼び出すオーケストレーションの呼び出しや開始もできなくなります。
参照されているオーケストレーション
参照されているオーケストレーションを呼び出せるようにするには、呼び出し先オーケストレーションに対して次のプロパティが構成されていることを確認します。
呼び出されたオーケストレーションの Type Modifier プロパティを Public に設定します。 オーケストレーションの Type Modifier プロパティを Public に設定するには、Microsoft Visual Studio でオーケストレーションを開き、オーケストレーションの上部にある緑色の開始図形をクリックして [オーケストレーションの プロパティ ] ダイアログを表示し、 Type Modifier プロパティを Public に設定します。
オーケストレーションの初期受信図形の Activate プロパティを False に設定 します。
[Orchestration Selection] ボックス
ドロップダウン リスト ボックスの下矢印をクリックして使用可能なサービスを参照し、いずれか 1 つを選択します。 この一覧には、参照アセンブリも含め、現在のオーケストレーションから呼び出せるすべてのサービスが表示されます。
[オーケストレーション パラメーター] グリッド コントロール
パラメーター化されたオーケストレーションに渡す引数は、 オーケストレーション パラメーター グリッド コントロールを使用して指定します。 グリッドには、スコープ内の変数、パラメーター名、パラメーターの種類、およびパラメーターの方向の 4 つの列があります。 変更を加えられるのは 1 列目のみで、その他の列は読み取り専用になっています。
有効なオーケストレーションを選択すると、そのパラメーターによって、グリッド コントロールのパラメーター名、型、方向列が設定されます。 次に、引数として渡す変数を各行で選択します。 これらの変数は、[スコープ内の変数] 列の各セルにあるドロップダウン リストから選択します。 このドロップダウン リストには、隣の [パラメーターの種類] セルで指定された種類の使用可能な変数がすべて表示されます。 その種類の使用可能なオブジェクトが 1 つしかない場合、[スコープ内の変数] セルにはそのオブジェクトが自動的に設定されます。 [スコープ内の変数] セルのドロップダウン リストにある変数を直接入力して選択することもできます。
Note
オーケストレーションの呼び出し図形はオーケストレーションを呼び出すので、このダイアログ ボックスで選択した "オーケストレーション パラメーター" は実際にはオーケストレーション変数を参照します。
呼び出し先オーケストレーションでパラメーターが定義されていない場合、このダイアログ ボックスのグリッド コントロールは使用できません。