文档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）在通用编辑器中与multi: true一起使用。 请参阅通用编辑器字段类型。 注意：

    • 所有字段类型的通用编辑器属性边栏当前不支持具有valueType: array的容器组件（复合多字段）。
    • 组件模型文档将复合多字段描述为高级模式，并且不保证与所有自定义或扩展字段类型的兼容性。
    • 监控通用编辑器发行说明和文档，以便未来支持高级复合字段模式。

  2. 将可配置的资产选取器扩展用作单个字段（每个字段一个资产值）。 注意：

    • 设计和测试该扩展时仅用作单个字段，而不用于在复合多字段内嵌套或重复使用。
    • 当前未实现或未记录对嵌套数据结构（如saleImages/item0/SaleImage）的支持。

  3. 在记录官方支持之前，请避免在Universal Editor中的复合多字段容器中放置自定义资产选取器字段。

  4. 如果此功能至关重要，请通过AEM产品反馈渠道提交功能请求。

  5. 由于嵌套字段处理和扩展兼容性的限制，当前在通用编辑器中不支持同时使用复合多字段和自定义资产选取器扩展。

相关阅读

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