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

IBM® Integration Bus で、マップ内のリレーションシップ・ルックアップ変換を手動で実装します。 メッセージ・フローの中でデータを読み取るための FileRead ノードまたは DatabaseRetrieve ノードを定義して構成します。

IBM Integration Bus で FileRead ノードまたは DatabaseRetrieve ノードを手動で実装して、リレーションシップ・ルックアップ変換の変換を完成させます。 オプションで、ファイルからもデータベース表からもデータが取得されない場合は、Compute ノードを使用することもできます。 WebSphere® Enterprise Service Bus では、リレーションシップ・ルックアップ変換をカスタム変換として定義します。

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

以下の手順を手動で実行します。

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

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

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

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

次のステップ:

「変換結果」ビューで、予定タスクを右クリックします。 「完全」を選択します。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2013-05-21 11:18:49


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