ターゲット・エレメントのデータベース・ユーザー定義関数からのマッピング

Mapping ノードで Oracle データベース・ユーザー定義関数をソースとして使用します。

始める前に:

データベース・ユーザー定義関数をデータベース定義に含める必要があります。 WebSphere Message Broker Toolkit へのデータベース定義の追加を参照してください。 このタスクの場合、Oracle データベースのみがサポートされています。

データベース・ユーザー定義関数からターゲット・エレメントをマップするには、Mapping ノードを次のようにセットアップします。
  • ユーザー定義関数を実行してデータベースから該当する行を取得する
  • メッセージのターゲット・エレメントにデータベースからの値を取り込む

ユーザー定義関数からターゲット・エレメントをマップするには、以下のステップを実行します。

  1. ソースまたはターゲットとしてデータベースを追加するで説明されているとおり、ユーザー定義関数をマッピングのソースとして追加します。 ユーザー定義関数をマッピングに追加したら、「ソース」ペインおよび「スプレッドシート」ペインに $db:func 項目が含まれます。 これらの $db:func 項目には、ユーザー定義関数によって使用されるパラメーターの詳細が含まれています。 パラメーターごとに、その名前、モード (IN、INOUT、OUT のいずれか)、およびデータ・タイプが示されます。

    「スプレッドシート」ペインの $db:func 項目には 'for' 行も含まれます。 デフォルトでは、$db:func 項目での 'for' 行の位置は、結果セットに複数のレコードがあるときに、出力メッセージ本体に反復エレメントが含まれることを示します。 結果セット内のレコードごとに別々のメッセージを書き込む場合、「スプレッドシート」ペインの $target エレメントを 'for' 行の下に移動させます。

    モード INOUT または OUT の ref カーソル・パラメーターを指定する Oracle ユーザー定義関数を使用している場合、Mapping ノードはそのパラメーターをパラメーターとしてではなく指定された結果セットとして扱います。 Mapping ノードはモード IN の ref カーソル・パラメーターをサポートしません。

    ref カーソル・データ・タイプの値を戻す Oracle ユーザー定義関数を使用している場合、Mapping ノードはその関数を指定された結果セットとして扱います。

  2. ユーザー定義関数のパラメーターがモード IN または INOUT である場合、それぞれに値を指定します。
    1. 「スプレッドシート」ペインのパラメーターの隣の「値」フィールドに式を入力します。
    2. 「スプレッドシート」ペインでパラメーターを選択し、エレメントをソース・メッセージから「編集」ペインにドラッグして、Enter を押します。
  3. ユーザー定義関数が戻す結果セットごとに、そこに含まれる列を定義します。
    1. 「ソース」ペインで結果セット項目を右クリックし、「結果セット列の追加または除去」を選択します。 「結果セット列の追加または除去」ウィンドウが開きます。
    2. (オプション) 「以前の設定値を次の場所から復元」リストから項目を選択します。 「結果セット列」リストが置き換えられます。
    3. (オプション) 「使用可能なデータベース表列」リストで列を選択し、それを「結果セット列」リストに追加します。
    4. (オプション) 「新しい列」フィールドに列名を入力し、それを「結果セット列」リストに追加します。 この方法を使用して、ユーザー定義関数で指定されている計算済みの列を追加します。
    5. (オプション) 「完了」をクリックしたときに「結果セット列」に表示される列を保存するために使用される名前を「現在の設定値を次の場所に保存」フィールドで変更します。 設定は ¥.metadata ディレクトリーに保存されます。 ステップ 3a で説明されているとおり、別のメッセージ・マップでこれらの設定を取り出すことができます。 デフォルトの名前を変更しない場合、ユーザー定義関数が別のメッセージ・マップで使用されるときに自動的に設定が取り出されます。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:56:11


タスク・トピックタスク・トピック | バージョン 7.0.0.5 | ar25286_