DocumentaçãoKCS da Experience Cloud

O seletor de ativos personalizado não é compatível com vários campos compostos no AEM Universal Editor

Última atualização: 1 de agosto de 2026

Este artigo explica a limitação atual, em que um campo do seletor de ativos personalizado não funciona corretamente quando usado em um container composto de vários campos no Editor universal do Adobe Experience Manager (AEM). Use tipos de campo compatíveis ou designs de componente alternativos para evitar esse comportamento.

Descrição description

Ambiente

Editor universal do Adobe Experience Manager (AEM) / Criação de documento (todas as versões)

Problema/Sintomas

  • Um componente seletor de ativos personalizado (por exemplo, custom-asset-namespace:custom-asset) não funciona como esperado quando colocado dentro de um contêiner de vários campos composto (um componente de contêiner com multi: true).

  • O seletor de ativos personalizado funciona corretamente como um campo independente, mas falha ao renderizar ou operar corretamente quando aninhado em um multicampo composto.

  • Nenhuma mensagem de erro explícita pode ser exibida, mas a seleção de ativos e a vinculação de valores não funcionam como esperado no contexto aninhado.

    Exemplo de definição de modelo de componente:

    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
    }
  ]
}

Resolução resolution

  1. Confirme se apenas tipos de campos simples (como text, reference, aem-content) são oficialmente suportados para uso com multi: true no Universal Editor. Consulte Tipos de campo do Editor Universal. Observação:

    • Componentes de contêiner com valueType: array (vários campos compostos) não têm suporte atualmente no painel de propriedades do Editor Universal para todos os tipos de campo.
    • A documentação do modelo de componente descreve vários campos compostos como um padrão avançado e não garante compatibilidade com todos os tipos de campos personalizados ou de extensão.
    • Monitorar notas de versão e documentação do Universal Editor para suporte futuro de padrões de campo composto avançados.

  2. Use a extensão do seletor de ativos configurável como um único campo (um valor de ativo por campo). Observação:

    • A extensão foi projetada e testada para uso como um único campo, não para uso aninhado ou repetido em vários campos compostos.
    • O suporte para estruturas de dados aninhadas, como saleImages/item0/SaleImage, não está implementado ou documentado no momento.

  3. Evite colocar campos personalizados do seletor de ativos dentro de contêineres de vários campos compostos no Universal Editor até que o suporte oficial seja documentado.

  4. Se essa funcionalidade for crítica, envie uma solicitação de recursos por meio dos canais de feedback de produtos da AEM.

  5. Atualmente, os campos compostos e as extensões personalizadas do seletor de ativos não são compatíveis juntos no Universal Editor devido a limitações no manuseio de campos aninhados e na compatibilidade de extensões.

Leitura relacionada

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