ルックアップの管理

ルックアップの作成

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

ナビゲーション・ペインで、「ホーム」>「統合」>「ルックアップ」をクリックします。

「図lookups.pngの説明」
「作成」をクリックします。
「新しいルックアップの作成」ダイアログが表示されます。
参照の名前と説明(オプション)を入力します。
「作成」をクリックします。

Lookupページが表示されます。

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

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

ドメイン名1をクリックします。
メニューとオプションが表示されます。
作成するタイプを選択します。
- アダプタで置換: これを選択すると、使用するアダプタを選択するための「アダプタの選択」ダイアログが起動します。選択は変更することができます。
  - アダプタの選択を変更する場合は、選択したアダプタ・タイプをクリックし、「Select Different Adapter」を選択します。
  - アダプタからドメイン名に変更する場合は、選択したアダプタ・タイプをクリックし、「Replace with Domain Name」を選択します。
- Enter Domain Name: これを選択すると、使用するドメイン名を入力するダイアログが呼び出されます。 50文字の制限があります。選択は変更することができます。
  - ドメイン名からアダプタに変更する場合は、ドメイン名をクリックし、「Replace with Adapter」を選択します。
  - ドメイン名を変更する場合は、名前をクリックし、「Edit Domain Name」を選択します。
  アダプタまたはドメイン名が表示されます。
アダプタまたはドメイン名の下のフィールドに値を入力します。値を追加するためにさらに行を追加するには、+記号をクリックします。
ドメイン名2をクリックします。
ステップ2を繰り返して、アダプタまたはドメイン名を追加します。
アダプタまたはドメイン名の下のフィールドに値を入力します。値を追加するためにさらに行を追加するには、+記号をクリックします。

「図create_new_lookup.pngの説明」
別の列を追加する場合は、+をクリックします。
アダプタまたはドメイン名をさらに参照に追加する場合は繰り返します。
完了したら「Save」をクリックします。

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

既存の参照のコピーをクローニングすることができます。これは類似した情報を含む新しい参照をすぐに作成できる方法です。アダプタまたはドメイン名を含む参照をクローニングすることができます。

ナビゲーション・ペインで、「ホーム」>「統合」>「ルックアップ」をクリックします。
クローニングする参照の行に移動します。
ルックアップ・ページで、メニューから「クローン」を選択します。
「Clone Lookup」ダイアログが表示されます。
参照の情報を入力します。
「Clone」をクリックします。
クローニングされた参照をさらに構成するには、「編集」をクリックします。

ルックアップの削除

「Lookup」メニューから接続を削除できます。

ナビゲーション・ペインで、「ホーム」>「統合」>「ルックアップ」をクリックします。
削除する参照の行に移動します。
メニューから、「削除」を選択します。
「Delete Lookup」ダイアログが表示されます。
「Yes」をクリックして削除を確認します。

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

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

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

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

ルックアップを作成したら、そのルックアップをエクスポートして他のOracle Integration環境で使用することができます。「Lookup Designer」または「Lookups」リストから参照をエクスポートできます。

参照をエクスポートするには:

ナビゲーション・ペインで、「ホーム」>「統合」>「ルックアップ」をクリックします。
エクスポートする参照の行に移動します。
メニューから、「CVSへのエクスポート」を選択します。
表示されるダイアログで、「Save File」を選択してから「OK」をクリックします。
任意の場所にファイルを保存します。

このファイルは、参照と同じ名前でCSVファイルとして保存されます。

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

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

インポートするファイルには、最初の行について次のものが必要です。table_nameは、Oracle Integrationに表示される表の名前です。この名前にはスペースを含めることはできません。

DVM,table_name

第2行目には、マッピングされるアダプタの名前が含まれます。各アダプタについて次のIDを使用します(このIDでは大/小文字が区別されます)。

アダプタ名	インポート・ファイルで使用される識別子
Oracle Eloqua Cloud	eloqua
Oracle Engagement Cloud	osc
Oracle Messaging Cloud Service	oms
Oracle Service Cloud	rightnow
Oracle HCM Cloud	hcm
Oracle ERP Cloud	erp
Salesforce Cloud	salesforce

参照をインポートするには:

インポートする参照表を含むCSVファイルを探します。
ナビゲーション・ペインで、「ホーム」>「統合」>「ルックアップ」をクリックします。
バナーで、「Import」をクリックします。
「Import Lookup」ダイアログで、「Browse」をクリックして、インポートするCSVファイルにナビゲートして選択します。
「インポート」をクリックします。
同じ識別子とバージョンの参照がすでに存在している場合、既存の参照を上書きするかどうかを確認する必要があります。

インポートされた参照が、左側の「Lookups」リストに表示されます。準備が整ったら、カスタマイズまたはアクティブ化できます。

lookupValue関数を作成

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

トピック:

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

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

Build Lookup Functionウィザードにアクセスするには:

ノート:

このウィザードを使用するには、あらかじめ参照を作成しておく必要があります。「ルックアップの管理」を参照してください。

マッパーから:
「ルックアップ関数の作成ウィザードへのアクセス」を参照してください。
switchアクションなどのアクションの式ビルダーから:
1. 「Integrations」ページに移動します。
2. 統合を開きます。
3. 統合内から式ビルダーを呼び出します。たとえば:
  - アプリケーション・ドリブンのオーケストレートされた統合で、switchアクティビティを編集します。
  - 基本的なルーティング統合では、「フィルタ」リンクをクリックします。
  式ビルダーが表示されます。
4. 「Components」を展開します。
5. 「関数」 > Oracle Integrationを展開します。
6. lookupValue関数を開いて、Build Lookup Functionウィザードおよび式ビルダーでの定義に使用可能なパラメータを表示します。
  - dvmLocation
  - srcColumn
  - srcValue
  - targetColumn
  - defaultValue
7. lookupValue関数を「New Condition」フィールドにドラッグします。
  
  Build Lookup Functionウィザードが表示されます。 lookupValue関数のパラメータ値を作成するには、第「ルックアップ表の選択」項を参照してください。

ルックアップ表の選択

lookupValue関数で使用する参照表を選択します。

ノート:

あらかじめ参照を作成してある必要があります。それ以外の場合は、参照が選択対象として表示されません。

要素	説明
Lookup Table	関数で使用する参照表を選択します。表の情報アイコンをクリックすると、参照の説明を表示できます。この情報を手掛かりに、必要な参照表を選択できます。参照に定義された列の数も表示されます。

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

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

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

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

「Default Value」を指定します

lookupValue関数で使用するデフォルト値を選択します。

一致するものが見つからない場合に使用するデフォルト値を入力します。すべての検索値を満たすものが見つからない場合は、参照が失敗し、デフォルト値が返されます。

要素	説明
Default Value	一致するものが見つからない場合に使用するデフォルト値を入力します(たとえば、使用する実際のデフォルト値または`No Value Found`などのエラー・メッセージ)。

参照表の選択の確認

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

「Summary」ページで、参照表の値を確認できます。 Summaryページは、構成を完了した後の最後のウィザード・ページです。

要素説明

要素	説明
Parameter and Value Table	ウィザードの前のページで定義したパラメータと値のサマリーが表示されます。前のページに戻って値を更新するには、左パネルで適切なタブをクリックするか、「Back」をクリックします。
Resulting Expression	ウィザードの前のページで定義した式が表示されます。 `lookupValue`関数の書式は次のようになります。 `lookupValue(dvmLocation, srcColumn, srcValue, targetColumn, defaultValue)` 説明: `dvmLocation`: 「Select Lookup Table」ページで選択した参照表。 `srcColumn`: 「Select Columns」ページで選択したソース列。 `srcValue`: このウィザードの完了後に式ビルダーの「New Condition」フィールドに入力するソース値。「Done」をクリックしてこのウィザードを完了してから、`srcValue`パラメータ値を定義します。 `targetColumn`: 「Select Columns」ページで選択したターゲット列。 `defaultValue`: 「Default Value」ページで入力したデフォルト値。たとえば、ウィザードを完了して、式ビルダーで`srcValue`パラメータ値を定義すると、定義済の`lookupValue`関数は次のようになります。 `dvm:lookupValue('tenant/resources/dvms/Country','rightnow','US','mysoap','No data found')`

Parameter and Value Table

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

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

Resulting Expression

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

 lookupValue(dvmLocation, srcColumn, srcValue, targetColumn, defaultValue)

説明:

dvmLocation: 「Select Lookup Table」ページで選択した参照表。
srcColumn: 「Select Columns」ページで選択したソース列。
srcValue: このウィザードの完了後に式ビルダーの「New Condition」フィールドに入力するソース値。「Done」をクリックしてこのウィザードを完了してから、srcValueパラメータ値を定義します。
targetColumn: 「Select Columns」ページで選択したターゲット列。
defaultValue: 「Default Value」ページで入力したデフォルト値。

たとえば、ウィザードを完了して、式ビルダーでsrcValueパラメータ値を定義すると、定義済のlookupValue関数は次のようになります。

dvm:lookupValue('tenant/resources/dvms/Country','rightnow','US','mysoap','No data found')

「完了」をクリックすると、functionアイコンがマッパー内に作成され、関数XPath式が式ビルダーに表示されます。