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.
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.
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.
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.
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.
A continuación, vaya a la pestaña Cloud Services y seleccione el icono de la carpeta en el campo Configuración de 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
- Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip se usa más adelante en el tutorial y contiene carpetas e imágenes de ejemplo.
- Advanced-GraphQL-Tutorial-Solution-Package-1.2.zip contiene la solución finalizada para los capítulos 1-4, incluidos los nuevos modelos de fragmentos de contenido, los fragmentos de contenido y las consultas de GraphQL persistentes. Útil para aquellos que desean saltar directamente al capítulo Integración de aplicaciones cliente.
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:
- Configure un entorno de desarrollo con AEM as a Cloud Service.
- Inicie el capítulo del tutorial en Crear modelos de fragmentos de contenido.