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でオブジェクトのバルクジョブを再試行アクションに関連します。 |
| 処理時間 | レコードの処理に費やされた時間。 |
最終更新日: