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编码(&#61;),导致导出的内容中出现了&lt;%&#61; recipient.firstName %&gt;。 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

请按照以下步骤解决问题。

  1. 识别您的AEM实例是否使用自定义富文本编辑器(RTE)组件创作具有个性化块的电子邮件模板。
  2. 确认在受影响模板的.campaign.content.json输出中,导出的内容包含&lt;%&#61;而不是<%=。
  3. 检查是否安装了适用于标准个性化组件的官方Adobe修补程序,以及它涵盖哪些组件。 如果您的自定义组件未包含在内,请继续执行下一步。
  4. 更新您的自定义RTE组件的配置以保留<%= %>分隔符并阻止对等号进行HTML编码。 使用与官方修复相同的技术方法,但将其应用于您的自定义组件。
  5. 将更新的组件部署到暂存环境。
  6. 使用个性化块创作测试电子邮件模板,将其同步到Adobe Campaign,然后尝试投放。
  7. 确认个性化正确呈现,并且Campaign中不会出现编译错误。
  8. 验证后,请按照内部发布流程将修补程序部署到生产环境。
  9. 查看环境中可能输出非HTML或模板样式语法的其他自定义RTE组件,因为它们也可能会受到影响。
recommendation-more-help
experience-cloud-kcs-help-kbarticles