重新命名AEM中內容片段變數的內部名稱

Adobe Experience Manager (AEM)在重新命名內容片段變數時只會更新顯示標題(jcr:title),而jcr:content/data底下的內部變數名稱會維持不變,因為變數是在建立時設定的。 若要解決此問題,請使用所需的內部名稱建立新的變數、複製內容、更新其參照,並在驗證後移除舊變數。

說明 description

環境

Adobe Experience Manager (所有版本)

問題/症狀

  • 重新命名內容片段編輯器中的內容片段變數只會更新其顯示標籤(jcr:title)。
  • 內部變數名稱(即jcr:content/data下的節點名稱)保持不變。
  • 元件和Headless API (例如GraphQL)會使用內部名稱來參照變數。
  • 現有變數建立後,不支援直接變更內部名稱的方式。

根本原因

內容片段變數的內部名稱是在建立變數時設定,並由AEM元件和API用來作為識別碼。 重新命名UI中的變數只會更新顯示標籤(jcr:title),不會更新內部節點名稱。 此行為是藉由設計和維護Headless和元件型整合的穩定參考。

解決方法 resolution

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

  1. 在內容片段編輯器中,使用所需的內部名稱和標題建立新的變數。
  2. 手動將內容從原始變數複製到新變數。
  3. 更新所有參考(例如頁面、元件和GraphQL查詢)以使用新的變數名稱。
  4. 確認新變數名稱的所有功能都如預期般運作。
  5. 完成驗證後,請移除舊變數以避免混淆。
recommendation-more-help
experience-cloud-kcs-help-kbarticles