NetSuite SOAP: 標準レコードおよびカスタムレコードを一括作成するアクション ​

NetSuiteのアクションCreate standard records in batchおよびCreate custom records in batchを使用すると、NetSuiteで複数のレコードをバッチで作成できます。 これらのアクションは、NetSuiteに正常にアップロードされたレコードのIDと、NetSuiteへのアップロードに失敗したデータのリストを返します。

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

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

制限事項 ​

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

入力 ​

作成する予定の標準レコードまたはカスタムレコードを選択します。

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

NetSuiteレコードを選択

フィールド設定 ​

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

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

NetSuiteフィールドを絞り込み

• フィールド

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

• カスタムフィールド

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

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

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

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

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

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

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

レコード ​

このセクションの名前は動的で、前のステップで選択した標準レコードまたはカスタムレコードに基づきます。 この例では、このセクションの名前は顧客です。 NetSuiteレコードを作成するためのデータマッピングは次のとおりです。

次の例では、Boxトリガーディレクトリ内の新規CSVファイルのデータをNetSuiteレコード顧客にマッピングします。 絞り込まれたフィールドCompany name、External ID、およびProduct interestのみが表示されていることに注目してください。

入力フィールドは次のとおりです:

• レコードソースリスト

• リストデータピルを指定します。

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

• レコードフィールド

• 直前のリストデータピル配下のデータピルをマッピングします。

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

出力 ​

• 処理済みレコード数

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

• 成功したレコード数

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

• 失敗したレコード数

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

• 成功したレコード

• すべての成功したレコードを含むリストデータピル。

  これを使用して、リスト内のすべてのレコードを反復処理します。

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

  • 内部ID

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

  • 外部ID

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

  • レコード

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

  • リストサイズ

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

• 失敗レコード

• 失敗したすべてのレコードを含むリストデータピル。

  これを使用して、リスト内のすべてのレコードを反復処理します。

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

  • エラー

  • このレコードのすべてのエラーを含むリストデータピル。

    これを使用して、リスト内のすべてのエラーを反復処理します。

  • レコード

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

  • リストサイズ

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