获取记录元素
“获取记录”元素查找满足筛选和排序条件的所有 Salesforce 或市场营销对象记录,并将检索到的记录中的值存储在变量中。您可以使用“获取记录”元素检索 Salesforce 标准和自定义对象记录或市场营销对象记录。
所需的 Edition
此视频解释了什么是“获取记录”元素,以及您为何应在流中使用它。
在单独的选项卡中查看此视频。
此脚本提供基于文本的视频内容版本。
您是否知道 Flow 未连接到数据?流不知道您的 Salesforce 组织中发生了什么。我们如何将数据导入流?如果有数据元素帮助我们将数据导入流就好了?哦 等等 有为了将信息提取到流中,我们使用获取记录数据元素。获取记录允许您选择要获取记录的对象,甚至设置条件来决定要获取哪些记录。您可以获取一个或多个记录。在记录中,您可以获取所有字段,也可以只选择您需要的字段。在记录进入流后,您可以通过多种方式处理信息。您可以通知决策,更新您拉入流的记录,更新其他记录;所有这些决策、更新等都是临时的,只存在于流中,直到信息被发送回您的 Salesforce 组织。这可以通过创建、删除和更新记录数据元素来完成。获取记录会将信息拉入流,创建、删除和更新记录元素会将这些信息推回 Salesforce 组织。
获取相关记录 (Beta)
“获取记录”元素中的相关记录在自动启动的流中可用。请参阅从流中获取相关 Salesforce 记录 (Beta)。
要存储的记录数量
使用您想要查找的记录识别对象。通过指定筛选条件和排序顺序,缩小返回的记录列表。
| 选择 | 如果您想要 |
|---|---|
| 仅第一条记录 | 仅存储满足指定条件的第一个记录。 例如,使用此选项通过查找与呼叫者的电话号码匹配的第一个记录来检索呼叫者的详细信息。 |
| 所有记录 | 存储满足指定条件的所有记录。 例如,在您想要收集与市场营销活动的特定客户相关联的所有联系人时,使用此选项。 |
| 所有记录,最多指定限制。 | 存储所有记录到指定的上限。 指定一个介于 2 和 20000 之间的数字作为上限。您可以在“要存储的最大记录数”字段中使用数字数据类型的文字、变量、常量或公式。 例如,使用此选项检索前 50 个记录,以便您可以从大型数据集分析样本。 |
如何存储记录数据
在您将“获取记录”元素添加到屏幕流或自动启动的流时,Salesforce 会自动将所有记录值存储在流变量中。当流移动到下一个元素时,这些值被分配给变量。
| 选择 | 如果您想要 |
|---|---|
| 自动存储所有字段 | 自动存储满足指定筛选条件的所有记录字段。检索到的记录中的每个字段都存储在流变量中。当您必须使用记录中的多个字段并希望确保所有数据都可用而无需单独指定每个字段时,此选项非常有用。 例如,在您想要分析漏斗中的每个业务机会时,使用此选项存储所有业务机会字段。然后,您可以使用字段进行详细分析,或在后续流中使用它们。 |
| 选择字段,并让 Salesforce 执行其余操作 | 手动指定要从检索的记录中存储哪些字段。使用此选项,您可以有选择地选择存储的数据,如果您只需要特定字段,这将提高效率。 例如,在客户服务代表仅需要更新分配给他们的所有未处理个案的优先级和状态时,使用此选项。您可以通过仅从记录中获取所需字段来降低复杂性并提高性能。 |
| 选择字段并分配变量(高级) | 在屏幕流或自动启动流中手动存储记录值。 例如,要计算特定市场活动的所有赢得的业务机会的总值,请将金额字段分配给特定变量。选择字段并分配变量可使流轻松添加这些值并根据总金额执行其他计算。请参阅选择字段并分配变量(高级) |
选择字段并分配变量(高级)
| 如果您想要 | 则 |
|---|---|
| 仅手动存储第一个记录的字段值 |
|
| 手动存储多个记录的字段值 | 将值存储在记录集合变量中。当您一次使用记录集合变量创建、更新或删除多个记录时,您可以减少流中 DML 请求的数量。您更有可能保持在贵组织的限制内。请参阅事务中的流批量化。 以下是一些示例。
|
对检索的记录进行排序
根据选定字段,按升序或降序排序检索到的记录。当您希望以特定顺序处理记录时,排序顺序非常有用。在您按日期字段排序记录并选择升序时,最早的日期会优先显示。如果选择降序,最新日期将优先显示。在您按数字字段排序记录并选择升序时,最小值会优先显示。如果选择降序,最大值会优先显示。
在您按升序排序记录时,空值会显示在列表的开头,因为空值被视为可能的最小值。相反,当您按降序排序记录时,空值会显示在列表末尾。
找出检索了多少记录
如果您想知道“获取记录”元素返回的记录数量,请先创建数字变量。接下来,通过将分配元素与等于计数运算符一起使用,从“获取记录”元素中为数字变量分配记录集合变量的值。调试流时,数字变量的值会告诉您检索了多少条记录。
如果未返回记录的错误处理
如果您的“获取记录”元素设置为“选择字段并分配变量(高级)”,并且没有记录匹配筛选条件,流不会检索任何记录。您用于存储字段值的变量为空或空。这意味着依赖于这些变量的任何流逻辑都需要处理不存在数据的情况。在继续执行依赖于检索到的数据的操作之前,使用决策元素检查变量是否为空。如果您的流面向用户,请为用户提供反馈,表示未找到匹配记录。这些反馈可以改善用户体验,因为可以明确某些操作或数据不可用的原因。
定义筛选器标准的注意事项
-
在您定义多个筛选器时,筛选器逻辑通常会默认设置为“和”。但如果多个筛选器均选择相同字段并使用等于运算符,则筛选器会使用“或”合并。
例如,筛选器会检查个案的类型是否等于问题 (1)、类型是否等于功能请求 (2) 以及升级是否等于真 (3)。在运行时,筛选器会合并到
(1 OR 2) AND 3。 - 可用筛选运算符取决于所选字段的数据类型。有关详细信息,请查看数据元素和记录选择集中的流运算符。
- 要将 Data Cloud 对象用作数据源,贵组织必须包含该对象的数据映射。数据映射将数据湖对象 (DLO) 字段与数据模型对象 (DMO) 字段相关联。如果贵组织未包含映射,您无法在“获取记录”元素中选择 Data Cloud 数据空间或对象。
- 市场营销对象记录适用于 Starter Suite、Marketing Cloud Growth 和 Marketing Cloud Advanced Edition。要将市场营销对象用作数据源,您需要对市场营销对象拥有读取、创建、编辑和删除权限。
