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

標準レコードをバッチでアップサートアクションとカスタムレコードを一括でアップサートアクションを使用すると、標準レコードまたはカスタムレコードをバッチでアップサートできます。

これらのアクションは同期型です。つまり、Workatoはカスタムレコードまたは標準レコードをアップサートするリクエストをNetSuiteに送信し、NetSuiteで処理が完了するのを待ってから、他のレシピアクションを開始します。 これは、非同期API呼び出しである一括アクションとは対照的です。つまり、WorkatoはNetSuiteを呼び出した後、ジョブステータスをポーリングする必要があり、遅延やジョブ時間の長期化を引き起こす可能性があります。

同期型アクションは、取り込み時間が重要な大量データロード時に特に役立ちます。

制限事項 ​

Workatoでは各アクションの処理時間を180秒に制限していますが、場合によっては、大量のレコードのバッチを含む同期型API呼び出しをNetSuiteで処理するのに、はるかに長い時間がかかることがあります。 これにより、Workatoでタイムアウトエラーが発生する可能性があります。 これを防ぐため、この特定のレコードのバッチサイズを小さくし、制限時間内に最適な処理が行われるようにすることをおすすめします。

入力 ​

アップサートする予定の標準レコードまたはカスタムレコードを選択します。

この例では、標準レコードを更新するため、顧客を選択しています。

NetSuiteレコードを選択

フィールド設定 ​

使用する予定のNetSuiteフィールドを絞り込むには、次の入力フィールドを設定します。 絞り込まれたフィールドのみがアクションの入力と出力に表示されます。 これにより、NetSuite APIリクエストが最適化され、数百のフィールドを含む複雑なNetSuiteオブジェクトの操作が簡単になります。

この例では、会社名、外部ID、カスタムフィールド製品への関心を使用しました。

NetSuiteフィールドを絞り込み

• フィールド

• 絞り込む予定のNetSuiteレコードのメインフィールド。 空白のままにすると、すべてのフィールドが入力と出力のデータツリーに表示されます。

• カスタムフィールド

• 絞り込む予定のNetSuiteレコードのカスタムフィールド。 フィールドが選択されていない場合、Workatoはデフォルトで50件のカスタムフィールドを取得します。

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

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

レコード ​

このセクションの名前は動的で、前のステップで選択した標準レコードまたはカスタムレコードに基づきます。 この例では、このセクションの名前は顧客です。

レコードの外部IDをマッピングします。 このマッピングに基づいて、指定された外部IDが存在する場合、NetSuiteはそのレコードを更新し、指定された外部IDが存在しない場合は新しいレコードを作成します。

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

• レコードソースリスト

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

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

• 外部ID

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

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

• レコードフィールド

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

出力 ​

• 処理済みレコード数

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

• 成功したレコード数

• 正常に作成されたレコード数。

• 失敗したレコード数

• 作成に失敗したレコード数。