使用 Coupa“检索”活动

使用 Coupa“检索”活动在 Coupa 实例中检索对象。

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

  1. 在活动编排中,打开活动选项卡,然后展开 Coupa 文件夹内容。
  2. 检索活动图标拖至编排上。这样会显示“Coupa 检索对象”核对表
  3. 核对表中,单击摘要
  4. 复审活动名称字段的内容,并进行所需的更改。
  5. 核对表中,单击选取端点
  6. 单击浏览,然后使用 Project Explorer 对话框来选择相关的 Coupa 端点。
  7. 可选:您可以通过单击新建并指定所需的连接详细信息来创建端点。单击确定以保存并使用此配置的端点。
  8. 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所作的任何更改都会对活动编排中端点的所有使用产生全局影响。
  9. 核对表中,单击配置
  10. 单击浏览以选择对象类型。这样会显示浏览 Coupa 窗口。
  11. 浏览 Coupa 中,可以通过在搜索对象类型字段中指定对象类型来过滤对象类型,也可以从对象类型列表中选择对象类型。单击确定。此时会显示对象字段首选项。
  12. 对象字段首选项中,通过选择对应的字段名称复选框来选择想要映射的字段。
  13. 核对表中,单击重试。复审缺省设置并进行所需的更改。
  14. 核对表中选择映射输入。 从检索对象活动的所选对象生成的 XML 模式将显示为至活动面板中请求输入参数下的节点。
  15. 创建活动的编排变量与输入参数之间的映射。
注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
  1. 核对表中选择映射输出。 所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
  2. 创建输出参数与编排变量之间的映射。

表:映射输入参数

字段名 描述
retrieveAll 如果用户想要访存特定对象类型的所有记录,那么应将此参数设置为 true。缺省值为 false。如果为 id 指定了值,那么将忽略此参数。
limit 仅在 retrieveAlltrue 时适用。此参数用于标记结果的页数。它将检索到的记录数限制为指定的值。每次返回的最大结果数为 50,即使指定的限制值超过 50。
offset 仅在 retrieveAlltrue 时适用。此参数用于标记结果的页数。从指定的偏移量开始检索记录。
id 必须检索其数据的对象标识。此参数优先于 retrieveAll,如果指定了 id,那么将忽略 retrieveAll 的值。
supplier-id 关联的供应商标识。仅适用于 RemitToAddress 对象。

您已配置“Coupa 检索对象”活动。

注: 您可以将多个对象作为输入添加到此活动。要将多个对象添加为输入,请在映射输入至活动窗格中右键单击相应对象的标识字段,然后选择展开出现示例