使用 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 模式将显示为至活动面板中请求输入参数下的节点。
- 创建活动的编排变量与输入参数之间的映射。
必填字段:活动具有以下必填字段:
- 名称:定义的名称。用于复用定义。
- identifierFieldName:指定用于将导入的数据与现有 Eloqua 数据相匹配的字段。
- 字段:具有以下字段:
- sourceField:这将是来自源数据的一个列名。
- EloquaDestinationField:sourceField 数据将映射到的 Eloqua 列名。
可选字段:活动具有以下可选字段:
- autoDeleteDuration:删除定义前的时间。
- dataRetentionDuration:删除已登台数据前的时间。
- isUpdatingMultipleMatchedRecords:指定如果多条记录与 identifierFieldName 匹配,Eloqua 是否应更新多条记录。
- updateRule:以下规则类型可用:
- always:始终更新。
- ifNewIsNotNull:如果新值不为空,那么进行更新。
- ifExistingIsNull:如果现有值为空,那么将进行更新。
- useFieldRule:使用在字段级别定义的规则。
- syncActions:指定要在导入期间执行的其他操作。具有以下字段:
- 操作:指定要执行的操作。操作可以是 add、remove 或 setStatus。
- 目标:指定操作的发生位置。对于 add 或 remove 操作,这可以是列表或电子邮件组的 URI。对于 setStatus,可以是 AppCloud 操作或决策服务的 URI。
- 状态:指定应针对 setStatus 操作设置的状态。以下状态可用:subscribed、unsubscribed、active、complete、pending、errored、yes 和 no。
注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
- 在核对表中选择映射输出。所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
- 创建输出参数与编排变量之间的映射。
您已配置 Eloqua Bulk API 的“创建导入定义”活动。