チェーンの一部として Salesforce® 内のデータとやり取りするには、Salesforce 接続コマンドを持つステップを追加します。例：
- SOQLおよびバルク操作によるデータのロード、抽出、削除
- Salesforceオブジェクトの作成と管理
- レコードの更新と作成
これらのコマンドを有効にするには、IT 管理者がまずSalesforce コネクタ を作成します。このコネクタは、Salesforce Sales Cloudのすべてのバージョン（Salesforce Essentials®、Lightning® Professional、Lightning Enterprise、Lightning Unlimited）とREST APIを介して相互作用します。
一括削除
カンマ区切り値（CSV）ファイルに基づいて大量のレコードを削除するには、Bulk delete コマンドを使用します。
注： レコードの削除に失敗した場合、コマンドは失敗したレコードの行番号と失敗した理由をリストした CSV を返します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブにロードすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時に処理するか、順次処理するかを選択します。
- レコードを同時に処理するには、パラレルを選択する。
- レコードを順次処理するには、シリアルを選択する。
注: 非常に大規模なジョブの場合、データベース接続の量が多いとパラレルモードではジョブが失敗する可能性があるため、シリアルを選択してください。しかし、シリアル・モードでは処理時間が大幅に長くなる可能性がある。 |
| オブジェクト名 |
操作を実行するオブジェクトのタイプを入力します。 |
| 入力ファイル |
削除するレコードを含むファイルを入力します。 |
| ファイル形式 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとに処理するレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待つ |
Salesforce をポーリングし、すべてのレコードが処理されたときにのみ次のコマンドに移行するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップに移るには、このボックスのチェックを外す。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
バルクインサート
CSVファイルに基づいて大量のレコードを挿入するには、Bulk insert コマンドを使用します。
注： レコードの挿入に失敗した場合、コマンドは失敗したレコードの行番号と失敗の理由をリストした CSV を返します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブにロードすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時に処理するか、順次処理するかを選択します。
- レコードを同時に処理するには、パラレルを選択する。
- レコードを順次処理するには、シリアルを選択する。
注: 非常に大規模なジョブの場合、データベース接続の量が多いとパラレルモードではジョブが失敗する可能性があるため、シリアルを選択してください。しかし、シリアル・モードでは処理時間が大幅に長くなる可能性がある。 |
| オブジェクト名 |
操作を実行するオブジェクトのタイプを入力します。 |
| 入力ファイル |
挿入するレコードを含むファイルを入力します。 |
| ファイル形式 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとに処理するレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待つ |
Salesforce をポーリングし、すべてのレコードが処理された場合にのみ次のコマンドに移行するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップに移るには、このボックスのチェックを外す。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括クエリー
大量のレコードを照会するには、Bulk query コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時に処理するか、順次処理するかを選択します。
- レコードを同時に処理するには、パラレルを選択する。
- レコードを順次処理するには、シリアルを選択する。
注: 非常に大規模なジョブの場合、データベース接続の量が多いとパラレルモードではジョブが失敗する可能性があるため、シリアルを選択してください。しかし、シリアル・モードでは処理時間が大幅に長くなる可能性がある。 |
| オブジェクト名 |
操作を実行するオブジェクトのタイプを入力します。 |
| SOQLクエリ |
実行するSOQLクエリーを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括更新
大量のレコードを更新するには、Bulk update コマンドを使用する。
注： レコードの更新に失敗した場合、コマンドは失敗したレコードの行番号と失敗の理由を CSV で返します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブにロードすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時に処理するか、順次処理するかを選択します。
- レコードを同時に処理するには、パラレルを選択する。
- レコードを順次処理するには、シリアルを選択する。
注: 非常に大規模なジョブの場合、データベース接続の量が多いとパラレルモードではジョブが失敗する可能性があるため、シリアルを選択してください。しかし、シリアル・モードでは処理時間が大幅に長くなる可能性がある。 |
| オブジェクト名 |
操作を実行するオブジェクトのタイプを入力します。 |
| 入力ファイル |
更新するレコードを含むファイルを入力します。 |
| ファイル形式 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとに処理するレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待つ |
Salesforce をポーリングし、すべてのレコードが処理された場合にのみ次のコマンドに移行するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップに移るには、このボックスのチェックを外す。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括アップサート
大量のレコードに対してアップサートを実行し、既存のレコードを更新するか、外部IDに基づいて新しいレコードを作成するには、Bulk upsert コマンドを使用します。
注： レコードのアップサートに失敗した場合、コマンドは失敗したレコードの行番号と失敗の理由をリストした CSV を返します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブにロードすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時に処理するか、順次処理するかを選択します。
- レコードを同時に処理するには、パラレルを選択する。
- レコードを順次処理するには、シリアルを選択する。
注： 非常に大規模なジョブの場合、データベース接続の量が多いとパラレルモードではジョブが失敗する可能性があるため、シリアルを選択してください。しかし、シリアル・モードでは処理時間が大幅に長くなる可能性がある。 |
| オブジェクト名 |
操作を実行するオブジェクトのタイプを入力します。 |
| 入力ファイル |
アップサートするレコードを含むファイルを入力します。 |
| ファイル形式 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとに処理するレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待つ |
Salesforce をポーリングし、すべてのレコードが処理されたときにのみ次のコマンドに移行するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップに移るには、このボックスのチェックを外す。 |
| 外部ID |
レコードがすでに存在するのか、作成する必要があるのかを識別するには、アップサートに関係するオブジェクトに必要な外部 ID フィールドを入力します。 |
出力
| 出力 |
出力タイプ |
| 一括アップサートエラーログ |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レコードの作成
Salesforce で新しいレコードを作成するには、Create record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
レコードを作成するSObjectの名前を入力してください。 |
| フィールド |
FIELD_NAME:VALUE の形式で、更新するレコード・フィールドを入力する。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レコードの削除
Salesforce で ID に基づいてレコードを削除するには、Delete record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 身分証明書 |
削除するレコードのIDを入力してください。IDが不明な場合は、EXTERNAL_ID_NAME:VALUE の形式で外部IDを入力する。例えば、Name:John 。 |
| 名称 |
レコードを削除するオブジェクトの名前を入力してください。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レポートダウンロード
カスタム レポートをカンマ区切り値（CSV）ファイルとしてダウンロードするには、Download report コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| レポートID |
ダウンロードするカスタムレポートのIDを入力します。 |
出力
| 出力 |
出力タイプ |
| カスタムレポートCSV |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
オブジェクトのメタデータを取得する
Salesforce オブジェクトに関連付けられているフィールドとメタデータを取得するには、Get object metadata コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 対象 |
メタデータを取得するオブジェクトの名前を入力します。 |
出力
| 出力 |
出力タイプ |
| オブジェクトのメタデータ |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
記録取得
ID に基づいて Salesforce からレコードを取得するには、Get record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 身分証明書 |
検索するレコードのIDを入力してください。 |
| 名称 |
レコードを取得するSObjectの名前を入力してください。 |
| フィールド |
含めるレポートのフィールドを入力します（オプション）。 |
出力
| 出力 |
出力タイプ |
| レコードJSONの取得 |
JSON |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
ログイン一覧
Salesforce 環境のログインを一覧表示するには、List logins コマンドを使用します。
プロパティ
なし
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
リストオブジェクト
Salesforce から SObjects をリストするには、List objects コマンドを使用します。
プロパティ
なし
出力
| 出力 |
出力タイプ |
| リストオブジェクト CSV |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レポート一覧
Salesforce からレポートを一覧表示するには、List reports コマンドを使用します。
プロパティ
なし
出力
| 出力 |
出力タイプ |
| リスト・レポート CSV |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SOQLクエリ
SOQLクエリーを実行し、その結果をCSVファイルとして生成するには、SOQLクエリー コマンドを使用します。
注： SOQL構文 はSQLに非常に似ている。SOQL Query コマンドは、大量のデータを抽出し、一度に100万レコード以上のデータセットを返すことができる。クエリが正しくないか、存在しないオブジェクトを参照しているためにコマンドが失敗した場合は、コマンドの出力で通知されます。
プロパティ
| プロパティ |
詳細 |
| クエリ |
実行するSOQLクエリーを入力します。 |
| クエリーコマンド |
削除されたレコードを含めるかどうかを選択します。
- 削除されたレコードを除外するには、［クエリ］を選択します。
- 削除されたレコードを含めるには、QueryAll を選択します。
|
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SObject - create
Salesforce で新しい SObject を作成するには、SOjbect- create コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
新しいSObjectの名前を入力します。これがカスタムオブジェクトであることを示すために、Salesforce は自動的に__c を追加します。 |
| フィールド |
FIELD_NAME:TYPE の形式で、作成するレコードフィールドを入力します。TYPE は Salesforce のフィールドタイプに対応しています。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SObject - 削除
Salesforce で SObject を削除するには、SObject - delete コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
作成するSObjectsの名前を入力します。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
更新記録
Salesforce のレコードのフィールド値を更新するには、Update record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 身分証明書 |
更新するレコードのIDを入力してください。 |
| 名称 |
レコードを更新するSObjectの名前を入力してください。 |
| フィールド |
FIELD_NAME:VALUE の形式で、更新するレコード・フィールドを入力する。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |