Resolución de problemas de acceso y configuración del Editor universal cuando AEM es la fuente de contenido EDS
Cuando Edge Delivery Services (EDS) utiliza AEM como fuente de contenido, los autores no ven los campos de metadatos esperados, los valores de configuración de bloque, las variaciones de plantillas o los datos JSON dentro del editor universal. La causa es casi siempre una discrepancia de arquitectura o configuración: un proyecto EDS solo admite una fuente de contenido principal, los modelos BYOM (Traer su propio modelo) deben exponer explícitamente los metadatos al editor universal, la población de campos dinámicos requiere una extensión del editor universal personalizada y los datos de JSON o configuración deben exponerse intencionalmente a través del repositorio EDS, el contenido estructurado o las asignaciones DAM. Al confirmar el modo de creación, aplicar la regla de un solo origen y exponer los metadatos y datos necesarios, se restauran los campos de editor que faltan.
Descripción description
Problema: el editor universal no muestra metadatos, campos de bloque o datos JSON cuando AEM es la fuente de contenido EDS
Descripción
Al trabajar con Edge Delivery Services (EDS) y el editor universal (UE), los autores no ven los campos de metadatos esperados, los valores de configuración de bloque, las variaciones de plantillas ni los datos JSON dentro del editor. Las páginas no se cargan correctamente en la UE o los autores no pueden configurar metadatos de nivel de página, campos dinámicos u opciones de bloque. En otros casos, los clientes intentan patrones arquitectónicos no compatibles, como mezclar el Editor universal y la creación basada en documentos dentro de un único proyecto EDS, o configurar varios orígenes de contenido dentro del mismo fstab.yaml. Estas configuraciones incorrectas provocan una representación incoherente, la falta de metadatos, la incapacidad para utilizar determinadas interfaces de creación o bloques que no consumen las entradas necesarias de AEM.
Entorno:
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- AEM as a Cloud Service - Sitios
- Edge Delivery Services (EDS)
- Editor universal
Problema/Síntomas:
- El Editor universal se carga, pero no aparecen los campos de metadatos ni los campos de configuración de bloque, y no se muestra ningún error.
- Los bloques no se pueden procesar debido a la falta de metadatos de nivel de página o de nivel de bloque de BYOM.
- Los autores esperan la creación basada en documentos y la creación de UE en un proyecto EDS, pero solo se reconoce una fuente.
- El JSON personalizado o los datos de configuración no están disponibles dentro del editor universal, aunque el archivo exista en DAM o GitHub.
- Las opciones desplegables/de diálogo dinámico para bloques nunca se rellenan en la UE.
Causa principal:
EDS y el editor universal siguen un modelo arquitectónico estricto. Un solo proyecto EDS tiene una sola fuente de contenido principal, los modelos BYOM deben exponer explícitamente los metadatos al editor universal, la población de campos dinámicos requiere extensiones de editor universal personalizadas y los datos JSON u otros datos de configuración deben exponerse intencionalmente a través del repositorio EDS, el contenido estructurado o las asignaciones DAM. La configuración incorrecta de cualquiera de estas áreas provoca la falta de metadatos, datos de configuración inaccesibles o configuraciones híbridas no admitidas.
Cómo confirmar
- Confirme el modo de creación que utiliza el proyecto (editor universal, basado en documentos o ambos) para establecer si el editor universal está habilitado y si se espera que funcione para la página en cuestión. Si no está claro, capture la dirección URL exacta que se está abriendo en la UE.
- Revise los
fstab.yamlo los requisitos del proyecto para confirmar que el proyecto EDS utiliza solo un origen de contenido principal y si la configuración intenta combinar orígenes basados en documentos y AEM en un proyecto. - Confirme si los metadatos de nivel de página necesarios para la creación de UE se exponen mediante BYOM, incluido un modelo base
page-metadatay cualquier modelo específico de plantilla. Confirme quetemplate= tipo de página se almacena en los metadatos de la página si se requiere una plantilla.
Resolución resolution
-
Aplicar la regla de fuente de contenido único. EDS admite una fuente de contenido principal por proyecto. Si el proyecto combina fuentes, como AEM y la creación basada en documentos, cree dos sitios EDS independientes y utilice el enrutamiento CDN para dirigir el tráfico entre ellos. La UE híbrida nativa más la creación basada en documentos en un único repositorio no es compatible.
-
Exponga los metadatos necesarios para la creación de UE mediante BYOM. Confirme que existe un modelo base
page-metadatay defina un modelo de metadatos específico de la plantilla donde sea necesario. Confirmar las propiedades de la página de AEM expone el valor de metadatostemplateque esperan los bloques. -
Exponga datos JSON o de configuración personalizados en función de si son editables por el autor o estáticos:
- Si los datos son editables por el autor, utilice Contenido estructurado EDS y defina un esquema.
- Si los datos son estáticos, almacene el JSON en el repositorio EDS o en AEM DAM con asignaciones explícitas.
Confirme que la URL del extremo resultante es accesible para que UE y los bloques puedan recuperar los datos.
4. Gestionar correctamente la lista desplegable dinámica o la población de campos. EDS no es compatible con las fuentes de datos de la interfaz de usuario de Granite, por lo que las opciones desplegables dinámicas no se pueden cargar de esa manera. En su lugar, utilice la extensibilidad del Editor universal con campos personalizados y llamadas a la API del lado del cliente, lo que requiere que se implemente una extensión UE.
5. Compruebe el comportamiento de las plantillas y los bloques en los sitios que necesitan varias plantillas de página. Marque las páginas relevantes de AEM como Usar como plantilla y establezca los metadatos de la plantilla (clase CSS) para el estilo. Cree una página a partir de la plantilla y confirme que lleva el contenido inicial y los metadatos correctos.
Validación
- Abra la página en el editor universal y confirme que todos los campos de metadatos esperados y los campos de configuración de bloque están visibles.
- Cargue la página en el dominio
.pagey confirme los metadatos dinámicos o los procesamientos de datos JSON en el encabezado de la página. - Confirmar
fetch()llamadas a puntos de conexión JSON devuelve el contenido esperado. - Confirme los bloques utilizando la configuración dinámica para que se representen correctamente después de volver a publicar.