AEM Cloud Sites:主體內容未呈現在媒體模組元件中

本文說明如何解決AEM Cloud Sites中,即使內容在其他環境中如預期般顯示,媒體模組元件中的內文內容無法正確呈現給使用者的問題。

說明 description

環境

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

症狀

  • 在已發佈頁面上的媒體模組元件中,一般使用者缺少內文(RTE)內容或內容無法正確呈現。
  • 與其他AEM Cloud Sites環境(例如製作和預覽)中預期顯示的內容相同。
  • 此問題可對所有使用者重複產生,且不是特定於帳戶的。
  • 在受影響的頁面中,只有專家標題或其他欄位會呈現在內文容器中,而撰寫的傳記或內文段落不會顯示。
  • 檢視頁面來源可確認內容存在於傳遞來源中,但使用者的轉譯DOM會忽略預期的內文內容。

原因

此問題是由於media-module.js元件使用硬式編碼的列索引(例如: rows[ 8])做為內文(RTE)內容的遞補內容時,所發佈的標籤中遺失通用編輯器欄位標籤所造成。 如果列順序變更或不符合預期的結構,則會轉譯錯誤的內容(例如專家標題)來取代內文內容。

解決方法 resolution

請依照下列步驟解決問題:

  1. 檢閱media-module.js元件的實作,特別是負責選取要呈現為Body (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