使用“批量检索对象”活动在 MailChimp 中异步检索对象。
请参阅“MailChimp 连接器支持的对象”。
关于此任务
使用此任务仅在一次调用中检索 MailChimp 实例中的多个对象。对此活动的调用是异步调用,在此调用中会将输入数据发送到该活动以进行处理,而不将实际响应发送回编排。批处理标识作为响应发送。借助此“批处理标识”使用“获取批处理状态活动”定期检查批处理状态。
过程
- 在活动编排中,打开活动选项卡,然后展开 MailChimp 文件夹内容。
- 将批量检索对象活动图标拖至编排上。
选择该活动。 此时会显示“MailChimp 批量检索对象”核对表。
- 在核对表中,单击摘要。
- 复审活动名称字段的内容,并进行所需的更改。
- 在核对表中,单击选取端点。
- 单击浏览,然后使用 Project Explorer 对话框来选择相关的 MailChimp 端点。
- 可选:您可以通过单击新建并指定所需的连接详细信息来创建端点。单击确定以保存并使用此配置的端点。
- 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所作的任何更改都会对活动编排中端点的所有使用产生全局影响。
- 在核对表中,单击配置。
- 对象类型和列表名称浏览可用。
仅针对成员对象启用列表名称浏览。
- 单击浏览以选择“列表名称”。 这样会显示浏览 MailChimp 窗口。
- 在对象类型浏览 MailChimp 窗口中,您可以从对象类型列表中选择 MailChimp 对象类型。单击确定。
- 在列表名称浏览 MailChimp 窗口中,您可以选择 MailChimp 列表名称。单击确定。
- 在核对表中,单击重试。复审缺省设置并进行所需的更改。
- 从核对表中选择映射输入。
从批处理检索对象活动的所选对象生成的 XML 模式将显示为至活动面板中请求输入参数下的节点。
- 创建活动的编排变量与输入参数之间的映射。
注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
- 从核对表中选择映射输出。
所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
- 创建输出参数与编排变量之间的映射。
表 1. 批量检索参数字段名 |
描述 |
retrieveAll |
缺省情况下,retrieveAll 为 False。确定是执行检索还是检索全部操作。如果 retrieveAll 设置为 True,那么将执行检索全部操作。 |
表 2. retrieveAll 验证案例retrieveAll 标志 |
场景 |
验证消息 |
retrieveAll 为 True |
对象仅支持检索操作 |
该对象无法使用“检索全部”选项。 |
retrieveAll 为 True |
对象支持 retrieve 和 retrieveAll。提供标识,它是检索操作的一部分 |
不得为 RetrieveAll 功能提供标识。 |
retrieveAll 为 True |
未提供父标识 |
应提供标识。 |
retrieveAll 为 False 或者未提供 |
对象仅支持 retrieveAll 操作 |
该对象无法使用“检索”选项。 |
retrieveAll 为 False 或者未提供 |
对象支持 retrieve 和 retrieveAll。未提供检索操作所需标识。 |
RetrieveAll 应为 True,或应提供标识。 |
retrieveAll 为 False 或者未提供 |
对象支持 retrieve 和 retrieveAll。已设置计数或偏移值 |
只有 retrieveAll 为 True 时,计数和偏移才适用。 |
结果
您已配置“MailChimp 批量检索对象”活动。
注: MailChimp 还支持定制字段值更新。请参阅有关定制字段支持的部分以获取更多信息。
您可以将多个对象作为输入添加到此活动。要将多个对象添加为输入,请在“映射输入”的至活动窗格中右键单击对象,然后选择展开出现示例。仅支持同一类型的多个对象。