CreateBatch
レコードのバルク処理のためにSalesforce でバッチジョブを作成します。
テーブル固有の情報
バッチを作成するには、バッチの追加先のジョブID と、バッチ自体のXML 集計を指定します。例えば、XML 集計は次のようになります。
<?xml version="1.0" encoding="UTF-8"?>
<sObjects xmlns="http://www.force.com/2009/06/asyncapi/dataload" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sObject>
<FirstName>Bill</FirstName>
<LastName>White</LastName>
</sObject>
<sObject>
<FirstName>Bob</FirstName>
<LastName>Black</LastName>
</sObject>
</sObjects>
Note:XML 集計に含まれるオブジェクトはすべて、使用されているジョブに関連付けられたオブジェクトに対応している必要があります。
Input
| Name | Type | Description |
| JobId | String | バッチが追加されるSalesforce Bulk API ジョブのID。これは有効で開いているジョブである必要があります。 |
| Aggregate | String | バッチのデータペイロードまたはSOQL クエリ。レコードを送信またはバッチクエリを実行する際に必須です。 |
| ContentType | String | バッチコンテンツのフォーマット。有効な値はCSV、XML、ZIP_CSV、ZIP_XML です。バッチクエリの場合はCSV を使用します。
The default value is XML. |
Result Set Columns
| Name | Type | Description |
| ID | String | ジョブ内で作成されたバッチの一意ID。 |
| JobID | String | バッチが関連付けられているジョブのID。作成後のリンクを確認します。 |
| ApexProcessingTime | String | バッチ処理中にApex トリガーと自動化の実行に費やした総時間(ミリ秒)。非同期Apex を除き、API バージョン19.0 以降で利用可能です。 |
| ApiActiveProcessingTime | String | Apex 時間を含むがキュー時間とシリアル化を除く、バッチのアクティブな処理に費やした時間(ミリ秒)。API バージョン19.0 以降で利用可能です。 |
| CreatedDate | String | バッチが作成されたUTC タイムスタンプ。これは送信時間を反映し、処理開始時間ではありません。 |
| NumberRecordsFailed | String | バッチで正常に処理できなかったレコード数。 |
| NumberRecordsProcessed | String | このバッチで正常に処理されたレコード数。この値は処理が進むにつれて増加します。 |
| State | String | バッチの現在の処理状況。可能な値にはQueued、InProgress、Completed、Failed、NotProcessed が含まれます。 |
| StateMessage | String | バッチ状況に関する説明メッセージ。状況がFailed の場合に特に有用です。エラーの理由や診断情報を含む場合があります。 |
| SystemModstamp | String | バッチ処理が完了したUTC タイムスタンプ。バッチ状況がCompleted の場合のみ有効です。 |
| TotalProcessingTime | String | キュー待機時間を除く、バッチの総処理時間(ミリ秒)。API バージョン19.0 以降で利用可能です。 |