NetSuite SOAP - レコードを一括でアップサートするアクション ​

アクションUpsert standard records in bulkおよびUpsert custom records in bulkを使用すると、標準レコードまたはカスタムレコードを一括でアップサートできます。

制限事項 ​

これらのアクションには次の制限があります:

• リストサイズ: 最大200件のレコードのリストを受け入れます。 200件を超えるレコードを指定すると、アクションは失敗します。
• 処理時間: NetSuiteの一括アクションはNetSuite上の単一キューで処理されるため、処理遅延が発生する可能性があります。 これらのアクションは非同期であるため、Workatoはジョブステータスの更新をポーリングする必要があります。 その結果、処理時間はNetSuiteシステムの負荷と可用性に応じて変動する可能性があります。

入力 ​

Standard recordまたはCustom recordを選択して、アップサートする対象を指定します。 この例では、Customerを選択します:

その後、次のセクションの設定に進むことができます。

フィールド設定 ​

このセクションでは、使用するNetSuiteフィールドを絞り込むことができます。 絞り込んだフィールドのみが、アクションの入力と出力に表示されます。 これにより、数百のフィールドを含む複雑なNetSuiteオブジェクトを扱いやすくなります。

この例では、CustomerレコードのフィールドFirst name、Last name、Email、およびphoneを使用します:

このセクションのすべての入力フィールドは次のとおりです:

• フィールド

• 絞り込むNetSuiteレコードのメインフィールド。

• カスタムフィールド

• 絞り込むNetSuiteレコードのカスタムフィールド。

• カスタムセグメントスキーマ

• NetSuiteレコードにカスタムスキーマがある場合、ここでカスタムスキーマを定義できます。

• ラインアイテムカスタムフィールド

• 候補リストに追加するNetSuiteレコードのラインアイテムカスタムフィールド。

• ラインアイテムカスタムセグメントスキーマ

• NetSuiteラインアイテムにカスタムスキーマがある場合は、ここでカスタムスキーマを定義できます。

レコード ​

このセクション名は、選択したStandard recordまたはCustom recordに基づいて変わります。 このセクションでは、NetSuiteレコードをアップサートするためのデータマッピングを指定します。

次の例では、BoxトリガーNew CSV file in directoryのデータをNetSuiteレコードCustomerにマッピングします。 ここには、絞り込んだフィールドFirst name、Last name、Email、およびphoneのみが表示されます。

また、NetSuiteがアップサートするレコードを識別できるように、レコードのExternal IDをマッピングする必要があります。 この場合、BoxからのCSVレコードにはEmp IDが含まれており、これはNetSuiteのExternal IDにマッピングされます。 このマッピングに基づいて、指定された外部IDが存在する場合、NetSuiteはそのレコードを更新し、指定された外部IDが存在しない場合は新しいレコードを作成します。

このセクションのすべての入力フィールドは次のとおりです:

• レコードソースリスト

• ここでリストデータピルを指定する必要があります。

  たとえば、CSVファイル内の行のリストです。 アクションはリスト内のすべての項目を自動的に反復処理し、それらをNetSuiteレコードにマッピングします。

• 外部ID

• NetSuiteレコードには、別のシステムの対応するレコードID（たとえば、SalesforceレコードID）を参照する外部IDを設定できます。

  別のシステムからデータをインポートする際、NetSuiteはこれを使用して、アップサートするレコードを判断します。

• レコードフィールド

• ここでは、前に指定したリストデータピルの下にあるデータピルをマッピングする必要があります。 たとえば、CSV行リストデータピルの下にあるCSV列名です。 アクションはリスト内のすべての項目を自動的に反復処理し、それらをNetSuiteレコードにマッピングします。

出力 ​

• 処理済みレコード数

• 処理されたレコードの合計数。

• 成功したレコード数

• 正常にアップサートされたレコード数。

• 失敗したレコード数

• アップサートに失敗したレコード数。

• 成功したレコード

• すべての成功したレコードを含むリストデータピル。 これを使用して、リスト内のすべてのレコードを反復処理できます。

  各レコードのデータフィールドは次のとおりです:

  • 内部ID

  • このレコードの内部ID。

  • 外部ID

  • このレコードの外部ID。

  • レコード

  • このレコードのすべてのデータフィールドを含みます。

  • リストサイズ

  • このリスト内の成功したレコード数。

• 失敗レコード

• 失敗したすべてのレコードを含むリストデータピル。 これを使用して、リスト内のすべてのレコードを反復処理します。

  各レコードのデータフィールドは次のとおりです:

  • エラー

  • このレコードのすべてのエラーを含むリストデータピル。 これを使用して、リスト内のすべてのエラーを反復処理します。

  • レコード

  • このレコードのすべてのデータフィールドを含みます。

  • リストサイズ

  • このリスト内の失敗したレコード数。