搜索记录

Salesforce 连接器中的“搜索记录”活动。

项目兼容性

Windows | 跨平台

概述

描述	API 方法	API 路径
使用筛选条件搜索标准或自定义 Salesforce 对象（例如，潜在客户或商机）的一条或多条记录。	获取	/搜索记录

输入

参数	描述	数据类型
选择对象	要搜索的 Salesforce 对象的 API 名称（标准或自定义）。根据在此字段中选择的对象，活动将填充该对象的特定属性字段。	字符串
位置	使用筛选器构建器添加筛选器，或输入 SOQL WHERE 表达式。例如， LastModifiedDate >= '2014-10-12'	字符串
字段	要在响应中返回的字段的逗号分隔列表	字符串
包含已删除的项目	指示搜索结果是否应包含已删除的记录	boolean
最后一个为 null	指定是否应将带有空值的记录放在最后排序	boolean
排序依据	用于对结果进行排序的字段的逗号分隔列表	字符串
最大记录数	单个响应中返回的最大记录数	Int32
返回总计数	指示是否应返回匹配记录的总数	整数

输出

参数	描述	数据类型
响应	包含匹配的 Salesforce 记录和元数据的搜索结果	对象

备注：

• 在 API 工作流中，系统会返回一个响应对象作为输出。任何必填字段均可直接从此对象中提取。
• 在 RPA 工作流中，某些输出参数可能有所不同，但即使未显式公开，仍可以从响应对象中检索必要的值。

使用查询

CEQL（“位置”筛选器）提供了一种在所有连接器中搜索的标准方法。许多 API 提供程序都支持在其 API 中进行某种形式的搜索，但每个提供程序的搜索方法都不同。我们并未让您研究如何在提供程序中查询每个资源，而是已规范您的搜索体验。

CEQL 会将您的查询转换为 API 提供程序的搜索语法。您可以使用可用的查询连接器字段选择来编写查询。每个连接器都允许使用不同的查询组件，但在大多数情况下，您可以使用一些通用部分。

查询引用

查询组件	语法	示例	描述
CEQL 查询“Where”表达式	1<field><operator><value> <AND/OR> 2<field><operator><value> 3...	部门!=“采购”AND Name=“John”	一个或多个表达式，用于指定要搜索的内容以及要在结果集中返回的对象。请参阅下面的“有效 CEQL 运算符”部分。由左侧 (LHS)、一个运算符和右侧 (RHS) 组成。

有效的 CEQL 运算符

运算符	说明
AND	如果由“和”分隔的所有条件都为 TRUE，则为 TRUE
或	如果由 OR 分隔的任何条件为 TRUE，则为 TRUE
=	等于
!=	不等于
<	小于
>	大于
<=	小于或等于
>=	大于或等于
LIKE	如果操作对象与模式匹配，则为 TRUE
IN	如果操作数等于表达式列表中的其中一个，则为 TRUE
IS NULL	如果找到 NULL 值，则为 TRUE
LIMIT	将记录数限制为指定的数量

示例

运算符	示例
等号运算符 (=)	Name='Edge Communications'
AND 运算符	Name=’Account Name’ AND Industry=’Electronics’
OR 和大于 (>) 运算符	LastModifiedDate>'2018-01-15T00:00:00.000Z' AND (Name='Account Name' OR Industry='Apparel')
LIKE 运算符	Name LIKE 'Acc%'
大于或等于 (>=) 运算符	AnnualRevenue >= 100000