Salesforce - CSVファイルからレコードを一括アップサートするアクション ​

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

バルク操作の詳細については、Salesforceバルク操作ガイドを参照してください。

入力 ​

主キー ​

このアクションでは、各Salesforceレコードを一意に識別するために主キーを指定する必要があります。 Salesforce Bulk APIは、主キーとしてExternal IDフィールドと、内部Record IDなどのインデックス付きフィールドの両方をサポートしています。

External IDフィールドは、External ID属性を持つカスタムフィールドです。 Salesforce外部のシステムから取得した一意のレコード識別子が含まれています。 外部IDフィールドは、カスタムのテキスト、数値、またはメールフィールドである必要があります。

ドロップダウンメニューを使用して主キーフィールドを主キーを入力に切り替え、主キーとして使用するインデックス付きフィールドのAPI名を入力します。

外部IDおよびその他のインデックス付きフィールドを使用する場合のアクションの動作は、次のように異なります：

複数のSalesforceレコードが指定された主キーと一致する場合、このアクションはエラーをスローします。

リレーション項目 ​

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バルクジョブ ​

Workatoは、大きなCSVファイルをチャンクに分割し、Salesforce APIのサイズ制限に準拠するために、それらを個別のSalesforceバルクジョブとして処理します。 バルク操作は、処理された各チャンクに関する情報を含むSalesforce bulk jobsデータツリーを出力します。

Salesforce一括操作の出力データツリー - バルクジョブのリスト

Workatoは、すべてのバルクジョブの集計結果を、出力の最上部にあるSalesforce bulk jobsデータツリーの外側に含めます。

Salesforce一括操作の出力データツリー - バルクジョブ全体の集計結果