由於.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

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

  1. 開啟受影響資產的.content.xml檔案。
  2. 找出任何以數字開頭的屬性名稱(例如: dc:4uSync)。
  3. 重新命名屬性,使其以字母開頭,遵循XML QName標準(例如:將dc:4uSync變更為dc:uSync4)。
  4. 儲存變更並重新封裝內容。
  5. 請使用AEM封裝管理員重試封裝上傳。

確認套件已成功上傳,且資產已匯入。

相關閱讀

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