Salesforce - CSVファイルからレコードを一括更新アクション
このアクションは、Salesforce Bulk APIを使用してCSVファイルからSalesforceレコードを一括更新します。
ポーリング動作
非同期ポーリングが想定どおりに機能するには、このアクションを含むレシピが実行中の状態である必要があります。
バルク操作の詳細については、Salesforceバルク操作ガイドを参照してください。
APIバージョン
このアクションは、API v1.0とAPI v2.0の両方のバージョンに存在します。 Workatoでは、最適なパフォーマンスを得るためにBulk API v2.0の使用をお勧めします。 このバージョンでは、レコードをより効率的にバッチ処理することで、Salesforce API制限への影響を軽減します。
失敗したレコードの再試行
失敗したレコードを新しい一括ジョブとしてSalesforceに再送信するには、CSVファイルから失敗したレコードの一括ジョブを再試行アクションを使用できます。
入力
| 入力項目 | 説明 |
|---|---|
| 更新するSalesforceオブジェクト | 更新する標準またはカスタムオブジェクトタイプを選択します。 |
| リレーション項目 | 任意です。 CSVデータ列をSalesforceオブジェクト項目にマッピングする方法を選択します。 ポリモーフィック列にはリレーション項目が必要です。 この入力の詳細についてはリレーション項目セクションを、ポリモーフィック項目の詳細についてはSalesforce APIドキュメントを参照してください。 |
| CSVファイル入力 | Salesforceバルクロードデータを含むCSVファイルのスキーマを定義します。 例については、CSVファイルセクションを参照してください。 |
| ファイル内容（CSVファイル入力） | ファイルの内容を入力します。 Download fileアクションからファイルデータピルを取得できます。 |
| 列区切り文字（CSVファイル入力） | 使用する列区切り文字をドロップダウンメニューから選択します。 たとえば、カンマ（,）またはパイプ（|）です。 |
| ヘッダー行を含むか？ （CSVファイル入力） | CSVファイルの内容にヘッダー行が含まれるかどうかを選択します。 これにより、Workatoは最初の行をデータとして処理しないようにスキップするかどうかを判断します。 |
| 列名（CSVファイル入力） | CSVファイルのデータ列に関する情報を入力します。 入力した列は、CSVからSalesforceオブジェクトフィールドへのマッピングセクションで使用できるようになります。 |
| CSV列名をSalesforceフィールド名として使用（CSVファイル入力） | CSV列をSalesforceオブジェクトフィールドに自動的にマッピングするかどうかを選択します。 これには、CSVファイルにオブジェクトフィールドと一致する列名を持つヘッダー行が含まれている必要があります。 |
| CSVからSalesforceオブジェクトフィールドへのマッピング | CSV列名と、一括更新するSalesforceオブジェクトを入力します。 |
| 詳細設定 | アクションの詳細設定を構成します。 |
| SalesforceがすべてのCSV行を処理するまで待機しますか？ （詳細設定） | アクションを同期的に実行するかどうかを選択します。 次のアクションを開始する前に、SalesforceがCSVファイルのすべての行を処理するまで待機するには、Yesを選択します。 CSVファイルがSalesforceにアップロードされた後に次のアクションを開始するには、Noを選択します。 バルク操作はデフォルトで非同期です。 |
| SalesforceバルクジョブごとのCSVチャンクサイズ（MB単位）（詳細設定） | 各SalesforceバルクジョブのCSVチャンクサイズをメガバイト単位で入力します。 CSVファイルがチャンクサイズより大きい場合、アクションは複数のSalesforceバルクジョブを自動的に作成します。 このフィールドのデフォルトは100 MBです。 |
| ヘッダー行なしで成功レポートを返す（詳細設定） | 返される成功レポートからヘッダー行を除外するかどうかを選択します。 |
| ヘッダー行なしで失敗行レポートを返す（詳細設定） | 返される失敗行レポートからヘッダー行を除外するかどうかを選択します。 |
リレーション項目
Salesforceでは、リレーションおよびリレーション項目を使用して、2つのオブジェクト間のデータを関連付けます。 たとえば、AccountオブジェクトとContactオブジェクトには、各取引先責任者が1つの取引先への参照を保存し、各取引先が多くの取引先責任者にリンクできるリレーションがあります。 アカウントに関連付けられているすべての取引先責任者を、アカウントレコードから直接表示できます。 一部のオブジェクトには、同じタイプの他のオブジェクトとのリレーションがあります。 たとえば、取引先責任者のReports To項目は、別の取引先責任者への参照です。
リレーション項目では、ポリモーフィックな列マッピングも可能です。 Workatoはこのマッピングを自動的に推測できないため、手動で指定する必要があります。 リレーション項目入力を設定しない場合、Salesforceにデータはマッピングされません。
この項目を設定するには、Salesforceに書き込む予定の各項目について、CSVファイルのどの列からデータを取得するかを選択します。 このアクションでは、CSVファイルデータをSalesforceに直接ストリーミングするため、データピルまたはFormulaモードを使用したデータ変換は許可されません。 オブジェクトリレーションの詳細については、Salesforceオブジェクトリレーションガイドを参照してください。また、CSVヘッダー内のリレーション項目については、SalesforceのCSV項目ヘッダードキュメントを参照してください。
Salesforce一括アップサートアクション - 項目マッピングセクション
CSVファイル
次の例は、CSVのCSVファイル入力の形式を示しています:
external_id,last_name,value
"a0K1h000003fXSS","Minnes","54"
"a0K1h000003fehx","Lecompte","12"
"a0K1h000003fjnv","Fester","28"
Salesforce一括アクションの設定済みCSVファイル入力セクション
出力
| 出力フィールド | 説明 |
|---|---|
| すべてのレコードは正常に処理されましたか | Salesforceバルクジョブ全体ですべてのCSV行が正常に処理されたかどうかを示します。 |
| 成功したレコード数 | Salesforceで正常に処理されたCSV行の合計数。 |
| 処理失敗レコード数 | Salesforceで問題が発生し、処理されなかったCSV行の合計数。 |
| 再試行されたレコード数 | Salesforceで処理が再試行されたCSV行の合計数。 このフィールドは、CSVファイルからSalesforceでオブジェクトのバルクジョブを再試行アクションに関連します。 |
| 処理済みレコード数 | ヘッダー行を除く、Salesforceで処理されたCSV行の合計数。 |
| 失敗したレコードを含むCSVコンテンツ | 問題が発生し、処理されなかったCSV行を含むCSVファイルコンテンツ。 このCSVファイルには、sf__Errorとsf__Idの2つの列が追加されます。 詳細についてはSalesforceドキュメントを参照してください。 |
| 成功したレコードを含むCSVコンテンツ | Salesforceで正常に処理されたCSV行を含むCSVファイルコンテンツ。 このCSVファイルには、sf__Createdとsf__Idの2つの列が追加されます。 詳細についてはSalesforceドキュメントを参照してください。 |
| 失敗したレコードのレポートヘッダー | 失敗したレコードレポートのヘッダー情報。 |
| 成功したレコードのレポートヘッダー | 成功したレコードレポートのヘッダー情報。 |
| Salesforce一括ジョブ | 各Salesforce一括ジョブに関する情報を含むオブジェクト。 詳細についてはSalesforce一括ジョブセクションを参照してください。 |
Salesforceバルクジョブ
Workatoは、大きなCSVファイルをチャンクに分割し、Salesforce APIのサイズ制限に準拠するために、それらを個別のSalesforceバルクジョブとして処理します。 バルク操作は、処理された各チャンクに関する情報を含むSalesforce bulk jobsデータツリーを出力します。
Salesforce一括操作の出力データツリー - バルクジョブのリスト
Workatoは、すべてのバルクジョブの集計結果を、出力の最上部にあるSalesforce bulk jobsデータツリーの外側に含めます。
Salesforce一括操作の出力データツリー - バルクジョブ全体の集計結果
Last updated: