次の方法で共有

OrderedSample (BizTalk Server サンプル)

  • [アーティクル]

OrderedSample サンプルは、オーケストレーションを使用して、順序付けられた一連のメッセージをラウンド トリップ方式で送受信する方法を示します。

このサンプルの処理

このサンプルでは、サンプルにメッセージを配信する MQSeries キューにメッセージがあることを前提とします。 MQSeries キューのメッセージは、アダプタによって順番に読み取られて BizTalk Server に送信されます。

オーケストレーションの受信ポート mqreceive には、 Ordered Delivery プロパティが True に設定 されています。

送信側では、オーケストレーションによってメッセージが送信され、配信通知の受信後に次のメッセージが送信されます。 送信ポート mqsend には、 配信通知 プロパティが [送信済み] に設定されています。 サンプルをシンプルにするために、オーケストレーションでは無限ループが使用されています。

オーケストレーションでは、メッセージのバッチおよび 1 つのメッセージを受信できます。

このサンプルの場所

<Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

次の表は、このサンプルのファイルとその目的を示しています。

ファイル 説明
OrderedReceiveSend.btproj,

OrderedReceiveSend.sln		 アプリケーションのプロジェクトおよびソリューション ファイル。
OrderedReceiveSendOrchestration.odx アプリケーションのオーケストレーション。
OrderedSample.snk 厳密な名前のキー ファイル。
Setup.bat このサンプルを作成および初期化します。

サンプルのビルドと実行

サンプルをビルドして展開するには

  1. コマンド ウィンドウで、次のフォルダーに移動します。

    <Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

  2. ファイル Setup.bat を実行すると、次のアクションが実行されます。

    1. プロジェクトの厳密な名前のキー ファイルを作成します。

    2. オーケストレーション プロジェクトをコンパイルして展開します。

    MQSeries Server for Windows のインストールに必要なアクセス許可を持っている場合は、アダプターのダイアログ ボックスを使用して MQSeries キューを作成できるため、次の手順を省略できます。 必要なアクセス許可がない場合は、IBM WebSphere MQ エクスプローラーを使用してキューを作成できます。 WebSphere MQ エクスプローラーを使用してキューを作成するには、次の手順を実行します。

WebSphere MQ エクスプローラーを使用した MQSeries キューの作成

WebSphere MQ エクスプローラーを使用して MQSeries キューを作成するには

  1. [スタート] をクリックし、[すべてのプログラム] をポイントし、[IBM WebSphere MQ] をポイントして、[WebSphere MQ エクスプローラー] をクリックします。

  2. [キュー マネージャー] をダブルクリックし、既定のキュー マネージャーをダブルクリックします。 通常、既定のキュー・マネージャーには QM_< という名前が付けられます。ここでmachine_name> machine_nameはコンピューターの名前です。

  3. [ キュー] を右クリックし、[ 新規] をポイントして、[ ローカル キュー] をクリックします。

  4. [ ローカル キューの作成 ] ダイアログ ボックスの [ キュー名] に 「queue1」と入力し、[OK] をクリック します。

  5. [ キュー] を右クリックし、[ 新規] をクリックし、[ ローカル キュー] をクリックします。

  6. [ ローカル キューの作成 ] ダイアログ ボックスの [ キュー名] に 「queue2」と入力し、[OK] をクリック します。

受信場所と MQSeries キューの作成

この手順では、MQSeries へのメッセージ送信および MQSeries からの関連メッセージの受信を行うための送信ポートと受信場所を作成します。 MQSeries キューは、受信場所がまだ作成されていない場合に受信場所を作成したときにも作成されます。

受信場所と MQSeries キューを作成するには

  1. BizTalk Server管理コンソールを開きます。

  2. [BizTalk Server管理] を展開し、[BizTalk グループ] を展開し、[アプリケーション] を展開して、必要なアプリケーションを展開します。

  3. [ 受信ポート] を右クリックし、[ 新規] をポイントして、[ 一方向の受信ポート] をクリックします。

  4. [ 一方向の受信ポートのプロパティ ] ダイアログ ボックスに、「 名前 」ボックスに「 OrderedSampleReceive 」と入力し、[OK] をクリック します。

  5. 左側のウィンドウで、[ 受信場所 ] タブをクリックし、[ 新規] をクリックします。

  6. [ 受信場所のプロパティ ] ダイアログ ボックスの [名前 ] ボックスに「OrderedSampleReceiveLocation」と入力します。

  7. [ トランスポートの種類 ] ボックスで、[ MQSeries] を選択します。

  8. [ 受信ハンドラー ] ボックスで、 BizTalkServerApplication を選択します。

  9. [ 受信パイプライン ] ボックスで、[ Microsoft.BizTalk.DefaultPipelines.PassThruReceive] を選択します。

  10. [構成] をクリックします。

  11. [ MQSeries トランスポートのプロパティ ] ダイアログ ボックスの [ ポーリング間隔 ] ボックスに 「10」と入力します。

  12. [ キュー定義 ] ボックスで、 省略記号 (...) ボタンをクリックします。

  13. [ キュー定義 ] ダイアログ ボックスの [ サーバー名 ] ボックスに、コンピューター名を入力します。

  14. [ キュー マネージャー ] ボックスで、 既定のキュー マネージャーを選択します。

  15. [ キュー ] ボックスに「 queue1」と入力し、[ エクスポート] をクリックします。

  16. [ エクスポート ] ダイアログ ボックスで、[ キューの作成] をクリックし、すべてのダイアログ ボックスを終了するまで [OK] または [完了 ] をクリックします。

送信ポートと MQSeries キューの作成

送信ポートと MQSeries キューを作成するには

  1. [ 送信ポート] を右クリックし、[ 新規] をポイントして、[ 静的一方向送信ポート] をクリックします。

  2. [ 静的ポートのプロパティ ] ダイアログ ボックスに、「 名前 」ボックスに「OrderedSampleSend」と入力します。

  3. [ トランスポートの種類 ] ボックスで、[ MQSeries] を選択します。

  4. [ パイプラインの送信 ] ボックスで、[ Microsoft.BizTalk.DefaultPipelines.PassThruTransmit] を選択します。

  5. [構成] をクリックします。

  6. [ MQSeries トランスポートのプロパティ ] ダイアログ ボックスの [ キュー定義 ] ボックスで、 省略記号 (...) ボタンをクリックします。

  7. [ キュー定義 ] ダイアログ ボックスの [ サーバー名 ] ボックスに、コンピューター名を入力します。

  8. [ キュー マネージャー ] ボックスで、 既定のキュー マネージャーを選択します。

  9. [ キュー ] ボックスに「 queue2」と入力し、[ エクスポート] をクリックします。

  10. [ エクスポート ] ダイアログ ボックスで、[ キューの作成] をクリックし、すべてのダイアログ ボックスを終了するまで [OK] または [完了 ] をクリックします。

受信場所を有効にして送信ポートを開始するには

  1. BizTalk Server管理コンソールで、[受信ポート] をクリックします。

  2. 詳細ペインで、 MQIn 受信場所を右クリックし、「 使用可能」をクリックします。

  3. 詳細ペインで、 MQOut 送信ポートを右クリックし、「開始」をクリックします 。

オーケストレーションをバインドして開始するには

  1. BizTalk Server管理コンソールで、[オーケストレーション] フォルダーを展開します。

  2. OrderedSampleOrchestration オーケストレーションをダブルクリックし、[バインド] をクリックします。

  3. オーケストレーション ポートを、以下の送信ポートおよび受信場所にバインドします。

    オーケストレーション ポート メッセージ ポート/受信場所
    mqreceive OrderedSampleReceive
    mqsend OrderedSampleSend

  4. [ ホスト] をクリックします。

  5. [ ホスト ] ボックスで、[ BizTalkServerApplication] を選択し、[OK] をクリック します。

  6. [オーケストレーション] を右クリックし、[開始] をクリックします。

サンプルを実行するには

  1. オーケストレーションを開始します。

  2. 受信場所で読み取るよう構成した MQSeries キューにメッセージを配置します。

  3. 送信ポートでメッセージを送信するよう構成した送信キューのメッセージを WebSphere MQ エクスプローラーで表示します。

参照

MQSeries アダプタ サンプル