Oracle NetSuiteビジネス・オブジェクトの検索

選択したビジネス・オブジェクトで検索

選択したビジネス・オブジェクトのフィールドで検索を実行できます。次の使用例は、オーケストレートされた統合で選択されたビジネス・オブジェクトのフィールドを使用して検索操作を実行する方法の例を示しています。

アダプタ・エンドポイント構成ウィザードのオペレーション・ページで、「選択したビジネス・オブジェクトで検索」およびビジネス・オブジェクト(この例では、「顧客」 (基本ビジネス・オブジェクトと呼ばれる))が選択されています。これは最も簡単な検索基準です。この例では、「顧客」の処理オプション(たとえば、検索結果にサブリストの値を返す)や関連するビジネス・オブジェクトのフィールド(サブオブジェクト)は選択されていませんが、選択することはできません。

「図selected_bus_objects.pngの説明」
マッパーでは、検索基準を定義することができます。「顧客」ビジネス・オブジェクトのフィールドがターゲット・ツリーに表示されます。アダプタ・エンドポイント構成ウィザードで構成中に選択されたものがないため、関連するビジネス・オブジェクトおよびフィールドはありません。

「図basic_bo_search2.pngの説明」
1つ以上のフィールドを展開し、searchValueと演算子をマッピングすることで検索条件を定義することができます。フィールド・タイプに基づいて、1つ以上のsearchValue要素と演算子が必要になる可能性があります。この例では、検索基準は、「顧客」オブジェクトの名を使用して定義し、ICSNetSuiteを含む必要があることを指定します。

「図basic_bo_search3.pngの説明」
for-eachアクションは、顧客レコードの検索結果(検索の状況、返された合計レコード、ページ・サイズ、合計ページ、ページ・インデックス、検索ID、レコード・リスト)を個別に読み取るように構成できます。

「図basic_bo_search5.pngの説明」

recordListが展開され、「顧客」ビジネス・オブジェクトが戻されることが示されます。ループする繰返し要素は、「顧客」に対して実行できます。

「図basic_bo_search4.pngの説明」

選択したビジネス・オブジェクトおよび関連オブジェクトでの検索

選択したビジネス・オブジェクトおよび関連オブジェクトを検索できます。このタイプの検索では、次のことが可能になります:

関連付けられたビジネス・オブジェクト・フィールドを検索フィルタとして使用してビジネス・オブジェクトを検索します。
ビジネス・オブジェクト・フィールドと関連するビジネス・オブジェクト・フィールドの組み合わせを検索フィルタとして使用してビジネス・オブジェクトを検索します。

次の使用例は、オーケストレートされた統合におけるこのタイプの検索条件構成の例を示しています。

アダプタ・エンドポイント構成ウィザードの操作ページで、「選択したビジネス・オブジェクトおよび関連オブジェクトで検索」およびビジネス・オブジェクト(この例では「顧客」)が選択されています。

「図selected_bus_objects2.pngの説明」
マッパーでは、検索基準を定義することができます。「顧客」 (基本)ビジネス・オブジェクトと関連するすべてのビジネス・オブジェクトのフィールドがターゲット・ツリーに表示されます。

「図join_bo_search4.pngの説明」

検索フィルタは、基本ビジネス・オブジェクトおよび関連するビジネス・オブジェクトに定義できます。この例では、ICSNetSuiteを含む顧客名に、2つの値のいずれかのステータスを持つ関連機会を含む検索が実行されます: inProgressまたはissuedEstimate。

「図join_bo_search2.pngの説明」
for-eachアクションは、顧客レコードの検索結果(検索のステータス、返された合計レコード、ページ・サイズ、合計ページ、ページ・インデックス、検索ID、レコード・リスト)を返すように構成できます。これは、基本検索と同じレスポンスです。

「図basic_bo_search5.pngの説明」

recordListが展開され、「顧客」ビジネス・オブジェクトが戻されることが示されます。ループする繰返し要素は、「顧客」に対して実行されます。

「図basic_bo_search4.pngの説明」
ログ・アクションは、顧客の名字と姓を返して連結するように構成できます。これは、基本検索と同じ構成です。
```
concat ( firstName, lastName)
```

保存済検索を使用した検索

保存された検索を実行できます。このタイプの検索では、以下を参照する検索を実行できます:

既存の保存済み検索。
既存の検索結果を上書きして新しい検索結果列を返します。
既存の保存済み検索で、保存済み検索で既に指定されている条件の上に追加の検索フィルタ条件を追加します。

次の使用例は、オーケストレートされた統合で保存された検索条件の構成の例を示しています。

Adapter Endpoint Configuration WizardのOperationsページで、がSaved Searchを起動します。また、returnの列を選択し、ビジネス・オブジェクト(この例では「顧客」)が選択されます。

「図invoke_saved_search.pngの説明」
アダプタ・エンドポイント構成ウィザードのサマリー・ページに、特定のビジネス・オブジェクト(「顧客」)の保存済検索が表示されます。
「テスト検索」をクリックすると、この検索のビジネス・オブジェクトに対して選択されたレスポンス列の結果が検証されます。このタイプの構成では、既存の保存済み検索を参照する検索を実行できます。
```
Success! Note that it is likely that not every Response Column configured in the saved search
would have been retrieved. Hence it is advised to check the below panel and manually add any 
missing response columns as required.
```
「図basic_opport_join.pngの説明」

また、既存の保存された検索の戻り列を新しい検索戻り列で上書きすることもできます。
「構成の検索」ページで「クリックしてレスポンス列を追加」を選択すると、ページがリフレッシュされ、追加のビジネス・オブジェクトとそのフィールドを選択できます。をクリックして、既存のビジネス・オブジェクトとそのフィールドを編集することもできます。
追加の関連ビジネス・オブジェクト(「パートナ」)と、そのオブジェクト(billAddress)のフィールドが選択されます。

「図saved_search4.pngの説明」
「検索構成」ページには、保存された検索のレスポンス列を上書きする新しいレスポンス列が表示されます。
保存された検索では、追加のマッピングを定義する必要はありません。つまり、アプリケーション・レベルで定義された保存された検索条件がその特定の検索に使用されます。

「図basic_opport_join_part.pngの説明」

for-eachアクションでは、選択されたレスポンス列のみがレスポンスに表示されます。したがって、保存された検索をオーバーライドするために追加された「パートナ」ビジネス・オブジェクトおよびbillAddressフィールドは表示されません。

「図saved_search6.pngの説明」

保存された検索ですでに指定されている条件の上に追加の検索フィルタ基準を追加する既存の保存済み検索を実行する場合にのみマッピングを定義します。
保存された検索の「構成の検索」ページで、「クリックしてレスポンス列を追加」が選択されています。

「図basic_opport_join.pngの説明」
BillingAccountに関連付けられたビジネス・オブジェクトとbillingScheduleおよびcurrencyフィールドが選択されます。

「図saved_search7.pngの説明」
for-eachアクションは、新たに追加されたBillingAccountに関連付けられたビジネス・オブジェクトをレスポンス・リストに表示します。

「図saved_search9.pngの説明」
より多くの検索基準を定義できる統合に追加のマッパーを追加することができます。たとえば、BillingAccountに関連付けられたビジネス・オブジェクトとbillingScheduleおよびcurrencyフィールドの基準を定義できます。

選択したビジネス・オブジェクトおよび関連オブジェクトでの検索と、返す列の選択

選択したビジネス・オブジェクトおよび関連オブジェクトの検索を実行し、戻す列を選択することができます。

次の使用例は、オーケストレートされた統合におけるこのタイプの検索条件構成の例を示しています。

操作ページで、選択したビジネス・オブジェクトおよび関連オブジェクトを検索します。また、returnの列を選択し、ビジネス・オブジェクト(この例では「顧客」)が選択されます。

「図search_select_bus_obj.pngの説明」
「検索構成」ページで、「顧客」オブジェクトが保存された検索の一部として表示されます。戻すレスポンス列を指定するには、「クリックしてレスポンス列を追加」が選択されています。

「図adv_search2.pngの説明」
statusレスポンス列は、関連するビジネス・オブジェクト「商談」に対して選択されます。

「図adv_search3.pngの説明」
「顧客」ビジネス・オブジェクトおよび「商談」関連ビジネス・オブジェクトが表示されます。

「図adv_search4.pngの説明」
マッパーでは、「顧客」基本ビジネス・オブジェクトおよび関連するサブオブジェクトのフィールドにマッピングを定義できます。この例では、フィールドは「顧客」基本ビジネス・オブジェクトのフィールドに定義されています。

「図adv_search5.pngの説明」
for-eachアクションは、「構成の検索」ページで選択されたレスポンス・ビジネス・オブジェクトを戻すように構成できます。「顧客」ビジネス・オブジェクト(姓と名)および関連するビジネス・オブジェクト(状況)の「商談」の検索結果が表示されます。

「図adv_search6.pngの説明」

検索結果からのページ区切り

いずれかの検索基準の検索結果の表示をページ設定することができます。

次の使用例は、検索結果のページごとに5つのレコードを表示するように構成されたオーケストレートされた統合の例を示しています。

LoopOverPages whileアクションは、すべてのページにわたってループします。ループ内では、LoopOverRecords for-eachアクションが検索結果の1ページあたりのレコードをループするように構成されています。

「図page_results6.pngの説明」

アダプタ・エンドポイント構成ウィザードの操作ページで、「選択したビジネス・オブジェクトで検索」およびビジネス・オブジェクト(この例では「顧客」)が選択されています。
操作ページの「処理オプション」リンクが選択されています。「検索ページ・サイズ」の値は5に設定され、検索結果のページごとに5つのレコードが表示されます。

「図page_results7.pngの説明」
InitializeVariables割当てアクションでは、3つの変数を作成して値で初期化する必要があります(できれば1の値): PageIndex、SearchIdおよびTotalPages。 PageIndexの値は、TotalPagesの値以下でなければなりません。それ以外の場合、「Oracle NetSuiteアダプタ」は起動されず、検索結果をページ区切りするfor-eachループが実行されません。

「図page_results1.pngの説明」
LoopOverPages、PageIndexの値がTotalPagesの値以下である間、アクションは検索結果をループするように構成されています。

「図page_results3.pngの説明」
LoopOverRecords for-eachアクションでは、検索結果のページ区切りにtotalPages、pageIndexおよびsearchIdが使用されます。

「図page_results2.pngの説明」
ループが終了する前のAssignVariables assignアクションでは、検索から返されたpageIndexの値が毎回1ずつ増加します。レスポンスの検索IDは、searchIdにマップされます。レスポンスからのページの合計数は、totalPagesにマップされます。

「図page_results4.pngの説明」
マッパーでは、$pageIndexおよび$searchId変数を、リクエストの一部であるsearchIdおよびpageIndexの値にマップする必要があります。

「図page_results5.pngの説明」