レコードを検索

プロジェクトの対応 OS

Windows | クロスプラットフォーム

概要

説明	API メソッド	API パス
フィルター条件を使用して、標準またはカスタムの Salesforce オブジェクト (リードや営業案件など) の 1 つ以上のレコードを検索します。	GET	/searchRecords

入力

パラメーター	説明	データ型
オブジェクトを選択	検索する Salesforce オブジェクトの API 参照名です (標準またはカスタム)。このフィールドで選択したオブジェクトに応じて、そのオブジェクトに固有のプロパティ フィールドがアクティビティに入力されます。	string
場所	フィルタービルダーを使用してフィルターを追加するか、SOQL WHERE 式を入力します。例えば LastModifiedDate >= '2014-10-12'	string
フィールド	応答で返されるフィールドのコンマ区切りのリストです	string
削除されたロールを含む	削除されたレコードを検索結果に含めるかどうかを指定します	Boolean
null を最後	null 値を持つレコードを最後に並べ替えるかどうかを指定します	Boolean
並べ替え順	結果を並べ替えるフィールドのコンマ区切りのリストです	string
レコードの最大数	1 回の回答で返されるレコードの最大数	int32
合計数を返す	一致するレコードの合計数を返すかどうかを示します	integer

出力

パラメーター	説明	データ型
レスポンス	一致する Salesforce レコードとメタデータを含む検索結果	オブジェクト

注:

• API ワークフローでは、単一の応答オブジェクトが出力として返されます。必須フィールドは、このオブジェクトから直接抽出できます。
• RPA ワークフローでは、一部の出力パラメーターが異なる場合がありますが、明示的に公開されていない場合でも、必要な値を応答オブジェクトから取得できます。

クエリの使用

CEQL (「場所」フィルター) は、すべてのコネクタを検索する標準的な方法を提供します。 多くの API プロバイダーが API 内で何らかの形式の検索をサポートしていますが、各 API プロバイダーの検索方法は異なります。 プロバイダーの各リソースに対するクエリ方法を調査するのではなく、検索エクスペリエンスを正規化しました。 クエリは、API プロバイダーの検索構文に変換されます。 利用可能なクエリ コネクタのフィールド選択でクエリを作成するとします。 各コネクタでクエリのさまざまなコンポーネントを使用できますが、ほとんどの場合、共通部分を使用できます。

クエリ参照

クエリ コンポーネント	構文	例	説明
CEQL クエリ: "where" 式	1<field><operator><value> <AND/OR> 2<field><operator><value> 3...	Department!='Procurement' AND Name='John'	検索する対象と、結果セットで返されるオブジェクトを指定する式です。下記 の「有効な CEQL 演算子 」セクションをご覧ください。これは、左側(LHS)、オペレーター、右側(RHS)で構成されています。

有効な CEQL 演算子

演算子	説明
AND	AND で区切った条件がすべて TRUE の場合は TRUE
OR	OR で区切られた条件のいずれかが TRUE の場合は TRUE
=	等しい
!=	次の値と等しくない
<	次の値より小さい
>	次の値より大きい
<=	以下
>=	以上
LIKE	オペランドは、パターンと一致する場合はTRUE
IN	オペランドが式リストの 1 つに等しい場合は TRUE
IS NULL	NULL 値が見つかった場合は TRUE
LIMIT	レコードの数を指定した数に制限します。

例

演算子	例
等号 (=)	Name='Edge Communications'
AND 演算子	Name=’Account Name’ AND Industry=’Electronics’
OR および Greater Than (>) 演算子	LastModifiedDate>'2018-01-15T00:00:00.000Z' AND (Name='Account Name' OR Industry='Apparel')
LIKE 演算子	Name LIKE 'Acc%'
次の値以上 (>=) 演算子	AnnualRevenue >= 100000