Salesforce - SOQLクエリを使用したレコードの一括検索アクション
このアクションは、指定したSOQLクエリに一致するSalesforceレコードのCSVストリームを取得します。 このアクションはSalesforce Bulk APIを使用します。
ポーリング動作
ポーリングを伴うアクションを含むレシピは、非同期ポーリングが想定どおりに機能するよう、実行中の状態である必要があります。
SOQLの詳細についてはSOQLガイドを、一括操作の詳細についてはSalesforce一括操作ガイドを参照してください。
APIバージョン
このアクションは、API v1.0とAPI v2.0の両方のバージョンに存在します。 Workatoでは、最適なパフォーマンスを得るためにBulk API v2.0の使用をお勧めします。 このバージョンでは、レコードをより効率的にバッチ処理することで、Salesforce API制限への影響を軽減します。
SOQLのSELECT句
SOQLクエリは、SQLクエリでよく使用されるSELECT *操作をサポートしていません。 取得する特定のフィールドをSELECT句で指定する必要があります。
入力
| 入力項目 | 説明 |
|---|---|
| SOQLクエリ | LIMITパラメーターを除いた有効なSOQLクエリを指定します。 論理演算子の句は括弧で囲みます。 |
| 削除されたレコードを含めますか? | 結果に削除されたレコードを含めるかどうかを選択します。 デフォルトはNoです。 |
| ヘッダー行を含めますか？ | CSV結果にヘッダー行を含めるかどうかを選択します。 |
| 失敗したジョブのログをSalesforceインターフェースに保持しますか？ | 失敗したジョブのログをSalesforceに保持するかどうかを選択します。 デフォルトはNoです。 |
| SalesforceがすべてのCSV行を処理するまで待機しますか？ （詳細設定） | アクションを同期的に実行するかどうかを選択します。 次のアクションを開始する前に、SalesforceがCSVファイルのすべての行を処理するまで待機するには、Yesを選択します。 CSVファイルがSalesforceにアップロードされた後に次のアクションを開始するには、Noを選択します。 バルク操作はデフォルトで非同期です。 |
| 代理ユーザーのメールアドレス | 任意です。 代理実行するSalesforceユーザーのメールアドレスを入力します。 このフィールドを有効にするには、Workato Customer Success Managerにお問い合わせください。 このフィールドはJWTコネクションのみをサポートします。 |
出力
| 出力フィールド | 説明 |
|---|---|
| ジョブID | ジョブのSalesforce ID。 |
| すべてのレコードは正常に処理されましたか | Salesforce一括ジョブ全体ですべてのCSV行が正常に処理されたかどうかを指定します。 |
| CSV結果 | 取得されたレコードのCSVストリーム。 BoxやSFTPなどのファイルコネクターを使用して、CSVストリームをファイルに書き込むことができます。 Workatoでは、CSVツール by WorkatoユーティリティコネクターのParse CSVアクションを使用して、データのリストとして解析することもできます。 |
| 処理済みレコード数 | ヘッダー行を除く、Salesforceで処理されたCSV行の合計数。 |
| 処理失敗レコード数 | Salesforceで問題が発生し、処理されなかったCSV行の合計数。 |
| 再試行されたレコード数 | Salesforceで処理が再試行されたCSV行の合計数。 このフィールドは、CSVファイルからSalesforceでオブジェクトのバルクジョブを再試行アクションに関連します。 |
| 処理時間 | レコードの処理に費やされた時間。 |
Last updated: