intra-mart Accel Platform IM-LogicDesigner仕様書 第23版 2023-10-01

5.2.1.11.1. Bulk API ジョブの作成

Bulk APIを利用して、Salesforce上にジョブの作成を行うタスクです。
ユーザ定義タスク「Salesforceバッチ」を複数追加することが可能です。
複数のバッチをSalesforceに送信することにより、Salesforce側で大量レコードを処理できます。

コラム

Bulk APIについては、以下の Salesforceドキュメントを参照してください。

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ジョブの返却値の詳細は、以下を参照してください。