目標
このセクションでは、ESB Designer ドメイン固有言語 (DSL) を使用して、双方向オンランプで使用できる要求/応答スケジュールを作成する方法について説明します。 メッセージを受信し、メッセージを変換し、サービスにメッセージを送信し、元のメッセージの送信者にサービス応答メッセージを返すルーティング スリップを作成します。
このハウツー トピックでは、次の手順を実行します。
Microsoft BizTalk Server マップを実装する変換スケジュール サービスを使用して、スケジュール ルーティング スリップを作成します。
変換されたメッセージをサービス エンドポイントにルーティングするようにスケジュールを構成します。
元の送信側にサービス応答メッセージを返すようにスケジュールを構成します。
スケジュール テスト クライアント サンプル アプリケーションを使用して、スケジュールをテストします。
[前提条件]
このハウツー トピックの手順では、 開発アクティビティの前提条件を完了する必要があります。
ステップス
ESB イテナラリー DSL モデルを作成するには
Visual Studio で、C:\HowTos\Patterns\Patterns.sln を開きます。
ソリューション エクスプローラーで、 ItineraryLibrary プロジェクトを右クリックし、[ 追加] をポイントして、[ 新しいスケジュール] をクリックします。
[ 新しい項目の追加 ] ダイアログ ボックスの [名前 ] ボックスに「 RequestResponse」と入力し、[ 追加] をクリックします。
スケジュールのプロパティを構成するには
Visual Studio で、 RequestResponse.itinerary のデザイン画面をクリックします。 [ RequestResponse のプロパティ] ウィンドウで、次のプロパティを構成します。
[ Is Request Response ]\(要求応答\) ドロップダウン リストで、[ True] をクリックします。
[ モデル エクスポーター ] ドロップダウン リストで、[ XML スケジュール エクスポーター] をクリックします。
[ エクステンダーの設定] セクションで、[ スケジュール XML ファイル ] プロパティの横にある省略記号ボタン (...) をクリックします。
[ XML ファイルの選択 ] ダイアログ ボックスの [ ファイル名 ] ボックスに「 C:\HowTos\Itineraries\RequestResponse」と入力し、[ 保存] をクリックします。
注
この手順では、スケジュールを XML としてローカル ファイルの場所にエクスポートできます。 スケジュールデータベースではなく、ローカルファイルの場所に旅程をエクスポートすることで、ESBテストクライアントアプリケーションを使用して旅程のテストを可能にします。 このプロセスは、このハウツー トピックの後半で完了します。
旅程の構造を定義するには
ツールボックスから、 On-Ramp モデル要素をデザイン サーフェイスにドラッグします。 OnRamp1 プロパティ ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「ReceiveNAOrder」と入力します。
[ エクステンダー ]ドロップダウン リストで、[ On-Ramp ESB エクステンダー]をクリックします。
BizTalk アプリケーションのドロップダウン リストで、Microsoft.Practices.ESB をクリックします。
[受信ポート] ドロップダウン リストで、[OnRamp.Itinerary.Response] をクリックします。
ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 On-Ramp モデル要素の右側に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「MapNAOrderToCNOrder」と入力します。
[ スケジュール サービス エクステンダー ] ドロップダウン リストで、[ メッセージング エクステンダー] をクリックします。
注
このプロパティは、プロセスがパイプライン (メッセージング) で実行されることを定義します。 または、プロセスがオーケストレーションで行われる場合は、 スケジュール サービス エクステンダー プロパティを オーケストレーション エクステンダーに設定します。
[コンテナー] ドロップダウン リストで、[ReceiveNAOrder] を展開し、[受信ハンドラー] をクリックします。
[ サービス名 ] ドロップダウン リストで、[ Microsoft.Practices.ESB.Services.Transform] をクリックします。
MapNAOrderToCNOrder モデル要素のリゾルバー コレクションを右クリックし、[新しいリゾルバーの追加] をクリックします。 [ 競合回避モジュール 1 のプロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「StaticallySpecifyTheMap」と入力します。
[ リゾルバーの実装 ] ドロップダウン リストで、[ 静的リゾルバー拡張機能] をクリックします。
[ 変換の種類 ] ドロップダウン リストで、[ GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN] をクリックします。
ツールボックスで、[ コネクタ] をクリックします。 ReceiveNAOrder モデル要素から MapNAOrderToCNOrder モデル要素に接続をドラッグします。
ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 MapNAOrderToCNOrder モデル要素の右側に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「RouteToCNService」と入力します。
[ スケジュール サービス エクステンダー ] ドロップダウン リストで、[ メッセージング エクステンダー] をクリックします。
注
このプロパティは、プロセスがパイプライン (メッセージング) で実行されることを定義します。 または、プロセスがオーケストレーションで行われる場合は、 スケジュール サービス エクステンダー プロパティを オーケストレーション エクステンダーに設定します。
[コンテナー] ドロップダウン リストで、[ReceiveNAOrder] を展開し、[受信ハンドラー] をクリックします。
[ サービス名 ] ドロップダウン リストで、[ Microsoft.Practices.ESB.Services.Routing] をクリックします。
RouteToCNService モデル要素のリゾルバー コレクションを右クリックし、[新しいリゾルバーの追加] をクリックします。 [ 競合回避モジュール 1 のプロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「StaticallySpecifyTheService」と入力します。
[ リゾルバーの実装 ] ドロップダウン リストで、[ 静的リゾルバー拡張機能] をクリックします。
[ トランスポート名 ] ドロップダウン リストで、[ WCF-BasicHttp] をクリックします。
[ トランスポートの場所 ] プロパティをクリックし、「 http://localhost/ESB.CanadianServices/SubmitPOService.asmx」と入力します。
[ ターゲット名前空間 ] プロパティをクリックし、「 http://globalbank.esb.dynamicresolution.com/canadianservices」と入力します。
Action プロパティをクリックし、「submitOrder」と入力します。
ツールボックスで、[ コネクタ] をクリックします。 MapNAOrderToCNOrder モデル要素から RouteToCNService モデル要素に接続をドラッグします。
ツールボックスから 、Off-Ramp モデル要素をデザインサーフェイスにドラッグし、 RouteToCNService モデル要素の右側に配置します。 [OffRamp1 プロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「InvokeCNService」と入力します。
[ エクステンダー ] ドロップダウン リストで、[ ESB エクステンダーOff-Ramp クリックします。
BizTalk アプリケーションのドロップダウン リストで、[GlobalBank.ESB] をクリックします。
[送信ポート] ドロップダウン リストで、[DynamicResolutionSolicitResp] をクリックします。
ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 RouteToCNService モデル要素と InvokeCNService モデル要素の間に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。
Name プロパティをクリックし、「SendPortFilter」と入力します。
Itinerary Service Extenderのドロップダウン リストで、エクステンダーOff-Rampをクリックします。
オフランプ のドロップダウン リストで、InvokeCNService を展開し、送信ハンドラー をクリックします。
ツールボックスで、[ コネクタ] をクリックします。 RouteToCNService モデル要素から SendPortFilter モデル要素に接続をドラッグします。
ツールボックスで、[ コネクタ] をクリックします。 接続を SendPortFilter モデル要素から InvokeCNService モデル要素にドラッグします。
デザイン サーフェイスを右クリックし、[ 検証] をクリックします。
注
旅程が検証されます。応答メッセージを要求側に送り返すために、オフランプをオンランプに戻す必要はありません。 双方向のオンランプを使用すると、最終的なメッセージが要求側に自動的に返されます。
スケジュール テスト クライアントで使用するモデルをエクスポートするには
Visual Studio で、 RequestResponse スケジュールのデザイン画面を右クリックし、[ モデルのエクスポート] をクリックします。
注
スケジュールの XML バージョンが Visual Studio で開きます。
すべてのプロジェクト成果物を保存します。
Windows エクスプローラーで、C:\HowTos\Itineraries に移動します。 旅程 XML (RequestResponse.xml) の作成に注目してください。
旅程をテストするには
開発アクティビティの前提条件 (C:\HowTos\ESB.Itinerary.Test.exe - ショートカット) で作成したショートカットを使用して、Itinerary Test Client サンプル アプリケーションを開きます。
スケジュール テスト クライアントで、[ WCF サービスの使用 ] チェック ボックスをオフにします。
[ Web サービス オプション] セクションで、[ 双方向サービス ] チェック ボックスをオンにし、[ スケジュールの読み込み] をクリックします。
[ スケジュール ファイルを開く ] ダイアログ ボックスで、C:\HowTos\Itineraries に移動します。 RequestResponse.xmlを選択し、[開く] をクリックして旅程を読み込みます。
[ OK] を クリックして、 スケジュールが正常に読み込まれたメッセージを クリアします。
スケジュール テスト クライアントで、[ メッセージの読み込み ] ボックスの横にある省略記号ボタン (...) をクリックします。
[ 読み込む XML ドキュメントの選択 ] ダイアログ ボックスで、C:\HowTos を参照します。 NAOrderDoc.xml選択し、[開く] をクリックしてテスト メッセージを読み込みます。
[ 要求の送信] ボタンをクリックします。 テストが完了したら、[ OK] をクリックして、表示される確認を閉じます。
[結果] ボックスで、メッセージのルート ノードが submitOrderResponse で、既定の名前空間が ... であることに注意してください。canadianservices。
注
応答メッセージが要求側に送信される前に追加の変換が必要な場合は、ESB フォワーダー コンポーネントを含むパイプラインを使用する必要があります。 この機能の例については、「 複数の Web サービスのインストールと実行」サンプルを参照してください。
その他のリソース
詳細については、次の関連項目を参照してください。