查询对象活动

使用 Sforce 对象查询语言 (SOQL) 来对此活动中的一个或多个 Salesforce.com 对象类型运行查询,并且返回结果集。“查询对象”活动自动运行 queryqueryAll 调用,接着针对从 Salesforce.com 返回的所有子代和对象运行连续的 queryMore 调用。

注: 运行查询对象活动可能会导致 Salesforce.com 打开游标以跟踪查询结果。如果活动达到 Salesforce.com 分配给每个用户的游标限制,或者如果游标已过期,那么 Integration Appliance 会重试该活动。

使用查询对象活动

  1. 活动选项卡中,打开 Salesforce.com 目录,以找到查询对象活动。
  2. 向编排中添加该活动。

    活动的核对表摘要将显示在编排下方。

  3. 选择 Salesforce.com 端点。

    有关创建或编辑 Salesforce.com 端点的指示信息,请参阅创建或编辑 Salesforce.com 端点

  4. 通过指定查询并设置查询选项来配置活动。
  5. 指定活动的重试超时参数。
  6. 映射活动的输入。
  7. 映射活动的输出。

映射查询对象活动的输入

  1. 核对表中,选择映射输入

    parameters 元素会显示在目标活动面板中。parameters 元素对于您在 SOQL 查询中指定的每个参数均具有一个子元素。 查询中参数的上下文决定参数类型。如果未指定任何参数,那么 parameters 元素下面不会显示任何子元素。

  2. 右键单击缺省节点,然后选择显示可选参数以显示此活动的可选输入参数:
    • MruHeader
    • CallOptions
    • connection
    • sessionInfo
  3. 单击选择输入...并为映射选择输入变量。

    有关创建变量的指示信息,请参阅创建变量

  4. 适当地将输入参数映射到变量。

    有关映射指示信息,请参阅创建映射

映射查询对象活动的输出

  1. 核对表中,选择映射输出

    objects 元素会显示在源活动面板中。结果参数具有名为objects 的单个元素,以及以查询的驱动对象命名的单个重复元素。驱动对象是查询的FROM 子句中命名的第一个对象。例如,在以下 SOQL 语句中,Account 是驱动对象:

    Select Name from Account, Account.Contacts

    驱动对象具有子元素,这些子元素对应于查询的 SELECT 子句中列出的字段或关系。此模式如下定义:
    • 对于字段,字段类型与字段的 SOAP 类型匹配。如果 SOAP 类型可为空,那么字段类型可为空。
    • 对于父关系元素,元素名称是父代名称。如果在活动运行查询时没有父代,那么该元素不存在。父代的字段或关系显示在关系元素的正下方。
    • 对于子关系元素,元素名称是子代名称。关系元素具有以子对象的对象类型命名的单个重复元素。子代的字段和关系显示在对象类型元素的下方。如果在活动运行查询时没有子代,那么该元素不存在。
    • 如果您未选择任何字段或关系,而是在 SELECT 子句中请求 count(),那么会将整个对象类型元素替换为 unsignedInt 类型的且名为 count 的元素。
     
  2. 单击选择输出... 并为映射选择输出变量。

    有关创建变量的指示信息,请参阅创建变量

  3. 适当地将输出参数映射到变量。

    有关映射指示信息,请参阅创建映射