使用 Sforce 对象查询语言 (SOQL) 来对此活动中的一个或多个 Salesforce.com 对象类型运行查询,并且返回结果集。“查询对象”活动自动运行 query 或queryAll 调用,接着针对从 Salesforce.com 返回的所有子代和对象运行连续的 queryMore 调用。
注: 运行查询对象活动可能会导致 Salesforce.com 打开游标以跟踪查询结果。如果活动达到 Salesforce.com 分配给每个用户的游标限制,或者如果游标已过期,那么 Integration Appliance 会重试该活动。
使用查询对象活动
- 在活动选项卡中,打开 Salesforce.com 目录,以找到查询对象活动。
- 向编排中添加该活动。
活动的核对表和摘要将显示在编排下方。
- 选择 Salesforce.com 端点。
有关创建或编辑 Salesforce.com 端点的指示信息,请参阅创建或编辑 Salesforce.com 端点。
- 通过指定查询并设置查询选项来配置活动。
- 指定活动的重试和超时参数。
- 映射活动的输入。
- 映射活动的输出。
映射查询对象活动的输入
- 在核对表中,选择映射输入。
parameters 元素会显示在目标活动面板中。parameters 元素对于您在 SOQL 查询中指定的每个参数均具有一个子元素。
查询中参数的上下文决定参数类型。如果未指定任何参数,那么 parameters 元素下面不会显示任何子元素。
- 右键单击缺省节点,然后选择显示可选参数以显示此活动的可选输入参数:
- MruHeader
- CallOptions
- connection
- sessionInfo
- 单击选择输入...并为映射选择输入变量。
有关创建变量的指示信息,请参阅创建变量。
- 适当地将输入参数映射到变量。
有关映射指示信息,请参阅创建映射。
映射查询对象活动的输出
- 在核对表中,选择映射输出。
objects 元素会显示在源活动面板中。结果参数具有名为objects 的单个元素,以及以查询的驱动对象命名的单个重复元素。驱动对象是查询的FROM 子句中命名的第一个对象。例如,在以下 SOQL 语句中,Account 是驱动对象:
Select Name from Account, Account.Contacts
驱动对象具有子元素,这些子元素对应于查询的
SELECT 子句中列出的字段或关系。此模式如下定义:
- 对于字段,字段类型与字段的 SOAP 类型匹配。如果 SOAP 类型可为空,那么字段类型可为空。
- 对于父关系元素,元素名称是父代名称。如果在活动运行查询时没有父代,那么该元素不存在。父代的字段或关系显示在关系元素的正下方。
- 对于子关系元素,元素名称是子代名称。关系元素具有以子对象的对象类型命名的单个重复元素。子代的字段和关系显示在对象类型元素的下方。如果在活动运行查询时没有子代,那么该元素不存在。
- 如果您未选择任何字段或关系,而是在 SELECT 子句中请求 count(),那么会将整个对象类型元素替换为 unsignedInt 类型的且名为 count 的元素。
- 单击选择输出... 并为映射选择输出变量。
有关创建变量的指示信息,请参阅创建变量。
- 适当地将输出参数映射到变量。
有关映射指示信息,请参阅创建映射。