使用 Eloqua Bulk API 的“更新导出定义”活动
使用“更新导出定义”活动在 Eloqua 中更新导出定义。
使用此任务在 Eloqua 中更新导出定义。对此活动的调用是同步调用,在此调用中会将输入数据发送到该活动以进行处理并将响应发送回编排。
要配置 Eloqua Bulk API 的“更新导出定义”活动:
- 在活动编排中,打开活动选项卡,然后展开 Eloqua Bulk API 文件夹内容。
- 将更新导出定义活动图标拖至编排上。这样会显示“Eloqua Bulk API 更新导出定义”核对表。
- 在核对表中,单击摘要。
- 复审活动名称字段的内容,并进行所需的更改。
- 在核对表中,单击选取端点。
- 单击浏览,然后使用 Project Explorer 对话框来选择相关 Eloqua Bulk API 端点。
- 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所作的任何更改都会对活动编排中端点的所有使用产生全局影响。
- 在核对表中,单击配置。
- 单击浏览以选择对象类型。这样会显示浏览 Eloqua Bulk API 窗口。
- 在浏览 Eloqua Bulk API 中,可以通过在搜索对象类型字段中指定对象类型来过滤对象类型,也可以从对象类型列表中选择对象类型。单击确定。此时会显示对象字段首选项。
- 在对象字段首选项中,通过选择对应的字段名称复选框来选择想要映射的字段。
- 在核对表中,单击重试。复审缺省设置并进行所需的更改。
- 在核对表中选择映射输入。从“更新导出定义”活动的所选对象生成的 XML 模式将显示为至活动面板中请求输入参数下的节点。
- 创建活动的编排变量与输入参数之间的映射。
必填字段:活动具有以下必填字段:
- id:现有导出定义的标识。
- 名称:定义的名称。
- 字段:具有以下字段:
- sourceField:这将是来自源数据的一个列名。
- EloquaDestinationField:sourceField 数据将映射到的 Eloqua 列名。
可选字段:活动具有以下可选字段:
- autoDeleteDuration:删除定义前的时间。
- dataRetentionDuration:删除已登台数据前的时间。
- maxRecords:指定要导出的最大记录数。
- Filters:指定用于过滤的查询条件。过滤器使用比较、逻辑和存在运算符来基于 Eloqua 字段值过滤导入数据。具有以下字段:
- Filter:用于创建过滤语句。
- elename:用于选择想要导出的数据。
- 运算符:用于指定条件。
- value:过滤器的值。
- AdditionalFilters:用于添加多个过滤器。
- 运算符:Eloqua Bulk API 还支持复杂过滤器,此过滤器基于使用 AND、OR 和 NOT 运算符的多个条件进行过滤。
- 过滤器:使用过滤器部分中定义的相同参数。
- Filter:用于创建过滤语句。
- syncActions:指定要在导出期间执行的其他操作。具有以下字段:
- 操作:指定要执行的操作。操作可以是 add、remove 或 setStatus。
- 目标:指定操作的发生位置。对于 add 或 remove 操作,这可以是列表或电子邮件组的 URI。对于 setStatus,可以是 AppCloud 操作或决策服务的 URI。
- 状态:指定应针对 setStatus 操作设置的状态。以下状态可用:
- subscribed
- unsubscribed
- active
- complete
- pending
- errored
- yes
- no
注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
- 在核对表中选择映射输出。所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
- 创建输出参数与编排变量之间的映射。
您已配置 Eloqua Bulk API 的“更新导出定义”活动。