この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

マルチパート要求を使用する一括挿入のウォークスルー

このウォークスルーでは、新規レコードの挿入、ジョブ用のバッチの作成、状況の確認、結果の取得を行うジョブを作成する手順をガイドします。また、1 つのマルチパート要求を使用してジョブを作成し、データをアップロードします。

このウォークスルーのすべての手順を一読してください。このドキュメントの残りを確認して、Bulk API 2.0 コールの概要と概念を把握しておくこともお勧めします。
ワークベンチに習熟します。このウォークスルーではワークベンチを使用して Bulk API 2.0 コールを発行しますが、REST 要求を実行できる任意のツールや開発環境を使用することもできます。

データを含む CSV ファイルを作成します。

任意のスプレッドシートツールを使用して、挿入するレコードを含む CSV ファイルを作成します。CSV ファイルの最初の行には、処理するオブジェクトの項目名をリストします。それ以降の行は、挿入するレコードに対応します。

CSV ファイルの作成に使用可能な Contact の非常に簡単なリスト例は、「Bulk API Sample Contact Data」 (Bulk API サンプル Contact データ) を参照してください。

使用可能な区切り文字や有効な日時形式など、CSV ファイルの準備に関する詳細は、「データファイル」を参照してください。

このウォークスルーでは、マルチパート要求を使用してジョブを作成し、データをアップロードするため、CSV データの合計サイズは 100,000 文字以下にする必要があります。
ジョブを作成します。

レコードの挿入や更新など、Bulk API 2.0 タスクを実行するには、最初にジョブを作成します。ジョブでは、読み込むオブジェクトの種別 (Contact など) を指定します。また、実行する操作 (挿入や削除など) も指定します。このウォークスルーでは、ジョブを作成する要求にジョブデータも含めます。

ジョブを作成したら、そのジョブの ID を Bulk API 2.0 要求で使用してジョブを終了または中止 (キャンセル) できます。
1. ワークベンチで、組織にログインします。
2. [Utilities (ユーティリティ)] | [REST Explorer] に移動します。Bulk API 2.0 を使用し、次の詳細を指定した POST 要求を発行して新規ジョブを作成し、データをアップロードします。
  要求ヘッダー:
  URI:
  リクエストボディ:
  
  この例では、「BOUNDARY」を使用して、リクエストボディでのジョブ詳細とジョブの CSV データ間の境界を示します。
  
  ワークベンチを使用している場合は、lineEnding を CRLF に設定します。別のツールを使用している場合は、データファイルの行末に一致するように設定します。
  
  ジョブの状況が UploadComplete のジョブ ID を含む応答が返されます。このジョブ ID は、次のステップの Bulk API 2.0 コールで使用します。
ジョブの状況と結果を確認します。

全体的なジョブの状況や処理されたレコード数など、ジョブに関する基本的な状況情報を取得するには、次の詳細を指定した GET 要求を使用します。
要求ヘッダー:
URI:

ジョブが完了して、状況が JobComplete (または Failed) になったら、次の詳細を指定して GET 要求を発行し、正常に処理されたジョブデータレコードの詳細を取得できます。
要求ヘッダー:

CSV データを含む応答が返されます。各行にはレコード ID とレコードが正常に処理されたかどうかに関する情報が含まれます。処理中にエラーが発生したレコードの詳細を取得するには、successfulResults リソースではなく failedResults リソースを指定した GET 要求を使用します。

Bulk API 2.0

マルチパート要求を使用する一括挿入のウォークスルー