Oracle NetSuiteアダプタを使用したカスタム・フィールド検出

Oracle NetSuiteアダプタによるカスタム・フィールド検出

マッパーでの統合の設計時、およびOracle NetSuiteアダプタを使用した拡張検索および保存済検索操作のためのNetSuiteエンドポイントの作成時に、標準オブジェクトの単純型および複合型のカスタム・フィールドを公開できます。マッパーでは、検出されたカスタム・フィールドはすべての検索およびCRUD操作に使用できます。拡張検索および保存済検索のエンドポイント設計時に、レスポンス列の選択中に検出されたカスタム・フィールドを使用できます。

ノート:

統合を再編集せずに異なるOracle NetSuiteアカウント間でカスタム・フィールド検出が機能するようにするには、これらのアカウント間でscriptIdの一貫性を保ちます。これを確認するには、Oracle NetSuiteアカウント間で同じscriptIdを使用して必要なカスタム・フィールドを作成します。

マッパーでの標準オブジェクトのカスタム・フィールドの公開

Oracle NetSuiteアダプタとのマッパーで統合を設計する際に、標準オブジェクトの単純型および複合型のカスタム・フィールドを公開できます。

このユースケースでは、次の統合のための設計プロセスの概要を説明します。

ノート:

「Oracle NetSuiteアダプタ」では、すべての標準オブジェクトの名前付きカスタム・フィールドは検出されません。

「図completed_integration.pngの説明」

オーケストレーションされた統合を作成します。
統合にトリガー接続を追加します。この例では、RESTアダプタが次のように追加および構成されます:
- エンドポイントでPOSTアクションを実行します。
- JSONリクエスト・ペイロードをエンドポイントに送信します。
- JSONレスポンス・ペイロードを返すようにこのエンドポイントを構成します。
カスタム・フィールドを更新(アップサート)するには、Oracle NetSuiteアダプタ接続(この例では、NetSuiteUpsertCustomField)を追加します。

ノート:
カスタム・フィールドの検出をサポートするリリースより前に作成された接続を使用するには、まず、このOracle NetSuiteアダプタ接続の接続ページのメニューから「メタデータのリフレッシュ」を選択する必要があります。このタスクは、新しいOracle NetSuiteアダプタ接続には必要ありません。「統合メタデータのリフレッシュ」を参照してください。

「図netsuite_adapter.pngの説明」
RESTアダプタとOracle NetSuiteアダプタの間のマッパーで顧客リクエストを構成します。この例では、「顧客」「更新」操作が構成されます。
1. ターゲットの「顧客」>customFieldList>customFieldを展開し、ソースのinternalIdおよびscriptId要素をノートします。マッパーの正しいカスタム・フィールドにマップするには、「統合で複合タイプのカスタム・フィールドを使用するための前提条件」で説明されているNetSuiteアプリケーションから取得したinternalIdおよびscriptId要素に内部ID値を渡す必要があります。これは、customFieldをマッピングするメソッドです。 NetSuiteからinternalIdおよびscriptIdの値を検索してマップする必要があります。
  
  「図netsuite_internalid.pngの説明」
2. ターゲット要素をクリックして、渡す値を追加します。完了すると、Aが「マッピング・キャンバス」に表示されます。次に例を示します。
  - internalId値は、4565で構成されます。
  - scriptId値は、custentity_cust_priorityで構成されます。 scriptIdは、NetSuiteアプリケーションから取得されます。
3. 標準オブジェクトのカスタム・フィールドにマップします。標準オブジェクトは、「顧客」>customFieldListの下に1つ上のレベルで表示されます。
  基本的なCRUD操作の場合、カスタム・フィールドはマッパーで名前付きフィールドとして公開されます。カスタム・フィールド名は、NetSuiteのカスタム・フィールドに指定された名前から導出されます。これにより、標準オブジェクトの特定のカスタム・フィールドのinternalIdおよびscriptIdを知る必要なく、マッピングが容易になります。この例では、NetSuiteの更新操作に対してマッピングが実行されます。 RESTアダプタのトリガー接続から標準オブジェクトのNetSuite更新操作へのリクエスト・マッピングが表示されます。
  「
  図netsuite_custom_fields.pngの説明」
  
  次の2つのタイプのカスタム・フィールドがあります(どちらもこの例で示されています):
  - 複合: 複数のアイテムを渡すことができます。この例では、ターゲット複合フィールドAdvertisingPreferenceは、1 of 2 ListItemおよび2 of 2 ListItemを使用してマッパーで展開され、複数の値を渡すように表示されています。 ListItemを展開すると、listItemIdフィールドが表示されます。listItemIdは、複合タイプ・カスタム・フィールドのいずれかのリスト・メンバーのinternalIdを参照します。これはcustomFieldのinternalIdではありません。
  - 簡易: 1つのアイテムを渡すことができます。この例では、ある値を渡すために、ターゲットの単純フィールドICSEmailIdがnilを含むマッパーで展開されて表示されます。
別のOracle NetSuiteアダプタ (この例では、NetSuiteGetCustomFieldという名前)を追加して、顧客アカウント番号を取得します。

「図netsuite_adapter2.pngの説明」
ソースinternalIdをターゲットinternalIdに渡すように、2つのOracle NetSuiteアダプタ間のマッパーを構成します。

「図netsuite_id.pngの説明」
ソースCustomerResponse > 「顧客」 > sequence > customFieldListの下の2番目のOracle NetSuiteアダプタ (NetSuiteGetCustomField)の後にマッパーを構成して、顧客レスポンスを取得します。

「図mapper_get_response.pngの説明」

統合設計が完了しました。

拡張検索および保存済検索操作でのカスタム・フィールドの公開

Oracle NetSuiteアダプタを使用した拡張検索および保存済検索操作のために、NetSuiteエンドポイントの作成中に単純型および複合型のカスタム・フィールドを公開できます。

このユースケースでは、次の統合の設計プロセスの概要を示します:

「図netsuite_adv_compl_int.pngの説明」

スケジュール済統合を作成します。
Oracle NetSuiteアダプタ接続(この例では、NetSuiteAdvancedSearchという名前)を統合に追加します。
1. 操作ページで、選択したビジネス・オブジェクトおよび関連オブジェクトに対してSearchを選択します。 returnへの列も選択します。
  
  「図netsuite_search_ops.pngの説明」
2. 「構成の検索」ページで、「クリックしてレスポンス列を追加」リンクをクリックします。
3. 「フィールドの選択」リストをスクロールして検索するカスタム・フィールドを選択し、OKをクリックして「構成の検索」ページに戻ります。カスタム・フィールドはアスタリスクで識別されます。
  
  「図netsuite_search_custom.pngの説明」
カスタム・フィールドの選択は、ページの下部に表示されます(この例では、PushToSalesforceという名前です)。

「図netsuite_search_conf.pngの説明」
この項の最初のユースケースと同様に、internalIdおよびscriptId要素に内部ID値を渡します。この例では、CustomerSearchAdvanced>customFieldList>customFieldの下にあります。
標準オブジェクトのターゲット・カスタム・フィールドを構成します(構成済フィールドはAによって識別されます)。この例では、CustomerSearchAdvanced>customFieldList>PushToSalesforceの下に1レベル上に表示されます。

「図netsuite_custfieldlist.pngの説明」
反復する繰返し要素としてPushToSalesforceカスタム行が選択されるfor-eachアクションを構成します。

「図netsuite_for_each.pngの説明」
必要に応じて、統合の残りの部分を構成します。この例では、ロガー・アクションが構成されます。

統合設計が完了しました。