文件Experience Cloud KCS

AEM Universal Editor的複合多欄位不支援自訂資產選取器

最後更新： 2026年8月1日

本文說明在Adobe Experience Manager (AEM)通用編輯器的複合多欄位容器中使用自訂資產選擇器欄位時，目前無法正常運作的限制。 使用支援的欄位型別或替代元件設計來避免此行為。

說明 description

環境

Adobe Experience Manager (AEM)通用編輯器/檔案製作（所有版本）

問題/症狀

  • 自訂資產選擇器元件（例如custom-asset-namespace:custom-asset）放在複合多欄位容器（具有multi: true的容器元件）內時，無法如預期運作。

  • 自訂資產選擇器可作為獨立欄位正確運作，但在巢狀內嵌於複合多欄位時無法正確呈現或操作。

  • 可能不會出現任何明確的錯誤訊息，但資產選取範圍和值繫結無法在巢狀內容中如預期運作。

    元件模型定義範例：

    code language-none 
    {
  "component": "container",
  "name": "saleImages",
  "label": "Sale images",
  "multi": true,
  "fields": [
    {
      "component": "text",
      "name": "saleName",
      "label": "Sale name",
      "valueType": "string"
    },
    {
      "component": "custom-asset-namespace:custom-asset",
      "name": "SaleImage",
      "label": "Sale image",
      "description": "This image will be used for any sale that doesn't have a specific image defined.",
      "configUrl": "/content/dam/image.config.json",
      "required": true
    }
  ]
}

解決方法 resolution

  1. 確認只有簡單欄位型別（例如text、reference、aem-content）才正式支援在Universal Editor中搭配multi: true使用。 請參閱通用編輯器欄位型別。 注意：

    • 所有欄位型別的通用編輯器屬性邊欄目前不支援具有valueType: array （複合多欄位）的容器元件。
    • 元件模型檔案將複合多欄位描述為進階模式，不保證與所有自訂或擴充欄位型別的相容性。
    • 監視Universal Editor發行說明和檔案，以便未來支援進階複合欄位模式。

  2. 將可設定的資產選擇器擴充功能作為單一欄位使用（每個欄位一個資產值）。 注意：

    • 此擴充功能的設計和測試是作為單一欄位使用，而非巢狀或重複用於複合多欄位。
    • 目前未實作或記錄對巢狀資料結構（例如saleImages/item0/SaleImage）的支援。

  3. 在記錄正式支援之前，請避免在Universal Editor中的複合多欄位容器內放置自訂資產選擇器欄位。

  4. 如果這項功能很重要，請透過AEM產品意見反應管道提交功能請求。

  5. 由於巢狀欄位處理和擴充功能相容性的限制，Universal Editor目前不支援複合多欄位和自訂資產選取器擴充功能。

相關閱讀

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