使用“Marketo 检索所有对象”活动

使用“检索所有对象”活动从 Marketo 访存对象的详细信息。

关于此任务

使用此任务在 Marketo 实例中检索所有对象详细信息。对此活动的调用是同步调用,其中会将输入数据发送到该活动以进行处理并将响应发送回到编排。

过程

  1. 在活动编排中,打开活动选项卡,然后展开 Marketo 文件夹内容。
  2. 检索所有对象活动图标拖至编排上。选择该活动。 此时会显示“Marketo 检索所有对象”核对表
  3. 在核对表中,单击摘要
  4. 复审活动名称字段的内容,并进行所需的更改。
  5. 在核对表中,单击选取端点
  6. 单击浏览,然后使用 Project Explorer 对话框来选择相关的 Marketo 端点。
  7. 可选:您可以通过单击新建并指定所需的连接详细信息来创建端点。单击确定以保存并使用此配置的端点。
  8. 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所作的任何更改都会对活动编排中端点的所有使用产生全局影响。
  9. 在核对表中,单击配置
  10. 单击浏览以选择对象类型。 这样会显示浏览 Marketo 窗口。
  11. 浏览 Marketo 窗口中,您可以从对象类型列表中选择对象类型。单击确定
  12. 核对表中,单击重试。复审缺省设置并进行所需的更改。
    注: 有关更多信息,请参阅为 Marketo REST API 活动指定重试选项

    以下两点(第 13 步和第 14 步)不适用于活动类型对象,因为该活动不需要任何输入。

  13. 核对表中选择映射输入。 从检索所有对象活动的所选对象生成的 XML 模式将显示为至活动面板中请求输入参数下的节点。
  14. 创建活动的编排变量与输入参数之间的映射。
    注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
  15. 核对表中选择映射输出。 所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
  16. 创建输出参数与编排变量之间的映射。
    表 1. 必填字段
    对象名称 字段 描述
    文件夹内容 FolderId 必填
    商机对象
    • retrieveBy
    • id
    • retrieveBy 的可能的值为 ListId 和 ProgramId
    • 标识值将为列表标识或需要其商机详细信息的程序的标识
    商机活动
    • ActivityTypeId
    • nextPageToken
    • 可使用“获取分页令牌”原子活动来获取 nextPageToken 的值。
    • 可在一条请求中提供多个 activityTypeId,因为它不受限制。
    SegmentationId 必填
    表 2. 常用参数
    对象名称 字段
    offset 检索条目时的起点。可与 maxReturn 参数结合使用以对大型结果集分页。缺省值:0
    maxReturn 要返回的最大条目数。缺省值:20。最大值:200。
    batchSize 单次调用中要返回的记录数(缺省值,最大值取决于 Marketo API。当前为 300)
    nextPageToken 用于在较大的结果集中标记页数

结果

您已配置“Marketo 检索所有对象”活动。