次の方法で共有

方法: メッセージ コンテキスト プロパティを使用してコンテンツ ベースのルーティングを実装する

目標

このセクションでは、Microsoft BizTalk ESB Toolkit Itinerary Designer を使用して、メッセージ コンテキスト プロパティに基づいてメッセージ受信者を選択し、Itinerary Broker メッセージング サービスを使用してその受信者にメッセージをルーティングするスケジュールを作成する方法について説明します。

このトピックでは、次の手順を実行します。

  • スケジュール ブローカーを使用して旅程を作成し、静的リゾルバーを使用して 2 つのルーティング サービスを作成します。

  • スケジュール テスト クライアント サンプル アプリケーションを使用して、スケジュールをテストします。

注

現在の実装では、オーケストレーション ベースのブローカー サービスは提供されていません。

[前提条件]

このハウツー トピックの手順では、 開発アクティビティの前提条件を完了する必要があります。

ステップス

ESB スケジュール DSL モデルを作成するには

  1. Visual Studio で、C:\HowTos\Patterns\Patterns.sln を開きます。

  2. ソリューション エクスプローラーで、[ ItineraryLibrary] を右クリックし、[ 追加] をポイントして、[ 新しいスケジュール] をクリックします。

  3. [ 新しい項目の追加 ] ダイアログ ボックスで、[テンプレート] ウィンドウの [ ItineraryDsl ] をクリックします。

  4. [ 名前 ] ボックスに「 ChoiceRouter」と入力し、[ 追加] をクリックします。

スケジュールのプロパティを構成するには

  1. Visual Studio で、 ChoiceRouter スケジュールのデザイン画面をクリックします。 ChoiceRouter プロパティ ウィンドウで、次のプロパティを構成します。

    1. [ モデル エクスポーター ] ドロップダウン リストで、[ XML スケジュール エクスポーター] をクリックします。

    2. [ エクステンダーの設定] セクションで、[ スケジュール XML ファイル ] プロパティの横にある省略記号ボタン (...) をクリックします。

    3. [ エクスポート モード ] プロパティドロップダウン リストで、[ 厳密] をクリックします。

    4. [XML ファイルの選択] ダイアログ ボックスで、[ファイル名] ボックスに「C:\HowTos\Itineraries\ChoiceRouter」と入力し、[保存] をクリックします。

    注

    この手順では、スケジュールを XML としてローカル ファイルの場所にエクスポートできます。 スケジュール データベースではなく、ローカル ファイルの場所にスケジュールをエクスポートすることで、ESB テスト クライアント アプリケーションを使用してスケジュールをテストできます。 このプロセスは、このハウツー トピックの後半で完了します。

旅程の構造を定義するには

  1. ツールボックスから、 On-Ramp モデル要素をデザイン サーフェイスにドラッグします。 OnRamp1 プロパティ ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「ReceiveNAOrder」と入力します。

    2. [ エクステンダー ]ドロップダウン リストで、[ ランプ エクステンダーをオン]をクリックします。

    3. BizTalk アプリケーションのドロップダウン リストで、Microsoft.Practices.ESB をクリックします。

    4. [受信ポート] ドロップダウン リストで、[OnRamp.Itinerary] をクリックします。

  2. ツールボックスから、 Itinerary Broker Service モデル要素をデザイナー画面にドラッグし、 On-Ramp モデル要素の右側に配置します。 ItineraryBrokerService1 で、次のプロパティを構成します。

    1. Name プロパティをクリックし、「RouteBrokerService」と入力します。

    2. [ エクステンダー ] ドロップダウン リストで、[ メッセージング ブローカー エクステンダー] をクリックします。

    3. [コンテナー] ドロップダウン リストで、[ReceiveNAOrder] を展開し、[受信ハンドラー] をクリックします。

    4. [サービス名] ドロップダウン リストで、[Microsoft.Practices.ESB.Itinerary.Services.Broker.MessagingBroker] をクリックします。

  3. Filter コレクションを右クリックし、[新しいフィルターの追加] をクリックします。 [Filter1 Properties]\(フィルター 1 のプロパティ\) ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「ASMXFilter」と入力します。

    2. [ フィルター 実装] ドロップダウン リストをクリックし、[ XPath フィルター] をクリックします。

    3. Expression プロパティをクリックし、次に count(/ContextProperties/Property[@name='InboundTransportLocation'][contains(., 'ProcessItinerary.asmx')]) > 0 と入力します。

  4. Filter コレクションを右クリックし、[新しいフィルターの追加] をクリックします。 [Filter1 Properties]\(フィルター 1 のプロパティ\) ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「WCFFilter」と入力します。

    2. [ フィルターの実装 ] ドロップダウン リストをクリックし、[ XPath フィルター] をクリックします。

    3. 「式」プロパティをクリックし、次に「count(/ContextProperties/Property[@name='InboundTransportLocation'][contains(., 'ESB.ItineraryServices.WCF')]) > 0」と入力します。

  5. RouteBrokerService モデル要素のリゾルバー コレクションを右クリックし、[新しいリゾルバーの追加] をクリックします。 [ 競合回避モジュール 1 のプロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「ResolverBrokerRoute」と入力します。

    2. リゾルバーの実装 ドロップダウン リストで、MessageContext リゾルバーの拡張 をクリックします。

  6. ツールボックスで、[ コネクタ] をクリックします。 ReceiveNAOrder モデル要素から RouteBrokerService モデル要素に接続をドラッグします。

  7. ツールボックスから、 Itinerary Service モデル要素をデザイン サーフェイスにドラッグし、 RouteBrokerService モデル要素の下に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「RouteToFileFromASMX」と入力します。

    2. [ スケジュール サービス エクステンダー ] ドロップダウン リストで、[ メッセージング エクステンダー] をクリックします。

      注

      このプロパティは、プロセスがパイプライン (メッセージング) で実行されることを定義します。 または、プロセスがオーケストレーションで行われる場合は、 スケジュール サービス エクステンダー プロパティを オーケストレーション エクステンダーに設定します。

    3. [コンテナー] ドロップダウン リストで、[ReceiveNAOrder] を展開し、[受信ハンドラー] をクリックします。

    4. [ サービス名 ] ドロップダウン リストで、[ Microsoft.Practices.ESB.Services.Routing] をクリックします。

  8. RouteToFileFromASMX モデル要素のリゾルバー コレクションを右クリックし、[新しいリゾルバーの追加] をクリックします。 [ 競合回避モジュール 1 のプロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「ResolverFromAsmx」と入力します。

    2. [ リゾルバーの実装 ] ドロップダウン リストで、[ 静的リゾルバー拡張機能] をクリックします。

    3. [ トランスポート名 ] ドロップダウン リストで、[ ファイル] をクリックします。

    4. [ トランスポートの場所 ] プロパティをクリックし、「 c:\howtos\out\asmx%MessageId%.xml」と入力します。

  9. ツールボックスから 、Off-Ramp モデル要素をデザインサーフェイスにドラッグし、 RouteToFileFromASMX モデル要素の右側に配置します。 [OffRamp1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「SendASMXOrder」と入力します。

    2. [ エクステンダー ] ドロップダウン リストで、[ ESB エクステンダーOff-Ramp クリックします。

    3. BizTalk アプリケーションのドロップダウン リストで、[GlobalBank.ESB] をクリックします。

    4. [送信ポート] ドロップダウン リストで、[DynamicResolutionOneWay] をクリックします。

  10. ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 RouteToFileFromASMX モデル要素と SendASMXOrder モデル要素の間に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「SendPortFilterASMX」と入力します。

    2. Itinerary Service Extenderのドロップダウン リストで、エクステンダーOff-Rampをクリックします。

    3. Off-Ramp ドロップダウン リストで、SendASMXOrder を展開し、Send Handlers をクリックします。

  11. ツールボックスで、[ コネクタ] をクリックします。 RouteToFileFromASMX モデル要素から SendPortFilterASMX モデル要素に接続をドラッグします。

  12. ツールボックスで、[ コネクタ] をクリックします。 接続を SendPortFilterASMX モデル要素から SendASMXOrder モデル要素にドラッグします。

  13. ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 RouteBrokerService モデル要素の右側に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「RouteToFileFromWCF」と入力します。

    2. [ スケジュール サービス エクステンダー ] ドロップダウン リストで、[ メッセージング エクステンダー] をクリックします。

      注

      このプロパティは、プロセスがパイプライン (メッセージング) で実行されることを定義します。 または、プロセスがオーケストレーションで行われる場合は、 スケジュール サービス エクステンダー プロパティを オーケストレーション エクステンダーに設定します。

    3. [コンテナー] ドロップダウン リストで、[ReceiveNAOrder] を展開し、[受信ハンドラー] をクリックします。

    4. [ サービス名 ] ドロップダウン リストで、[ Microsoft.Practices.ESB.Services.Routing] をクリックします。

  14. RouteToFileFromWCF モデル要素のリゾルバー コレクションを右クリックし、[新しいリゾルバーの追加] をクリックします。 [ 競合回避モジュール 1 のプロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「ResolverFromWCF」と入力します。

    2. [ リゾルバーの実装 ] ドロップダウン リストで、[ 静的リゾルバー拡張機能] をクリックします。

    3. [ トランスポート名 ] ドロップダウン リストで、[ ファイル] をクリックします。

    4. [ トランスポートの場所 ] プロパティをクリックし、「 c:\howtos\out\wcf%MessageId%.xml」と入力します。

  15. ツールボックスから 、Off-Ramp モデル要素をデザインサーフェイスにドラッグし、 RouteToFileFromWCF モデル要素の右側に配置します。 [OffRamp1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「SendWCFOrder」と入力します。

    2. [ エクステンダー ] ドロップダウン リストで、[ ESB エクステンダーOff-Ramp クリックします。

    3. BizTalk アプリケーションのドロップダウン リストで、[GlobalBank.ESB] をクリックします。

    4. [送信ポート] ドロップダウン リストで、[DynamicResolutionOneWay] をクリックします。

  16. ツールボックスから、 Itinerary Service モデル要素をデザインサーフェイスにドラッグし、 RouteToFileFromWCF モデル要素と SendWCFOrder モデル要素の間に配置します。 [ ItineraryService1 プロパティ] ウィンドウで、次のプロパティを構成します。

    1. Name プロパティをクリックし、「SendPortFilterWCF」と入力します。

    2. Itinerary Service Extenderのドロップダウン リストで、エクステンダーOff-Rampをクリックします。

    3. Off-Ramp ドロップダウン リストで、 SendWCFOrder を展開し、送信ハンドラー をクリックします。

  17. ツールボックスで、[ コネクタ] をクリックします。 RouteToFileFromWCF モデル要素から SendPortFilterWCF モデル要素に接続をドラッグします。

  18. ツールボックスで、[ コネクタ] をクリックします。 接続を SendPortFilterWCF モデル要素から SendWCFOrder モデル要素にドラッグします。

  19. ツールボックスから、RouteBrokerService の右罫線に Itinerary Outport モデル要素をドラッグします。 ItineraryBrokerOutPort1 プロパティ ウィンドウで、次のプロパティを構成します。

    1. [名前] プロパティをクリックし、「WCF ポート」と入力します。

    2. [ フィルター ] ドロップダウン リストで、[ WCFFilter] をクリックします。

    3. [ Resolver ] ドロップダウン リストで、[ ResolverBrokerRoute ] をクリックします。

  20. ツールボックスから、 Itinerary Outport モデル要素を RouteBrokerService の下の境界線にドラッグします。 ItineraryBrokerOutPort1 プロパティ ウィンドウで、次のプロパティを構成します。

    1. [名前] プロパティをクリックし、「ASMX ポート」と入力します。

    2. [ フィルター ] ドロップダウン リストで、[ ASMXFilter] をクリックします。

    3. Resolver ドロップダウン リストで、ResolverBrokerRoute をクリックします。

  21. ツールボックスで、[ コネクタ] をクリックします。 WCF ポート モデル要素から RouteToFileFromWCF モデル要素に接続をドラッグします。

  22. ツールボックスで、[ コネクタ] をクリックします。 ASMX ポート モデル要素から RouteToFileFromASMX モデル要素に接続をドラッグします。

スケジュール テスト クライアントで使用するモデルをエクスポートするには

注

スケジュールを 2 回エクスポートする必要があります。1 回は XML で、1 回はデータベースにエクスポートし、ブローカーを介してルーティングをテストします。

  1. Visual Studio で、 ChoiceRouter スケジュールのデザイン 画面を右クリックし、[ モデルのエクスポート] をクリックします。

    注

    スケジュールの XML バージョンが Visual Studio で開きます。

  2. Windows エクスプローラーで、[C:\HowTos\Itineraries, and then notice the creation of your itinerary XML (ChoiceRouter.xml] を参照します。

  3. Visual Studio で、 ChoiceRouter スケジュールのデザイン 画面を右クリックし、[ モデルのエクスポート] をクリックします。

  4. [プロパティ] ウィンドウで、[モデル エクスポーター] ドロップダウン リストの [ データベース スケジュールエクスポーター ] をクリックします。

  5. [プロパティ] ウィンドウで、 スケジュール データベース のプロパティ接続文字列をスケジュール データベースを指すように設定します。

  6. [ スケジュールの状態] プロパティのドロップダウン リストで、[ デプロイ済み] を選択します。

  7. Visual Studio で、 ChoiceRouter スケジュールのデザイン 画面を右クリックし、[ モデルのエクスポート] をクリックします。

旅程をテストするには

  1. 開発アクティビティの前提条件 (C:\HowTos\ESB.Itinerary.Test.exe - ショートカット) で作成したショートカットを使用して、Itinerary Test Client サンプル アプリケーションを開きます。

  2. スケジュール テスト クライアントで、[ WCF サービスの使用 ] チェック ボックスをオフにし、[ スケジュールの読み込み] をクリックします。

  3. [ スケジュール ファイルを開く ] ダイアログ ボックスで、C:\HowTos\Itineraries に移動します。 ChoiceRouter.xmlを選択し、[開く] をクリックして旅程を読み込みます。

  4. [ OK] を クリックして、[スケジュールが正常に読み込まれました] メッセージを閉じます。

  5. スケジュール テスト クライアントで、[ メッセージの読み込み ] ボックスの横にある省略記号ボタン (...) をクリックします。

  6. [ 読み込む XML ドキュメントの選択 ] ダイアログ ボックスで、C:\Patterns\HowTos を参照します。 NAOrderDoc.xml選択し、[ 開く ] をクリックしてテスト メッセージを読み込みます。

  7. [ 要求の送信] ボタンをクリックします。 テストが完了したら、[ OK] をクリックして、表示される確認メッセージを閉じます。

  8. Windows エクスプローラーで、C:\HowTos\Out. Verify that the ASMX%MessageID%.xml に移動して、このディレクトリにメッセージが書き込まれているか確認します。

  9. [スケジュール テスト クライアント で WCF サービスを使用 する] チェック ボックスをオンにします。 [ スケジュール名 ] ボックスに「 ChoiceRouter」と入力し、[ 要求の送信 ] ボタンをクリックします。 テストが完了したら、[ OK ] をクリックして確認メッセージを閉じます。

  10. Windows エクスプローラーで C:\HowTos\Out. Verify that the WCF%MessageID%.xml ディレクトリに移動し、メッセージがこのディレクトリに書き込まれたことを確認します。

その他のリソース

詳細については、次の関連項目を参照してください。