Resolução de problemas de acesso e configuração do Universal Editor quando o AEM for a fonte de conteúdo EDS
Quando o Edge Delivery Services (EDS) usa o AEM como fonte de conteúdo, os autores não veem os campos de metadados esperados, os valores de configuração de bloco, as variações de modelo ou os dados JSON dentro do Editor universal. A causa é quase sempre uma incompatibilidade de arquitetura ou configuração: um projeto do EDS é compatível com apenas uma fonte de conteúdo principal, os modelos BYOM (Bring Your Own Model) devem expor metadados explicitamente para o Editor Universal, a população de campos dinâmicos requer uma extensão personalizada do Editor Universal e os dados de configuração ou JSON devem ser intencionalmente expostos por meio do repositório do EDS, do Conteúdo Estruturado ou dos mapeamentos do DAM. A confirmação do modo de criação, a aplicação da regra de origem única e a exposição dos metadados e dados necessários restauram os campos ausentes do editor.
Descrição description
Problema: o Editor universal não exibe metadados, campos de bloco ou dados JSON quando o AEM é a fonte de conteúdo EDS
Descrição
Ao trabalhar com o Edge Delivery Services (EDS) e o Universal Editor (UE), os autores não veem campos de metadados esperados, valores de configuração de bloco, variações de modelo ou dados JSON dentro do editor. As páginas não são carregadas corretamente no UE, ou os autores não podem configurar metadados no nível da página, campos dinâmicos ou opções de bloqueio. Em outros casos, os clientes tentam criar padrões de arquitetura sem suporte — como misturar o Universal Editor e a criação baseada em documentos em um único projeto do EDS ou configurar várias fontes de conteúdo no mesmo fstab.yaml. Esses erros de configuração causam renderização inconsistente, metadados ausentes, incapacidade de usar determinadas interfaces de criação ou blocos que não consomem as entradas necessárias do AEM.
Ambiente:
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- AEM as a Cloud Service — Sites
- Edge Delivery Services (EDS)
- Editor universal
Problema/sintomas:
- O Universal Editor é carregado, mas os campos de metadados ou de configuração de bloco não são exibidos, sem erro.
- Os blocos não são renderizados devido à ausência de metadados de nível de página ou de nível de bloco do BYOM.
- Os autores esperam criação com base em documento e UE em um projeto EDS, mas somente uma fonte é reconhecida.
- O JSON personalizado ou os dados de configuração não estão disponíveis no Editor universal, mesmo que o arquivo exista no DAM ou no GitHub.
- Opções dinâmicas de caixa de diálogo/lista suspensa para blocos que nunca são preenchidos no UE.
Causa raiz:
A EDS e o Editor Universal seguem um modelo arquitetônico rigoroso. Um único projeto do EDS tem apenas uma fonte de conteúdo principal, os modelos do BYOM devem expor explicitamente os metadados ao Universal Editor, a população de campos dinâmicos requer extensões personalizadas do Universal Editor e o JSON ou outros dados de configuração devem ser intencionalmente expostos por meio do repositório do EDS, do Conteúdo Estruturado ou dos mapeamentos do DAM. A configuração incorreta de qualquer uma dessas áreas resulta na ausência de metadados, dados de configuração inacessíveis ou configurações híbridas não compatíveis.
Como confirmar
- Confirme o modo de criação que o projeto usa — Universal Editor, baseado em documento, ou ambos — para estabelecer se o Universal Editor está ativado e deve funcionar para a página em questão. Se não estiver claro, capture o URL exato que está sendo aberto no UE.
- Revise os requisitos do projeto
fstab.yamlou do projeto para confirmar se o projeto EDS usa apenas uma fonte de conteúdo principal e se a instalação tenta misturar fontes do AEM e fontes baseadas em documento em um projeto. - Confirme se os metadados de nível de página necessários para a criação de UE são expostos via BYOM, incluindo um modelo base
page-metadatae quaisquer modelos específicos de modelo. Confirme setemplate= tipo de página está armazenado nos metadados da página, se um modelo for necessário.
Resolução resolution
-
Aplique a regra de conteúdo único-fonte. O EDS oferece suporte a uma fonte de conteúdo principal por projeto. Se o projeto misturar origens, como AEM e criação baseada em documento, crie dois sites EDS separados e use o roteamento CDN para direcionar o tráfego entre eles. A UE híbrida nativa mais a criação baseada em documento em um único repositório não são compatíveis.
-
Expor os metadados necessários para a criação de UE por meio do BYOM. Confirme se um modelo base
page-metadataexiste e defina um modelo de metadados específico de modelo onde necessário. Confirme se as propriedades de página do AEM expõem o valor de metadadostemplateque os blocos esperam. -
Exponha dados de configuração ou JSON personalizados com base no fato de serem editáveis por autor ou estáticos:
- Se os dados forem editáveis pelo autor, use o Conteúdo estruturado do EDS e defina um esquema.
- Se os dados forem estáticos, armazene o JSON no repositório EDS ou no AEM DAM com mapeamentos explícitos.
Confirme se o URL do endpoint resultante pode ser acessado para que UE e os blocos possam buscar os dados.
4. Manipular a lista suspensa dinâmica ou a população de campo corretamente. O EDS não é compatível com as fontes de dados da interface do Granite, portanto, as opções de lista suspensa dinâmica não podem ser carregadas dessa maneira. Em vez disso, use a extensibilidade do Editor universal com campos personalizados e chamadas de API do lado do cliente, o que requer que uma extensão UE seja implementada.
5. Verifique o modelo e bloqueie o comportamento em sites que precisam de vários modelos de página. Marque as páginas relevantes do AEM como Usar como modelo e defina os metadados do modelo (classe CSS) para estilo. Crie uma página com base no modelo e confirme se ela tem o conteúdo inicial e os metadados corretos.
Validação
- Abra a página no Editor universal e confirme se todos os campos de metadados esperados e os campos de configuração de bloco estão visíveis.
- Carregue a página no domínio
.pagee confirme os metadados dinâmicos ou os renderizadores de dados JSON no cabeçalho da página. - Confirmar as chamadas
fetch()para os pontos de extremidade JSON retorna o conteúdo esperado. - Confirme os blocos usando a renderização de configuração dinâmica corretamente após a republicação.