機械翻訳について

ルックアップの管理

参照によって、特定のフィールドの1つのアプリケーションで使用される値が、同じフィールドの他のアプリケーションで使用される値に関連付けられます。 この機能により、複数の語彙またはシステム間で値をマップできます。 たとえば、国コード、市区町村コード、通貨コードなどをマッピングできます。

トピック:

ノート:

#の特殊文字を含む参照値の指定はサポートされていません。

ルックアップの作成

参照を作成して、アプリケーション間で値をマッピングします。

  1. 開始する場所を決定します:
    • プロジェクトでの作業(「プロジェクトの使用をお薦めします」の理由を参照)。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、参照が現在存在しない場合は「追加」をクリックし、参照がすでに存在する場合は+をクリックします。 参照の追加パネルが開きます。
      5. 「作成」をクリックします。 ルックアップの作成パネルが開きます。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. バナーで、「作成」をクリックします。 ルックアップの作成パネルが開きます。
  2. 次の情報を入力します。
    フィールド 説明

    名前

    他のユーザーが参照を理解できるように、わかりやすい名前を指定します。 識別子に使用できるのは、英字、数字、アンダースコアおよびハイフンです。

    キーワード 検索を識別するためのキーワード(タグ)を入力します。 キーワードを使用して参照を検索できます。

    説明

    他のユーザーが参照を理解できるように、わかりやすい摘要を指定します。

    他のプロジェクトと共有

    ノート: このフィールドは、プロジェクトで参照を作成している場合にのみ表示されます。

    この参照を他のプロジェクトで公開できるようにする場合に選択します。 参照共有により、異なるプロジェクトで個別の参照を作成および保守する必要がなくなります。

    作成後、「他のプロジェクトと共有」フィールドは、参照の詳細ページの上部に「オン」として表示されます。 その参照を他のプロジェクトで参照して、そのリソースを継承できます。

    「プロジェクト間の参照の追加および共有」を参照してください。

  3. 「作成」をクリックします。
    検索は暗号化された形式で格納されます。

ルックアップへのアダプタまたはドメイン名の追加

参照にアダプタまたはドメイン名を追加して、接続間の値をマッピングします。

  1. Domain_Name_1をクリックします。
    メニューとオプションが表示されます。
  2. 作成するタイプを選択します。

    • アダプタで置換: この選択により、使用するアダプタを選択するためのアダプタの選択ダイアログが起動します。 選択は変更することができます。

      • アダプタの選択を変更する場合は、選択したアダプタ・タイプをクリックし、別のアダプタを選択します。

      • アダプタからドメイン名に変更する場合は、選択したアダプタ・タイプをクリックし、ドメイン名に変更します。

    • ドメイン名の編集: この選択により、使用するドメイン名を入力するためのダイアログが起動します。 50文字の制限があります。 選択は変更することができます。

      • ドメイン名からアダプタに変更する場合は、ドメイン名をクリックし、「アダプタで置換」を選択します。

      • ドメイン名を変更する場合は、名前をクリックし、「ドメイン名の編集」を選択します。

      アダプタまたはドメイン名が表示されます。

  3. アダプタまたはドメイン名の後のフィールドに値を入力します。 値を追加するためにさらに行を追加するには、+記号をクリックします。
  4. Domain_Name_2をクリックします。
  5. ステップ2を繰り返して、アダプタまたはドメイン名を追加します。
  6. アダプタまたはドメイン名の後のフィールドに値を入力します。 値を追加するためにさらに行を追加するには、+記号をクリックします。
  7. 別の列を追加する場合は、+をクリックします。
  8. アダプタまたはドメイン名をさらに参照に追加する場合は繰り返します。
  9. 完了したら「Save」をクリックします。

ルックアップのクローンを作成

Oracle Integrationの既存のルックアップのコピーをクローニングできます。 クローニングでは、類似の情報を使用して新しい参照をすばやく作成できます。 アダプタまたはドメイン名を含む参照をクローニングすることができます。

  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、クローンを作成する参照にマウス・ポインタを重ねます。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. 参照の上にカーソルを置き、クローニングします。
  2. 「アクション」 「アクション」アイコンをクリックし、「クローン」を選択します。
    クローン・ルックアップ・パネルが開きます。
  3. 名前とオプションのキーワードと説明を入力します。
  4. 「クローン」をクリックします。

ルックアップの削除

統合で現在使用されていないOracle Integrationのルックアップを削除できます。 使用中の参照を削除しようとすると、統合が無効になり、アクティブな統合の実行が停止します。 最初に統合からルックアップを削除してから、ルックアップを削除する必要があります。

  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、削除する参照にマウス・ポインタを重ねます。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. 参照の上にマウス・ポインタを重ねて削除します。
  2. 「アクション」 「アクション」アイコンをクリックし、「削除」を選択します。
    検索の削除ダイアログが表示されます。

  3. 確認を求められたら、「削除」をクリックします。

参照の編集

ルックアップを編集できます。

  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、編集する参照を検索します。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. 参照の上にマウス・ポインタを重ねて編集します。
  2. 「アクション」 「アクション」アイコンをクリックし、「編集」を選択します。

アクティブな統合のルックアップの更新

ルックアップは統合のアクティブ化の一部としてデプロイされません。 したがって、通常、アクティブな統合ですでに使用されている参照に加えた変更は、すぐに有効になります。 新しいルックアップ値を有効にするために、変更されたルックアップを使用して統合を再度アクティブにする必要はありません。

ランタイム環境に対する更新は、リアルタイムではなく、実行時にキューイングが発生する可能性があるため、低速な場合があります。 そのような場合、更新は数分で発生することがあります。

ルックアップのエクスポート

ルックアップを作成したら、そのルックアップをエクスポートして他のOracle Integration環境で使用することができます。

  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、エクスポートする参照の名前をクリックします。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. 参照の上にマウス・ポインタを重ねてエクスポートします。
  2. 「アクション」 「アクション」アイコンをクリックし、「CVSへのエクスポート」を選択します。
このファイルは、参照と同じ名前でCSVファイルとして保存されます。

ルックアップのインポート

以前にOracle Integrationからエクスポートされたルックアップをインポートできます。

インポートするファイルの最初の行には、次のものが必要です。table_nameは、Oracle Integrationに表示する表の名前です。 この名前にはスペースを含めることはできません。 
DVM,table_name
  1. インポートする参照表を含むCSVファイルを探します。
  2. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、参照が現在存在しない場合は「追加」をクリックし、参照がすでに存在する場合は+をクリックします。 参照の追加パネルが開きます。
      5. 「インポート」をクリックします。 インポート・ルックアップ・パネルが開きます。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. バナーで、「Import」をクリックします。 インポート・ルックアップ・パネルが開きます。
  3. 「ドラッグ・アンド・ドロップ」をクリックしてルックアップを選択するか、このフィールドにドラッグします。
  4. 「インポート」をクリックします。
    同じ識別子とバージョンの参照がすでに存在している場合、既存の参照を上書きするかどうかを確認する必要があります。
インポートされたルックアップがルックアップ・リストに表示されます。 準備が整ったら、カスタマイズまたはアクティブ化できます。

AIを利用した参照の説明の作成

AIを使用して、新しい説明を生成したり、参照の既存の説明を1回のクリックで置き換えることができます。

「AIイノベーションとOracle Integration」を参照してください。

  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「参照」セクションで、AIによって生成された説明を作成する参照にマウス・ポインタを重ねます。
      5. 「アクション」 「アクション」アイコンをクリックし、「編集」を選択します。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「参照」の順にクリックします。
      2. AIによって生成された摘要を作成する参照にマウス・ポインタを重ねます。
      3. 「アクション」 「アクション」アイコンをクリックし、「編集」を選択します。
  2. 右上隅にある「アクション」 「アクション」アイコンをクリックし、「情報を編集」を選択します。
  3. 「生成」をクリックします。

    ノート:

    • AIエンジンを構成していない場合は、「生成」をクリックするとエラー・メッセージが表示されます。
    • APIキー数の制限に達すると、認可されていないキー・エラーが表示されます。
    「説明」フィールドは空にすることも、説明をすでに含めることもできます。
    • 「説明」フィールドが空の場合、生成された参照の説明がフィールドに追加されます。
    • 「説明」フィールドにすでに参照の説明が含まれている場合は、更新された説明がポップアップとして表示されます。 この例では、説明がすでに存在します。


    「情報の編集」パネルには、「名前」、「キーワード」および「説明」のフィールドが表示されます。 参照の説明が表示されます。 「再試行」ボタン、「置換」ボタンおよび「クローズ」ボタンが摘要の下部に表示されます。

  4. 説明フィールドにすでに説明が含まれている場合は、次のいずれかのステップを実行します:
    1. 「再試行」をクリックして説明を再生成します。 再試行すると、使用される単語に関して新しい説明が若干異なりますが、意味は同じままです。
    2. 「置換」をクリックして、「説明」セクションの現在の説明を置き換えます。 「置換」は、参照が編集可能な場合にのみ選択できます。
  5. 「情報の編集」パネルの外側をクリックします。
  6. 「保存」をクリックします。

lookupValue関数を作成

参照値のマップ・ウィザードを使用して、lookupValue関数のパラメータ値を作成できます。 このウィザードを使用すると、参照表、ソース列、ターゲット列のほか、関数で使用するデフォルト値を定義できます。 これらのパラメータ値をウィザードで選択できるようにするには、「Lookups」ページであらかじめ参照を作成してあることが必要です。

トピック:

Lookup関数のビルド・ウィザードへのアクセス

lookupValue関数パラメータ値を作成するためのマップ参照値ウィザードは、Oracle Integrationの関数をサポートするアクションで、マッパーまたは式ビルダーからアクセスできます。

s

ノート:

このウィザードを使用するには、あらかじめ参照を作成しておく必要があります。

マッパーから

  1. 右上隅にある「関数の切替え」 マッパー関数アイコンをクリックして、「コンポーネント」パネルを起動します。
  2. 「検索」フィールドにlookupValueと入力し、「検索」をクリックします。
  3. 関数をターゲット要素ノードにドラッグします。

    マップ参照値ウィザードが表示されます。


    「マップ・ルックアップ値」パネルには、ウィザード・ステップが上部に表示されます: Lookup、Select Columns、Select DefaultおよびSummaryを選択します。 この後に、参照名、列数および情報アイコンが表示されます。

関数をサポートするアクションの式ビルダーから

スイッチ、ステッチなどの機能をサポートするアクションで、式ビルダーのマップ・ルック・アップ値ウィザードにアクセスできます。

  1. 統合を開いて編集します。

  2. 統合で機能をサポートするアクションを開きます(この例では、スイッチアクションが表示されますが、ステッチなどの他のアクションを使用できます)。

    ルートの構成パネルが開きます。

  3. 値を手動で入力するか、ドロップダウン・リストから値を選択するか、「ソース」ツリーから最初の「値」フィールドに値をドラッグします。 この例では、tracking_var_1が選択されています。
  4. 「オペレータ」フィールドでオペレータを選択します。

  5. 「関数」をクリックし、lookupValueを参照または検索します。

  6. lookupValueをクリックします。
  7. サポートされているパラメータの詳細は、関数の後に説明を表示します。 これらのパラメータの値は、マップ参照値ウィザードで定義します。

    • dvm-location

    • src-column

    • src-value

    • target-column

    • default-value

  8. 2番目の「値」フィールドで「開発者ビューに切替え」 ビューのスイッチアイコンをクリックします。

  9. lookupValue関数を2番目の「値」フィールドにドラッグします。


    lookupValue関数は、ルートの構成パネルの2番目の値フィールドにドラッグされます。

    マップ参照値ウィザードが表示されます。


    「マップ・ルックアップ値」パネルには、ウィザード・ステップが上部に表示されます: Lookup、Select Columns、Select DefaultおよびSummaryを選択します。 この後に、参照名、列数および情報アイコンが表示されます。

    lookupValue関数のパラメータ値を作成します。

ルックアップの選択

lookupValue関数で使用するルックアップを選択できます。 あらかじめ参照を作成してある必要があります。 それ以外の場合は、参照が選択対象として表示されません。

  1. 関数で使用するルックアップを選択します。 行の情報アイコンをクリックすると、ルックアップの説明を表示できます。 これによって、必要なルックアップを選択できます。 参照に定義された列の数も表示されます。

  2. 「次」 >をクリックします。

ソース列とターゲット列の選択

lookupValue関数で使用するソース列とターゲット列を選択できます。 lookupValue関数には、1つのソース列と1つのターゲット列が必要です。 ソース列とターゲット列を選択すると、列で使用可能な値が表示されます。

  1. lookupValue関数で使用するソース列およびターゲット列を選択します。
    要素 説明

    ソースの選択

    ソース列ヘッダーをクリックして、この参照表で使用可能な列のリストから選択します。 選択した列とともに含まれているデータが表示されます。 アダプタとドメイン名の両方の列が表示されます。

    ターゲットの選択

    ターゲット列ヘッダーをクリックして、この参照表で使用可能な列のリストから選択します。 選択した列とともに含まれているデータが表示されます。 アダプタとドメイン名の両方の列が表示されます。

  2. 「次」 >をクリックします。

「Default Value」を指定します

使用するデフォルト値を指定する必要があります。

  1. 一致が見つからない場合にlookupValue関数で使用するデフォルト値を入力します。 すべての検索値を満たす一致がない場合、ルックアップは失敗し、デフォルト値(実際に使用するデフォルト値やNo Value Foundなどのエラー・メッセージなど)が返されます。
  2. 「次」 >をクリックします。

参照表の選択の確認

「Summary」ページのlookupValue関数で使用する参照表の値を確認できます。

  1. ルックアップ表の値をレビューします。 「サマリー」ページは、構成を完了した後の最後のウィザード・ページです。
    要素 説明

    Parameter and Value Table

    ウィザードの前のページで定義したパラメータと値のサマリーが表示されます。

    前のページに戻って値を更新するには、左パネルで適切なタブをクリックするか、「戻る」をクリックします 「戻る」アイコン

    Resulting Expression

    ウィザードの前のページで定義した式が表示されます。 lookupValue関数の書式は次のようになります。 

     lookupValue(dvm-location, src-column, src-value, target-column, default-value)

    説明:

    • 参照表: 参照の選択ページで選択された参照表。

    • ソース列: 列の選択ページで選択されたソース列。

    • ソースの値: このウィザードの完了後にマッパーまたは式ビルダーに入力するソース値。 このウィザードを完了し、srcValueパラメータ値を定義します。

    • ターゲット列: 列の選択ページで選択されたターゲット列。

    • デフォルト値: デフォルト値ページで入力したデフォルト値。

    たとえば、ウィザードを完了して、式ビルダーでsrcValueパラメータ値を定義すると、定義済のlookupValue関数は次のようになります。
    dvm:lookupValue('countrycode', 'countrycode', srcValuePlaceHolder, 'name',
    'No data found')

    たとえば:


    ルックアップの選択、列の選択、デフォルトの選択および要約アイコンが表示されます。 この下にはサマリー・セクションがあります。 この下には、選択したルックアップ(国コード)と、割り当てられたパラメータと値があります。 この下には結果の式があります。 この下には取消および完了ボタンがあります。

  2. 「完了」をクリックします。
  3. 「ソース」ツリーで、値をドラッグして「値」フィールドのsrcValuePlaceHolderを置き換えます。


    「入力ソース」タブ(選択済)および関数タブが表示されます。 $tracking_var_1要素が選択されています。 右側には値フィールド、演算子フィールドおよび値フィールドがあります。 2番目の値フィールドでは、式のsrcValuePlaceHolderで$tracking_var_1が削除されています。

  4. 「保存」をクリックします。

    構成済のファンクションをマッパーで使用できます。 「Oracle Integration 3でのOracle Mapperの使用」の「関数、演算子およびXSLT文の追加」を参照してください。