5.2.1.11.1. Bulk API ジョブの作成¶
Bulk APIを利用して、Salesforce上にジョブの作成を行うタスクです。
ユーザ定義タスク「Salesforceバッチ」を複数追加することが可能です。
複数のバッチをSalesforceに送信することにより、Salesforce側で大量レコードを処理できます。
コラム
Bulk APIについては、以下の Salesforceドキュメントを参照してください。
- Salesforce Bulk API 開発者ガイド (日本語)
- Bulk API Developer Guide (English)
5.2.1.11.1.1. プロパティ¶
項目名 | 必須/任意 | 型 | 初期値 | 説明 |
---|---|---|---|---|
ジョブの同時実行モード | 任意 | pulldown | PARALLEL | PARALLEL、または、SERIALを選択します。 |
エラーハンドリング | 任意 | flag | false | エラー発生時に処理を継続する場合は、チェックボックスをオンにします。 |
コラム
ジョブの同時実行モード(concurrencyMode)について
PARALLEL:Salesfroce上で、バッチを並列モードで処理します。デフォルト値です。
SERIAL:Salesfroce上で、バッチを逐次モードで処理します。
詳細は、「Salesforce Bulk API 開発者ガイド - JobInfo」 を参照してください。
5.2.1.11.1.2. 入力値¶
(タスク基本設定のエイリアス名) <object>
├─ clientId <string> *
├─ externalIdFieldName <string>
├─ object <string> *
├─ operation <string> *
├─ userCd <string> *
└─ version <string> *
項目名 | 必須/任意 | 型 | 配列/リスト | 説明 |
---|---|---|---|---|
(タスク基本設定のエイリアス名) | 任意 | object | なし | |
clientId | 必須 | string | なし | クライアントID(Salesforceクライアントの設定で一意に設定されたIDです。) |
externalIdFieldName | 任意 | string | なし | 外部ID項目名 |
object | 必須 | string | なし | オブジェクト名 |
operation | 必須 | string | なし | ジョブに含まれるバッチすべてに対する処理操作(insert, upsert, update, delete, hardDelete) |
userCd | 必須 | string | なし | ユーザコード (アクセストークン取得時に利用するintra-martのユーザコードです。) |
version | 必須 | string | なし | Salesforce APIバージョン |
5.2.1.11.1.3. 出力値¶
(タスク基本設定のエイリアス名) <object>
├─ apexProcessingTime <long>
├─ apiActiveProcessingTime <long>
├─ apiVersion <string>
├─ assignmentRuleId <string>
├─ concurrencyMode <string>
├─ contentType <string>
├─ createdById <string>
├─ createdDate <date>
├─ externalIdFieldName <string>
├─ id <string>
├─ numberBatchesCompleted <integer>
├─ numberBatchesFailed <integer>
├─ numberBatchesInProgress <integer>
├─ numberBatchesQueued <integer>
├─ numberBatchesTotal <integer>
├─ numberRecordsFailed <integer>
├─ numberRecordsProcessed <integer>
├─ numberRetries <integer>
├─ object <string>
├─ operation <string>
├─ state <string>
├─ systemModstamp <date>
└─ totalProcessingTime <long>
項目名 | 型 | 配列/リスト | 説明 |
---|---|---|---|
(タスク基本設定のエイリアス名) | object | なし | JobInfoと同等の型 |
apexProcessingTime | long | なし | ジョブデータに関連するトリガ、および、他のプロセスの処理時間(ミリ秒) |
apiActiveProcessingTime | long | なし | 有効なジョブの処理時間(ミリ秒) |
apiVersion | string | なし | ジョブが作成された時点で URI に設定されるジョブの Salesforce APIバージョン |
assignmentRuleId | string | なし | ケース、または、リードに対して実行される特定の割り当てルールID |
concurrencyMode | string | なし | ジョブの同時実行モード(Parallel, Serial) |
contentType | string | なし | ジョブのコンテンツタイプ(JSONのみ対応) |
createdById | string | なし | ジョブを作成したSalesforceユーザID |
createdDate | date | なし | ジョブの作成日時(UTCタイムゾーン形式) |
externalIdFieldName | string | なし | 作成・更新に使用される外部ID項目の名前 |
id | string | なし | ジョブID |
numberBatchesCompleted | integer | なし | このジョブの完了したバッチ数 |
numberBatchesFailed | integer | なし | このジョブの失敗したバッチ数 |
numberBatchesInProgress | integer | なし | このジョブの処理中のバッチ数 |
numberBatchesQueued | integer | なし | このジョブのキューにあるバッチ数 |
numberBatchesTotal | integer | なし | ジョブに現在含まれているバッチの数の合計 |
numberRecordsFailed | integer | なし | このジョブで正常に処理されなかったレコードの数 |
numberRecordsProcessed | integer | なし | すでに処理済みのレコード数。この数値は、処理されたバッチ数が増えると大きくなります。 |
numberRetries | integer | なし | Salesforceが処理結果の保存を試行した回数。
再試行の繰り返しはロックの競合などの問題によって発生します。
|
object | string | なし | 処理中のデータのオブジェクト種別 |
operation | string | なし | ジョブに含まれるバッチすべてに対する処理操作
(insert, upsert, update, delete, hardDelete)
|
state | string | なし | ジョブの現在の処理状態
(Open, Closed, Aborted, Failed)
|
systemModstamp | date | なし | ジョブが完了した日時(UTCタイムゾーン形式) |
totalProcessingTime | long | なし | ジョブの処理時間(ミリ秒) |
コラム
Salesforceジョブの返却値の詳細は、以下を参照してください。