AEM:由于编码的个性化分隔符,Adobe Campaign Classic中的投放失败
本文介绍了当AEM创作的电子邮件模板包含升级后编码错误的个性化输出块时,Adobe Campaign Classic中发生投放失败的问题。 提供了一些步骤来识别和解决问题,尤其是当使用自定义富文本编辑器组件时。
描述 description
环境
- Adobe Experience Manager (AEM) 6.5 LTS(带有Service Pack 2或更高版本)
- Adobe Campaign Classic 8.9.3版
症状
将包含个性化输出块(如<%= recipient.firstName %>)的AEM创作的电子邮件模板同步到Adobe Campaign Classic时,如果模板在升级后使用自定义富文本编辑器(RTE)组件创作或编辑了模板,则投放准备失败。 个性化打开器中的等号采用HTML编码(=),导致导出的内容中出现了<%= recipient.firstName %>。 Adobe Campaign要求在<%后面使用等号来识别输出块;无法识别编码的实体,导致编译失败。 Campaign中的错误消息可能包括:
- JST-310054警告:无法编译脚本“content htmlContent”
- SCR-160032 JavaScript:编译脚本“content htmlContent”时出错
- JST-310007无法编译脚本(内容htmlContent)
此问题影响新同步的模板以及已刷新或重新同步的现有模板。 升级前已同步且未重新同步的模板将不受影响。 该问题特定于使用自定义RTE组件创作或编辑的模板;由Adobe的正式修复程序修补的标准组件不会受到影响。
原因
AEM 6.5 LTS(Service Pack 2之后)中的回归在富文本编辑器中引入了更严格的XSS/序列化处理,导致个性化分隔符(<%=)中的等号在自定义组件中进行HTML编码。 Adobe的官方修补程序仅修补标准个性化组件;自定义组件需要有针对性的配置更新。
解决方法 resolution
请按照以下步骤解决问题。
- 识别您的AEM实例是否使用自定义富文本编辑器(RTE)组件创作具有个性化块的电子邮件模板。
- 确认在受影响模板的
.campaign.content.json输出中,导出的内容包含<%=而不是<%=。 - 检查是否安装了适用于标准个性化组件的官方Adobe修补程序,以及它涵盖哪些组件。 如果您的自定义组件未包含在内,请继续执行下一步。
- 更新您的自定义RTE组件的配置以保留
<%= %>分隔符并阻止对等号进行HTML编码。 使用与官方修复相同的技术方法,但将其应用于您的自定义组件。 - 将更新的组件部署到暂存环境。
- 使用个性化块创作测试电子邮件模板,将其同步到Adobe Campaign,然后尝试投放。
- 确认个性化正确呈现,并且Campaign中不会出现编译错误。
- 验证后,请按照内部发布流程将修补程序部署到生产环境。
- 查看环境中可能输出非HTML或模板样式语法的其他自定义RTE组件,因为它们也可能会受到影响。
recommendation-more-help
experience-cloud-kcs-help-kbarticles