AEM Cloud Sites:正文内容未在media-module组件中渲染

本文介绍如何解决AEM Cloud Sites上最终用户无法正确呈现Media-module组件中的正文内容的问题,即使内容在其他环境中按预期显示也是如此。

描述 description

环境

Adobe Experience Manager (AEM) Cloud Sites(所有版本)

症状

  • 在已发布页面上的媒体模块组件中,最终用户缺少正文(RTE)内容或无法正确呈现内容。
  • 与其他AEM Cloud Sites环境(例如创作和预览)中预期显示的内容相同。
  • 该问题对于所有用户均可重现,且不是特定于帐户的。
  • 在受影响的页面中,只有专家标题或其他字段会呈现在正文容器中,而编写的个人简介或正文段落不可见。
  • 查看页面源可确认投放源中存在内容,但为最终用户呈现的DOM会忽略预期的主体内容。

原因

此问题是由于media-module.js组件使用硬编码的行索引(例如: rows[ 8])作为主体(RTE)内容的回退而导致的,此时已发布的标记中缺少通用编辑器字段标记。 如果行顺序更改或与预期的结构不匹配,则会呈现错误的内容(如专家标题)来代替正文内容。

解决方法 resolution

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

  1. 查看media-module.js组件的实施,特别是负责选择要呈现为正文(RTE)内容的行的逻辑。
  2. 识别在通用编辑器字段标记缺失时回退逻辑如何选择行。 例如,检查它是否使用硬编码索引,如rows[ 8]。
  3. 确定当前发布的标记中正文(RTE)内容的正确行索引。 例如,如果rows[ 9]包含正文(RTE)内容,请更新回退逻辑以选择rows[ 9]而不是rows[ 8]。
  4. 或者,考虑实施与位置无关的回退机制,该机制根据内容或结构而不是依赖固定索引来标识Body (RTE)行。 此方法使组件对未来行顺序的更改更具鲁棒性。
  5. 在暂存环境中测试更新的逻辑。 使用浏览器开发人员工具验证是否在.media-module-rte容器中呈现了正确的内容。
  6. 验证后,将更新的组件部署到生产环境。
  7. 监控受影响的页面,以确保正文(RTE)内容现在可为最终用户正确呈现。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles