シナリオの実行
シナリオを実行する前に、以下の手順を実行します。
- Adapter for WebSphere MQ がまだ稼働していない場合は始動します。
- Visual Test Connector がまだ稼働していない場合は始動します。
静的メタオブジェクトを使用したシナリオ
チュートリアルのこのセクションでは、静的メタオブジェクトを使用したシナリオについて説明します。静的メタオブジェクトの詳細については、静的メタオブジェクトの作成の概要を参照してください。
- ポート・コネクターのシミュレート Visual Test Connector を使用して、ポート・コネクターのプロファイルを定義します。
- 「Visual Test Connector」メニューから「ファイル」->「プロファイルを作成/選択」を選択し、次に、「コネクター・プロファイル」メニューから「ファイル」->「新規プロファイル」を選択します。
- sample_folder 内にあるポート・コネクター構成ファイル PortConnector.cfg を選択して、Connector Name および Broker Type を構成してから「OK」をクリックします。
- 作成したプロファイルを選択し、「OK」をクリックします。
- 「Visual Test Connector」メニューから、「ファイル」->「接続」を選択してシミュレートを開始します。
- 要求処理のテスト
- Test Connector を使用して、ビジネス・オブジェクト Sample_WebSphereMQ_LegacyContact の新規インスタンスを作成します。これを実行するには、BoType ドロップダウン・ボックスでビジネス・オブジェクトを選択してから、BOInstance の「作成」を選択します。
- 必要に応じてデフォルト値を変更し、動詞を Create に設定して、「ビジネス・オブジェクトを送信」をクリックしてメッセージを送信します。
- メッセージ送達の検査 WebSphere
MQ Explorer または同様のアプリケーションを使用してキュー queue://crossworlds.queue.manager/LEGACYAPP.IN を開き、フォーマットが LC_CR の新規連絡メッセージがアダプターから届いているか確認します。
- イベント処理のテスト メッセージを
WebSphere MQ アダプターの入力キューに送信します。注: このステップでは、キューにメッセージを送ることができるユーティリティーが必要です。このようなユーティリティーが使用できない場合は、WebSphere アダプターの InputQueue プロパティーを queue://crossworlds.queue.manager/LEGACYAPP.IN に設定します。これにより、アダプターは自身のメッセージをポーリングできます (これが最も容易な方法です)。入力キューにメッセージが入ると、アダプターはこのメッセージに対するポーリングを実行し、これを Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトに変換しようとします。アダプターにメッセージのポーリングを実行させるために重要なことは、メッセージ・フォーマットが、メタオブジェクト Sample_WebSphereMQ_MO_Config 内の Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトに関連付けられた値と等しいことです。このシナリオの場合、フォーマットは LC_CR です。アダプターは、着信メッセージ・フォーマットを LC_CR であると認識すると、データ・ハンドラーを使用して、動詞 Create 付きビジネス・オブジェクト Sample_WebSphereMQ_LegacyContact にメッセージを変換します。その後、この新しく作成されたビジネス・オブジェクトは Test Connector に送達されます。
- メッセージ送達の確認 上記のステップがすべて正常に実行された場合には、適切なサンプル・シナリオが得られ、このシナリオにより WebSphere MQ アダプターがメッセージを検索し、これらのメッセージを Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトに変換し、さらに、逆に Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトを連絡メッセージに変換することが可能になります。
動的メタオブジェクトを使用したシナリオ
このシナリオでは、動的メタオブジェクトを使用して、静的メタオブジェクトのシナリオに定義された各種のキューにビジネス・オブジェクトを転送する方法について説明します。動的メタオブジェクトの詳細については、動的子メタオブジェクトの作成の概要を参照してください。このシナリオの前提条件については、始める前にを参照してください。さらに、静的メタオブジェクトを使用したシナリオの説明に従ってポート・コネクターをインストールおよび構成する必要があります。以下のステップでは、Sample_WebSphereMQ_LegacyContact の子メタオブジェクトの属性を作成します。特に、この子メタオブジェクトの出力キュー値を変更することにより、Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトを新規のキューに転送します。
- 動的メタオブジェクト属性の識別 まず、動的メタオブジェクトが設定された属性を識別するために、アプリケーション固有情報を追加する必要があります。Sample_WebSphereMQ_LegacyContact で、cw_mo_conn=DynMO をアプリケーション固有情報に追加します。これにより属性が識別されます。
- 属性の追加 Business Object
Designer を使用して、以下の手順を実行します。
- sample_folder から Sample_WebSphereMQ_DynMO_Config.xsd および Sample_WebSphereMQ_LegacyContact.xsd を開きます。
- 「Sample_WebSphereMQ_LegacyContact」ウィンドウで、名前が DynMO でタイプが Sample_WebSphereMQ_DynMO_Config の属性を追加します。
- 新しいターゲット・キューの定義 WebSphere MQ の一時キュー REROUTE.IN を定義します。これは、動的メタオブジェクトによる Sample_WebSphereMQ_LegacyContact ビジネス・オブジェクトの転送先です。必要なキューを作成するには、コマンド行から RUNMQSC crossworlds.queue.manager と入力して、以下のコマンドを発行します。DEFINE QL('REROUTE.IN')
- Adapter for WebSphere MQ がまだ稼働していない場合は始動します。
- Visual Test Connector がまだ稼働していない場合は始動します。
- ポート・コネクターのシミュレート (静的メタオブジェクトを使用したシナリオでこのステップをすでに実行している場合は、この作業をスキップして次の作業に進んでください。) Visual Test Connector を使用して、ポート・コネクターのプロファイルを定義します。
- 「Visual Test Connector」メニューから「ファイル」->「プロファイルを作成/選択」を選択し、次に、「コネクター・プロファイル」メニューから「ファイル」->「新規プロファイル」を選択します。
- Samples ディレクトリー内にあるポート・コネクター構成ファイル PortConnector.cfg を選択して、Connector Name および Broker Type を構成してから「OK」をクリックします。
- 作成したプロファイルを選択し、「OK」をクリックします。
- 「Visual Test Connector」メニューから、「ファイル」->「接続」を選択してシミュレートを開始します。
- 親ビジネス・オブジェクトおよび子メタオブジェクトのインスタンスを作成 Visual Test Connector を使用して、以下の手順を実行します。
- ビジネス・オブジェクト Sample_WebSphereMQ_LegacyContact の新規インスタンスを作成し、必要に応じてデフォルト値を変更します。
- DynMO 属性を右クリックして、そのインスタンス Sample_WebSphereMQ_DynMO_Config を作成します。
- 新しいターゲット・キューの設定
- DynMO 属性の横にある + 符号をクリックして、この属性を展開します。
- outputQueue という名前の属性に、ターゲット・キューの名前を入力します。このシナリオの場合、ターゲット・キューは
REROUTE.IN です。queue://<queue manager>/REROUTE.IN?targetClient=1 など完全な URI を入力します。
- ビジネス・オブジェクトの送信 「ビジネス・オブジェクトを送信」をクリックします。
- メッセージ送達の確認 WebSphere
MQ Explorer または同様のアプリケーションを使用してキュー queue://<queue manager>/REROUTE.IN を開き、新規連絡メッセージがアダプターから届いているか確認します。新しいメッセージが WebSphere MQ アダプターから REROUTE.IN というキューに届いていれば、転送が成功したことを示しています。WebSphere MQ で各種のキューを作成し、ビジネス・オブジェクトにこれらのキュー名を指定して送信します。その場合、キュー名はビジネス・オブジェクトのそれぞれの動的メタオブジェクトに指定します。
