リレーションシップ・ルックアップ変換を組み込んだマップに関する予定タスクの完成

IBM® Integration Bus では、FileRead ノード、JavaCompute ノード、Database ノード、または DatabaseRetrieve ノードを手動で実装し、WebSphere® Enterprise Service Bus マップで定義されたリレーションシップ・ルックアップ変換を再作成します。ファイルからもデータベース表からもデータが取得されない場合は、オプションで、Compute ノードまたは JavaCompute ノードを使用できます。その後、これらのノードのいずれかを、データの変換を担当する Mapping ノードに接続します。

始める前に:

IBM Integration Bus のご使用のバージョンのメッセージ・フロー・ノードの使用に適用される制約事項を確認してください。詳しくは、各動作モードに適用される制約事項を参照してください。

WebSphere Enterprise Service Bus では、リレーションシップ・ルックアップ変換をカスタム変換として定義します。 リレーションシップ・ルックアップ変換は、静的相互参照データ間のリレーションシップ管理を行います。 リレーションシップ・ルックアップ変換のソースとターゲットは、単純タイプでなければなりません。 一般に、リレーションシップを使用して変換するデータは、ID 番号 (注文 ID や製品 ID など) や、コードで表されるその他の値 (国や通貨、婚姻状況など) です。

WebSphere ESB 変換ツールは、リレーションシップ・ルックアップ変換が検出されるマップにプレースホルダー「タスク」を作成します。

IBM Integration Bus にリレーションシップ・ルックアップ変換を再作成するには、以下の手順を実行します。

  1. WebSphere Enterprise Service Bus での静的リレーションシップを取り込むために使用する値を入れたコンマ区切り値ファイルまたはデータベース表を作成します。
  2. 次のいずれかのメッセージ・フロー・ノードを選択します。
    • ステップ 1 でファイルを作成した場合は、FileRead ノードを選択します。 詳しくは、FileRead ノードを参照してください。
    • ステップ 1 でファイルを作成した場合は、JavaCompute ノードを選択します。 詳しくは、JavaCompute ノードを参照してください。
    • ステップ 1 でデータベース表を作成した場合は、Database ノードを選択します。 詳しくは、Database ノードを参照してください。
    • ステップ 1 でデータベース表を作成した場合は、DatabaseRetrieve ノードを選択します。 詳しくは、DatabaseRetrieve ノードを参照してください。

    メッセージ・フローの中でファイルからデータを読み取るには、FileRead ノードまたは JavaCompute ノードを使用します。詳しくは、結果メッセージと着信メッセージの結合を参照してください。

    データベースからの情報を使用してメッセージを変更するには、Database ノードまたは DatabaseRetrieve ノードを使用します。 詳しくは、メッセージ・フローからデータベースへのアクセスを参照してください。

  3. 前の手順のノードのいずれかをメッセージ・フローへドラッグ・アンド・ドロップします。
  4. メッセージ・フロー・ノード (message flow node)のプロパティーを構成します。
    • FileRead ノードを構成します。
      1. 「レコードおよびエレメント」プロパティーを構成します。 これらのプロパティーは、ファイル内のレコードの識別方法を定義します。
      2. 「結果」プロパティーを構成します。 これらのプロパティーは、データの受け渡し方法を定義します。
        • 「レコード選択式」プロパティーを構成して、ファイルから正しいレコードを選択するために使用する式を指定する必要があります。
    • JavaCompute ノードの「Java クラス」プロパティーを構成します。このプロパティーは、使用する Java クラスの名前を定義します。
    • 以下のように、DatabaseRetrieve ノードを構成します。
      1. 「基本」プロパティーを構成します。 これらのプロパティーは、データベース表の特性を定義します。
      2. 「データ・エレメント・テーブル」プロパティーを構成します。 これらのプロパティーは、取得するデータについての情報を定義します。
        • 「データ・エレメント」プロパティーを構成して、データベース表から正しいレコードを選択するために使用する式を指定する必要があります。
    • Database ノードの 「基本」プロパティーを構成します。 これらのプロパティーは、データベース表の特性を定義します。
      • 「ステートメント」プロパティーを構成して、データベース表から正しいレコードを選択するために使用する式を指定する必要があります。
      • 「データ・ソース」プロパティーを構成して、表を格納するデータベースを定義する必要があります。
  5. 手順 2 で選択したノードが Mapping ノードの前と後のどちらに必要かを判別します。
    • XML マップ内のインバウンド・エレメントからルックアップ変換が呼び出される場合は、手順 2 で選択したノードの出力ターミナルを Mapping ノードの In ターミナルまたは Compute ノードの In ターミナルに接続します。
    • XML マップ内のアウトバウンド・エレメントからルックアップ変換が呼び出される場合は、Mapping ノードの Out ターミナルを手順 2 で選択したノードの In ターミナルに接続します。
  6. オプション: 手順 2 で選択したノードが Mapping ノードの前に必要な場合、以下の手順を実行します。
    • ファイルからデータが正常に取得された場合は、FileRead ノードまたは JavaCompute ノードの Out ターミナルを接続します。
    • ファイルがファイル・システムに存在しないか、存在するがフィルター式と一致するレコードが見つからない場合は、FileRead ノードの No match ターミナルまたは JavaCompute ノードの Alternate ターミナルを Compute ノードの In ターミナルに接続します。
    • 外部リソースからデータが正常に取得された場合は、DatabaseRetrieve ノードまたは Database ノードの Out ターミナルを接続します。
    • 結果セットが空の場合は、DatabaseRetrieve ノードの KeyNotFound ターミナルを Compute ノードの In ターミナルに接続します。
  7. オプション: 出力値が空または定義されていないシナリオを処理するには、以下の手順を実行します。
    1. 出力値を定義します。
      • WebSphere Enterprise Service Bus でプロパティー com.ibm.wbit.mapping.xml.lookup.default の値が定義されている場合は、この値を使用するように出力値を設定します。
      • プロパティーが定義されていない場合、出力値を空ストリングに設定します。
    2. Compute ノードまたは JavaCompute ノードをメッセージ・フローへドラッグ・アンド・ドロップします。
    3. XML マップ内のインバウンド・エレメントからルックアップ変換が呼び出される場合は、Compute ノードまたは JavaCompute ノードの Out ターミナルを Mapping ノードの In ターミナルに接続します。
    4. XML マップ内のアウトバウンド・エレメントからルックアップ変換が呼び出される場合は、Mapping ノードの Out ターミナルを Compute ノードまたは JavaCompute ノードの In ターミナルに接続します。

次のステップ:

  1. マップで、次のようにして、プレースホルダー「タスク」を削除します。「タスク」を右クリックして、「削除」を選択します。
  2. 「結果の確認」ビューで、予定タスクを右クリックします。「完全」を選択します。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        最終更新:
        
        最終更新: 2013-07-17 15:21:40


タスク・トピックタスク・トピック | IBM Integration Bus バージョン 9.0.0.0 | bm33076_