チェーンの一部として Salesforce® 内のデータを操作するには、Salesforce 接続コマンドを持つステップを追加します。例：
- SOQLおよび一括操作によるデータの読み込み、抽出、削除
- Salesforceオブジェクトの作成と管理
- 記録の更新と作成
これらのコマンドを有効にするには、IT 管理者がまずSalesforce コネクタ を作成します。このコネクターは、Salesforce Sales Cloudのすべてのバージョン（Salesforce Essentials®、Lightning® Professional、Lightning Enterprise、Lightning Unlimited）とREST APIを介して連携します。
一括削除
カンマ区切り値（CSV）ファイルに基づいて大量のレコードを削除するには、Bulk delete コマンドを使用します。
メモ： レコードの削除に失敗した場合、コマンドは失敗したレコードの行番号とその理由を CSV で返却します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブに読み込んだりすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時にプロセスするか、順次プロセスするかを選択します。
- レコードを同時にプロセスするには、パラレルを選択する。
- レコードを順次プロセスするには、シリアルを選択する。
メモ: 非常に大規模なジョブの場合、データベース接続の量が多いと Parallel モードでジョブが失敗する可能性があるため、Serial を選択します。しかし、シリアル・モードではプロセス時間が大幅に長くなる可能性がある。 |
| オブジェクト名称 |
操作を実行するSObjectのタイプを入力します。 |
| 入力ファイル |
削除するレコードを含むファイルを入力します。 |
| ファイル書式設定 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとにプロセスするレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待機中 |
Salesforce をポーリングし、すべてのレコードがプロセスされたときにのみ次のコマンドへ移動するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップへ移動するには、このボックスのチェックを外す。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
バルクインサート
CSVファイルに基づいて大量のレコードを挿入するには、Bulk insert コマンドを使用する。
メモ： レコードの挿入に失敗した場合、コマンドは失敗したレコードの行番号とその理由を CSV で返却します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブに読み込んだりすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時にプロセスするか、順次プロセスするかを選択します。
- レコードを同時にプロセスするには、パラレルを選択する。
- レコードを順次プロセスするには、シリアルを選択する。
メモ: 非常に大規模なジョブの場合、データベース接続の量が多いと Parallel モードでジョブが失敗する可能性があるため、Serial を選択します。しかし、シリアル・モードではプロセス時間が大幅に長くなる可能性がある。 |
| オブジェクト名称 |
操作を実行するSObjectのタイプを入力します。 |
| 入力ファイル |
挿入するレコードを含むファイルを入力します。 |
| ファイル書式設定 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとにプロセスするレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待機中 |
Salesforce をポーリングし、すべてのレコードがプロセスされたときにのみ次のコマンドへ移動するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップへ移動するには、このボックスのチェックを外す。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括クエリ
大量のレコードをクエリするには、Bulk query コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時にプロセスするか、順次プロセスするかを選択します。
- レコードを同時にプロセスするには、パラレルを選択する。
- レコードを順次プロセスするには、シリアルを選択する。
メモ: 非常に大規模なジョブの場合、データベース接続の量が多いと Parallel モードでジョブが失敗する可能性があるため、Serial を選択します。しかし、シリアル・モードではプロセス時間が大幅に長くなる可能性がある。 |
| オブジェクト名称 |
操作を実行するSObjectのタイプを入力します。 |
| SOQLクエリ |
実行するSOQLクエリを入力します。 |
出力
| 出力 |
出力タイプ |
| クエリ結果のCSV一括出力 |
ファイル |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括更新
大量のレコードを更新するには、Bulk update コマンドを使用する。
メモ： レコードの更新に失敗した場合、コマンドは失敗したレコードの行番号とその理由を CSV で返却します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブに読み込んだりすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時にプロセスするか、順次プロセスするかを選択します。
- レコードを同時にプロセスするには、パラレルを選択する。
- レコードを順次プロセスするには、シリアルを選択する。
メモ: 非常に大規模なジョブの場合、データベース接続の量が多いと Parallel モードでジョブが失敗する可能性があるため、Serial を選択します。しかし、シリアル・モードではプロセス時間が大幅に長くなる可能性がある。 |
| オブジェクト名称 |
操作を実行するSObjectのタイプを入力します。 |
| 入力ファイル |
更新するレコードを含むファイルを入力します。 |
| ファイル書式設定 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとにプロセスするレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待機中 |
Salesforce をポーリングし、すべてのレコードがプロセスされたときにのみ次のコマンドへ移動するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップへ移動するには、このボックスのチェックを外す。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
一括アップサート
大量のレコードに対してアップサートを実行し、既存のレコードを更新するか、外部IDに基づいて新規レコードを作成するには、Bulk upsert コマンドを使用する。
メモ： レコードのアップサートに失敗した場合、コマンドは失敗したレコードの行番号と失敗の理由を CSV で返却します。分岐を使用して、コマンドが失敗したときにアクションを実行したり、後で分析するために失敗をGoogle®ドライブに読み込んだりすることができます。
プロパティ
| プロパティ |
詳細 |
| 同時実行モード |
レコードを同時にプロセスするか、順次プロセスするかを選択します。
- レコードを同時にプロセスするには、パラレルを選択する。
- レコードを順次プロセスするには、シリアルを選択する。
メモ: 非常に大規模なジョブの場合、データベース接続の量が多いと Parallel モードでジョブが失敗する可能性があるため、Serial を選択します。しかし、シリアル・モードではプロセス時間が大幅に長くなる可能性がある。 |
| オブジェクト名称 |
操作を実行するSObjectのタイプを入力します。 |
| 入力ファイル |
アップサートするレコードを含むファイルを入力します。 |
| ファイル書式設定 |
入力ファイル が CSV、JSON、XML のいずれかを選択します。 |
| バッチサイズ |
バッチごとにプロセスするレコード数を入力します。デフォルトのままにしておくことをお勧めします。 |
| 完成を待機中 |
Salesforce をポーリングし、すべてのレコードがプロセスされたときにのみ次のコマンドへ移動するには、このボックスをオンにします。コマンドをトリガーしてすぐに次のステップへ移動するには、このボックスのチェックを外す。 |
| 外部ID |
レコードが既に存在するのか、作成する必要があるのかを識別するには、アップサートに関与するオブジェクトに必要な外部IDフィールドを入力します。 |
出力
| 出力 |
出力タイプ |
| 一括アップサートエラー記録 |
ファイル |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レコード作成
Salesforce で新規レコードを作成するには、Create record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
レコードを作成するSObjectの名称を入力する。 |
| フィールド |
FIELD_NAME:VALUE の書式設定で、更新するレコード・フィールドを入力する。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レコード削除
Salesforce で ID に基づいてレコードを削除するには、Delete record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ID |
削除するレコードのIDを入力します。IDが不明な場合は、EXTERNAL_ID_NAME:VALUE の書式設定で外部IDを入力する。例えば、Name:John 。 |
| 名称 |
レコードを削除するSObjectの名称を入力します。 |
出力
なし
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レポートダウンロード
カスタム・レポートをカンマ区切り値（CSV）ファイルとしてダウンロードするには、レポートをダウンロードコマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| レポートID |
ダウンロードするカスタムレポートのIDを入力します。 |
出力
| 出力 |
出力タイプ |
| カスタムレポート CSV |
ファイル |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
オブジェクトのメタデータを取得する
Salesforce オブジェクトに関連付けられているフィールドとメタデータを取得するには、Get object metadata コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| オブジェクト |
メタデータを取得するオブジェクトの名称を入力します。 |
出力
| 出力 |
出力タイプ |
| オブジェクトのメタデータ |
ファイル |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レコードを取得する
ID に基づいて Salesforce からレコードを取得するには、Get record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ID |
検索するレコードのIDを入力します。 |
| 名称 |
レコードを取得するSObjectの名称を入力します。 |
| フィールド |
含むレポートのフィールドを入力します（オプション）。 |
出力
| 出力 |
出力タイプ |
| レコードJSONの取得 |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
ログイン一覧
Salesforce 環境のログインを一覧表示するには、List logins コマンドを使用します。
プロパティ
なし
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
リストオブジェクト
Salesforce から SObjects をリストするには、List objects コマンドを使用します。
プロパティ
なし
出力
| 出力 |
出力タイプ |
| リストオブジェクト CSV |
ファイル |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
レポート一覧
Salesforce からレポートを一覧表示するには、List reports コマンドを使用します。
プロパティ
なし
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SOQLクエリ
SOQLクエリを実行し、その結果をCSVファイルとして生成するには、SOQLクエリ コマンドを使用します。
メモ： SOQL構文 はSQLに非常に似ている。SOQLクエリコマンドは、大量のデータを抽出し、一度に100万レコード以上のデータ設定を返却することができます。クエリが正しくない、あるいは存在しないオブジェクトを参照しているなどの理由でコマンドが失敗した場合は、コマンドの出力で通知されます。
プロパティ
| プロパティ |
詳細 |
| クエリ |
実行するSOQLクエリを入力します。 |
| クエリコマンド |
削除済レコードを含むかどうかを選択します。
- 削除済みレコードを除外するには、クエリを選択します。
- 削除済みレコードを含むには、QueryAllを選択します。
|
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SObject - 作成
Salesforce で新規 SObject を作成するには、SOjbect- 作成コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
新規SObjectの名称を入力する。これがカスタムオブジェクトであることを示すために、Salesforce は自動的に__c を追加します。 |
| フィールド |
作成するレコードフィールドをFIELD_NAME:TYPE の書式設定で入力します。TYPE は Salesforce のフィールドタイプに対応しています。 |
出力
なし
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
SObject - 削除
Salesforce で SObject を削除するには、SObject - delete コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| 名称 |
作成するSObjectsの名称を入力する。 |
出力
なし
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
更新記録
Salesforce のレコードのフィールド値を更新するには、Update record コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ID |
更新するレコードのIDを入力します。 |
| 名称 |
レコードを更新するSObjectの名称を入力する。 |
| フィールド |
FIELD_NAME:VALUE の書式設定で、更新するレコード・フィールドを入力する。 |
出力
なし
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
一般的な失敗 |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->