Información general sobre los conceptos avanzados de AEM sin encabezado

El siguiente vídeo proporciona información general de alto nivel sobre los conceptos que se tratan en este tutorial. El tutorial incluye la definición de modelos de fragmentos de contenido con tipos de datos más avanzados, el anidamiento de fragmentos de contenido y consultas persistentes de GraphQL en AEM.

ATENCIÓN
En el minuto 2:25 de este vídeo se murstra cómo instalar el editor de consultas de GraphiQL a través del Administrador de paquetes para explorar consultas de GraphQL. Sin embargo, en las versiones más recientes de AEM as a Cloud Service se proporciona un explorador de GraphiQL integrado, por lo que no se requiere la instalación del paquete. Consulte Uso del IDE de GraphQL para obtener más información.

Configuración del proyecto

El proyecto WKND de Sites tiene todas las configuraciones necesarias para iniciar el tutorial después de completar la configuración rápida. En esta sección solo se destacan algunos pasos importantes que puede seguir al crear su propio proyecto de AEM sin encabezado.

Revisar la configuración existente

El primer paso para iniciar cualquier nuevo proyecto en AEM es crear su configuración, como un espacio de trabajo y crear los puntos finales de la API de GraphQL. Para revisar o crear una configuración, vaya a Herramientas > General > Explorador de configuración.

Navegar al explorador de configuración

Observe que la configuración del sitio WKND Shared ya se ha creado para el tutorial. Para crear una configuración para su propio proyecto, seleccione Crear en la esquina superior derecha y complete el formulario en el modal Crear configuración que aparece.

Revisar configuración compartida de WKND

Revisar puntos finales de la API de GraphQL

A continuación, configure los puntos finales de la API a los que enviar las consultas de GraphQL. Para revisar los puntos finales existentes o crear uno, vaya a Herramientas > General > GraphQL.

Configuración de los puntos finales

Observe que WKND Shared Endpoint ya se ha creado. Para crear un punto final para su proyecto, seleccione Crear en la esquina superior derecha y siga el flujo de trabajo.

Revisión del punto final compartido de WKND

NOTA
Después de guardar el punto final, verá un modal sobre la visita a la consola de seguridad, que le permite ajustar la configuración de seguridad si desea configurar el acceso al punto final. Sin embargo, los permisos de seguridad están fuera del ámbito de este tutorial. Para obtener más información, consulte la documentación de AEM.

Revisar la estructura de contenido de WKND y la carpeta raíz del idioma

Una estructura de contenido bien definida es clave para el éxito de la implementación de AEM sin encabezado. Resulta útil para la escalabilidad, la facilidad de uso y la administración de permisos del contenido.

Una carpeta raíz de idioma es una carpeta con un código de idioma ISO como su nombre, como EN o FR. El sistema de administración de traducciones de AEM utiliza estas carpetas para definir el idioma principal del contenido y los idiomas para la traducción de contenido.

Vaya a Navegación > Recursos > Archivos.

Ir a Archivos

Vaya a la carpeta Compartida WKND. Observe la carpeta con el título "English" y el nombre "EN". Esta carpeta es la carpeta raíz de idioma del proyecto del sitio WKND.

Carpeta de inglés

Para su propio proyecto, cree una carpeta raíz de idioma dentro de la configuración. Consulte la sección sobre creación de carpetas para obtener más información.

Asignar una configuración a la carpeta anidada

Finalmente, debe asignar la configuración del proyecto a la carpeta raíz del idioma. Esta asignación permite la creación de fragmentos de contenido basados en los modelos de fragmentos de contenido definidos en la configuración del proyecto.

Para asignar la carpeta raíz de idioma a la configuración, selecciónela y, a continuación, elija Propiedades en la barra de navegación superior.

Seleccione Propiedades

A continuación, vaya a la pestaña Cloud Services y seleccione el icono de la carpeta en el campo Configuración de nube.

Configuración de la nube

En el modal que aparece, seleccione la configuración creada anteriormente para asignarle la carpeta raíz del idioma.

Prácticas recomendadas

Las siguientes son las prácticas recomendadas al crear su propio proyecto en AEM:

  • La jerarquía de carpetas debe modelarse teniendo en cuenta la localización y la traducción. En otras palabras, las carpetas de idioma deben anidarse dentro de las carpetas de configuración, lo que permite traducir fácilmente el contenido dentro de esas carpetas de configuración.
  • La jerarquía de carpetas debe mantenerse plana y directa. Evite mover o cambiar el nombre de carpetas y fragmentos más adelante, especialmente después de publicar para uso activo, ya que cambia las rutas que pueden afectar a las referencias de fragmento y a las consultas de GraphQL.

Paquetes de inicio y solución

Hay dos paquetes de AEM disponibles y se pueden instalar mediante Administrador de paquetes

El proyecto React App - Tutorial avanzado - WKND Adventures está disponible para revisar y explorar la aplicación de ejemplo. Esta aplicación de ejemplo recupera el contenido de AEM invocando las consultas de GraphQL persistentes y lo renderiza en una experiencia envolvente.

Introducción

Para empezar con este tutorial avanzado, siga estos pasos:

  1. Configure un entorno de desarrollo con AEM as a Cloud Service.
  2. Inicie el capítulo del tutorial en Crear modelos de fragmentos de contenido.