NetSuite SOAP - レコードの一括更新アクション ​

アクション標準レコードを一括更新およびカスタムレコードを一括更新では、標準レコードまたはカスタムレコードをバッチで更新できます。 これらのアクションは、NetSuiteに正常にアップロードされたレコードのIDと、NetSuiteへのアップロードに失敗したデータのリストを返します。

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

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

制限事項 ​

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

入力 ​

更新予定のStandard recordまたはCustom recordを選択します。

この例では、標準レコードを更新し、Customerを選択します。

NetSuiteレコードを選択

フィールド設定 ​

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

この例では、Company nameフィールドとInternal IDフィールドを使用しました。

NetSuiteフィールドを候補リストに追加

• フィールド

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

• カスタムフィールド

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

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

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

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

• 候補リストに追加するNetSuiteレコードのラインアイテムカスタムフィールド。 フィールドが選択されていない場合、Workatoはデフォルトで50件のカスタムフィールドを取得します。

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

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

レコード ​

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

NetSuiteが更新するレコードを認識できるように、レコードのInternal IDをマッピングする必要があります。

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

• レコードソースリスト

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

• 内部ID

• NetSuiteレコードのID。 NetSuiteはこれを使用して、更新するレコードを判断します。

• レコードフィールド

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

出力 ​

• 処理済みレコード数

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

• 成功したレコード数

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

• 失敗したレコード数

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