AEM:由於編碼的個人化分隔字元,Adobe Campaign Classic中的傳送失敗
本文介紹當AEM編寫的電子郵件範本包含升級後編碼錯誤的個人化輸出區塊時,Adobe Campaign Classic中發生傳送失敗的問題。 提供的步驟可用於識別和解決問題,尤其是當使用自訂RTF編輯器元件時。
說明 description
環境
- Adobe Experience Manager (AEM) 6.5 LTS (含Service Pack 2或更新版本)
- Adobe Campaign Classic版本8.9.3
症狀
將包含個人化輸出區塊(例如<%= recipient.firstName %>)的AEM編寫電子郵件範本同步至Adobe Campaign Classic時,如果範本是在升級後使用自訂RTF編輯器(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之後)中的回歸在RTF編輯器中引進了更嚴格的XSS/序列化處理,導致個人化分隔字元(<%=)中的等號在HTML編碼為自訂元件。 Adobe的官方修正僅修補標準個人化元件;自訂元件需要目標設定更新。
解決方法 resolution
請依照下列步驟解決問題。
- 識別您的AEM執行個體是否使用自訂RTF編輯器(RTE)元件來編寫包含個人化區塊的電子郵件範本。
- 確認受影響範本的
.campaign.content.json輸出中,匯出的內容包含<%=而非<%=。 - 檢閱是否已安裝標準個人化元件的正式Adobe修正,及其涵蓋的元件。 如果您的自訂元件未涵蓋在內,請繼續進行下一個步驟。
- 更新您的自訂RTE元件設定,以保留
<%= %>分隔字元並防止等號的HTML編碼。 使用與官方修正相同的技術方法,但將其套用至您的自訂元件。 - 將更新的元件部署至測試環境。
- 使用個人化區塊製作測試電子郵件範本、將其同步至Adobe Campaign,然後嘗試傳送。
- 確認個人化可正確轉譯,且Campaign中不會發生編譯錯誤。
- 驗證後,請依照內部發行程式,將修正程式部署至生產環境。
- 檢閱您環境中可能輸出非HTML或範本樣式語法的其他自訂RTE元件,因為這些元件也可能會受到影響。
recommendation-more-help
experience-cloud-kcs-help-kbarticles