オーケストレーションの開始図形を構成する方法

[オーケストレーションの開始] 図形は [オーケストレーションの呼び出し] 図形に似ていますが、[オーケストレーションの開始] 図形を使用して非同期的に別のオーケストレーションを呼び出します。つまり、呼び出し元のオーケストレーションの制御フローは、呼び出されたオーケストレーションの処理が完了するまで待たずに、呼び出しを超えて続行されます。

呼び出されたオーケストレーションに渡すパラメーターを指定することができます。 パラメーターとして指定できるのは、メッセージ、変数、ポート参照、ロール リンク、または関連付けセットです。 [オーケストレーションの開始] 図形はパラメーターのみを受け取ることができます。パラメーターを取り出したり、ref パラメーターを参照したりすることはできません。

注意事項

XmlDocument や XmlNode などのシリアル化できないオブジェクトをパラメーターとしてオーケストレーションに渡すと、失敗します。

[オーケストレーションの開始] 図形は、パラメーターとして渡されるポートの極性を反転できる唯一の図形です。たとえば、uses ポート (送信ポート) を呼び出されたオーケストレーションに渡すことができますが、呼び出されたオーケストレーションはそれを実装ポート (受信ポート) として扱うことができます。 ただし、これを実行できるのは直接バインドを使用するポートだけです。

[ オーケストレーションの開始] 図形を使用して、別のプロジェクトで参照されているオーケストレーションを呼び出すこともできます。 これにより、一般的なオーケストレーション ワークフロー パターンを BizTalk プロジェクト間で再利用できるようになります。 参照されるオーケストレーションを呼び出し可能にするには、呼び出されたオーケストレーションの Type 修飾子 プロパティが Public に設定されていることを確認 します。 オーケストレーションの Type Modifier プロパティを Public に設定するには、Microsoft Visual Studio でオーケストレーションを開き、オーケストレーションの上部にある緑色の開始図形をクリックして [オーケストレーションの プロパティ ] ダイアログを表示し、 Type Modifier プロパティを Public に設定します。 型修飾子の既定値は Private です

オーケストレーションの開始図形を使用する方法の例については、SDK サンプル 「散布と収集パターンの実装」を からhttps://go.microsoft.com/fwlink/?LinkId=73703ダウンロードします。

オーケストレーションの開始図形を構成するには

  1. [ オーケストレーションの選択] ドロップダウン リスト ボックスを使用して、一覧からオーケストレーションを選択します。

  2. [オーケストレーション パラメーター] グリッド コントロールを使用して、オーケストレーションに渡す引数を指定します ([オーケストレーションの選択] ドロップダウン リスト ボックスで指定されているとおり)。 これらの引数は、[変数] 列の各セルに 1 つずつ変数の名前を入力するか、各セルのドロップダウン リストでいずれかの変数をクリックすることによって指定します。

  3. ダイアログ ボックスで指定したサービスと引数に従って [オーケストレーションの開始 ] 図形を構成するには、[OK] をクリック します。 [オーケストレーションの 開始] 図形を変更せずに [オーケストレーション構成の 開始 ] ダイアログ ボックスを閉じるには、[ キャンセル] をクリックします。

    注意事項

    BizTalk Serverは再帰的オーケストレーションをサポートしていません。 オーケストレーション A でオーケストレーション B を呼び出すか開始すると、オーケストレーション B でオーケストレーション A を直接呼び出したり開始したりすることはできなくなり、直接または間接的にオーケストレーション A を呼び出すオーケストレーションの呼び出しや開始もできなくなります。

[Orchestration Selection] ボックス

ドロップダウン リスト ボックスの下矢印をクリックして使用可能なオーケストレーションを参照し、いずれか 1 つを選択します。 この一覧には、参照アセンブリも含め、現在のオーケストレーションから開始できるすべてのオーケストレーションが表示されます。

[オーケストレーション パラメーター] グリッド コントロール

パラメーター化されたオーケストレーションに渡す引数は、 オーケストレーション パラメーター グリッド コントロールを使用して指定します。 グリッドには、スコープ内の変数、パラメーター名、パラメーターの種類、およびパラメーターの方向の 4 つの列があります。 変更を加えられるのは 1 列目のみで、その他の列は読み取り専用になっています。

有効なオーケストレーションを選択すると、そのパラメーターの値がグリッド コントロールの [パラメーター名]、[パラメーターの種類]、および [パラメーターの方向] 列に設定されます。 次に、引数として渡す変数を各行で選択します。 これらの変数は、[スコープ内の変数] 列の各セルにあるドロップダウン リストから選択します。 このドロップダウン リストには、隣の [パラメーターの種類] セルで指定された種類の使用可能な変数がすべて表示されます。 その種類の使用可能なオブジェクトが 1 つしかない場合、[スコープ内の変数] セルにはそのオブジェクトが自動的に設定されます。 [スコープ内の変数] セルのドロップダウン リストにある変数を直接入力して選択することもできます。

Note

オーケストレーションの 開始 図形はオーケストレーションを開始するため、このダイアログ ボックスで選択した "オーケストレーション パラメーター" は実際にはオーケストレーション変数を参照します。

実行するオーケストレーションでパラメーターが定義されていない場合、このダイアログ ボックスのグリッド コントロールは使用できません。

このセクションの内容

呼び出されたオーケストレーションに受信サブスクリプションを作成する方法

参照

オーケストレーションの呼び出し図形を構成する方法