Salesforce一括操作 ​

Salesforce connectorは一括データ操作をサポートしており、大規模なデータセットをSalesforceに効率的に読み込むことができます。 Workatoは、CSVファイルからSalesforceへのデータ読み込みをサポートするために、Bulk API v1.0とBulk API v2.0の両方を使用します。

アクション ​

Salesforce connectorは次の一括アクションをサポートしています:

CSVファイルからのレコードの一括作成 ​

CSVファイルからのレコードの一括作成アクションは、CSVファイルからSalesforceレコードを一括作成します。

CSVファイルからのレコードの一括更新 ​

CSVファイルからのオブジェクトの一括更新アクションは、CSVファイルからSalesforceレコードを一括更新します。

CSVファイルからのレコードの一括アップサート ​

CSVファイルからのオブジェクトの一括アップサートアクションは、CSVファイルと主キーからSalesforceレコードを一括アップサートします。 一致するレコードが見つかった場合、それらは更新されます。 一致するレコードが見つからない場合、それらは作成されます。

CSVファイルからの失敗レコードに対する一括ジョブの再試行 ​

CSVファイルからの失敗レコードに対する一括ジョブの再試行アクションは、失敗したSalesforceジョブをCSVファイルから一括で再試行します。 別のSalesforce一括アクションの後にこのアクションを使用して、失敗したレコードを新しい一括ジョブとして再送信します。

SOQLクエリを使用したレコードの一括検索 ​

SOQLクエリを使用したレコードの一括検索アクションは、指定したSOQLクエリに一致するSalesforceレコードのCSVストリームを取得します。

トリガー ​

Salesforce connectorは次の一括トリガーをサポートしています:

新規/更新済みレコードのエクスポート ​

Export new/updated recordsトリガーは、指定したSOQL WHERE句に一致する新規作成または更新済みのレコードについてSalesforceを監視し、それらをCSV streamとして取得します。 このトリガーがジョブを作成する際には、想定される遅延があります。 ジョブは、Salesforceでクエリが完了した後に処理されます。

新規レコードのエクスポート ​

Export new recordsトリガーは、指定したSOQL WHERE句に一致する新規レコードについてSalesforceを監視し、それらをCSV streamとして取得します。 このトリガーがジョブを作成する際には、想定される遅延があります。 ジョブは、Salesforceでクエリが完了した後に処理されます。

大規模ファイルを処理し、効果的にスケールする ​

WorkatoのSalesforce connectorを使用すると、大規模なデータセットを管理し、効率的にスケールできます。 CSVファイルが1 GBを超えると、Salesforceはファイルを1 GBのchunkに分割します。 Workatoはこれらのchunkを1つのstreamにつなぎ合わせてレシピで処理できるようにし、追加の設定を必要とせずに継続的なデータフローを確保します。

1つのレシピを使用して、1 GB、5 GB、10 GBなど、サイズの異なるデータセットを変更なしで処理できます。 Workatoには事前設定済みのエラー処理、再試行、通知が用意されており、任意の規模で一括操作を管理できます。

スケーラビリティが組み込まれているため、データセットが増大しても一貫した処理と信頼性の高いエラー処理を維持できます。

すべてのSalesforce一括操作は、デフォルトで非同期です。 Workatoは、一括ジョブがSalesforceに送信されると、5分ごとに結果をpollingします。 このpolling間隔を期待どおりに機能させるには、一括アクションを含むレシピが停止状態やテストモードではなく、実行中の状態である必要があります。 レシピが停止中またはテストモードの間にジョブを再実行した場合、pollingはレシピが再びアクティブになるまでトリガーされません。 これにより、一括アクションが長時間処理中であるかのように表示されることがあります。

同期操作については、Salesforce connectorのバッチ操作ドキュメントを参照してください。このドキュメントでは、最大バッチサイズ2,000で、オブジェクトの作成、更新、upsertをバッチで行うことをサポートしています。 Advanced configurationセクションのWait for Salesforce to process all CSV rows?フィールドを使用して、一部の一括アクションを同期的に実行するように設定することもできます。

詳細設定 ​

一部の一括操作には、同期的に実行するかどうかなど、操作の動作を制御するAdvanced configurationセクションがあります。 使用可能な設定オプションについては、次の表を参照してください:

権限 ​

一括操作を正しく動作させるには、次のSalesforceユーザー権限が必要です:

• Manage Data Integrations
• View Setup and Configuration
• API Enabled

接続済みのSalesforceアカウントでこれらの権限を有効にするには、システム管理者権限が必要です。 詳細については、Salesforceドキュメントを参照してください。

サンプルレシピ ​

次のサンプルレシピは、CSVファイルがS3バケットに追加されるたびにSalesforceにアップロードし、失敗したアップロードを自動的に再試行します:

1. New CSV file S3トリガーは、CSVファイルがS3バケットにドロップされるたびに新しいジョブを作成します。 サンプルレシピ - CSVファイルによるSalesforce一括upsert。

2. Create records in bulk from CSV fileアクションは、CSVファイルのデータをSalesforceにstreamします。

サンプルレシピでは、次のCSVファイルを使用します:

external_id,billing_country,phone,account_number
"a0K1h000003fXSS","United States of America","123 456 789","54"
"a0K1h000003fehx","Canada","650 894 345","12"
"a0K1h000003fjnv","Japan","103 948 414","28"

設定済みのSalesforce一括upsertアクション

3. Ifステートメントは、All records successfully processed?がfalseかどうかを確認します。これは、一部のレコードがSalesforceでの処理に失敗したことを示します。

失敗したレコードがあるかどうかを確認するIf条件

4. Salesforceでレコードの処理に失敗した場合、Retry objects bulk job in Salesforce via CSV fileアクションは、失敗したCSV行をSalesforceに書き込もうとします。

レコードの処理は、次のようないくつかの理由で失敗することがあります:

• データエラー
• 別のプロセスまたはユーザーが編集したためにレコードがロックされた
• ネットワークの問題

設定済みの一括操作再試行アクション