由於.content.xml中的屬性名稱無效,AEM套件上傳失敗
本文說明當.content.xml中的屬性名稱不符合XML QName標準時,如何解決在Adobe Experience Manager (AEM)套件上傳期間遇到的錯誤。
說明 description
環境
Adobe Experience Manager (AEM),所有版本
症狀
上傳包含PDF資產的封裝時,如果資產的.content.xml包含以數字開頭的屬性名稱(例如: dc:4uSync),則上傳會失敗。 記錄中出現下列錯誤:
org.apache.jackrabbit.vault.fs.io.DocViewParser$XmlParseException: Element or attribute "dc:4uSync" do not match QName production: QName::=(NCName:)?NCName.
套件上傳失敗,且資產未匯入。
原因
發生錯誤是因為XML QName語法不允許元素或屬性名稱以數字開頭。 AEM的套件匯入工具會強制執行此標準,導致出現無效屬性名稱時剖析失敗。
解決方法 resolution
請依照下列步驟解決問題:
- 開啟受影響資產的
.content.xml檔案。 - 找出任何以數字開頭的屬性名稱(例如:
dc:4uSync)。 - 重新命名屬性,使其以字母開頭,遵循XML QName標準(例如:將
dc:4uSync變更為dc:uSync4)。 - 儲存變更並重新封裝內容。
- 請使用AEM封裝管理員重試封裝上傳。
確認套件已成功上傳,且資產已匯入。
相關閱讀
recommendation-more-help
experience-cloud-kcs-help-kbarticles