Modelado de contenido
- Se aplica a:
- Experience Manager as a Cloud Service
- Temas:
- Fragmentos de contenido
Creado para:
- Intermedio
- Desarrollador
Le damos la bienvenida al capítulo del tutorial sobre fragmentos de contenido y puntos finales de GraphQL en Adobe Experience Manager (AEM). Explicaremos el uso de los fragmentos de contenido, la creación de modelos de fragmentos y el uso de puntos de conexión de GraphQL en AEM.
Los fragmentos de contenido ofrecen un enfoque estructurado para administrar el contenido en varios canales, lo que proporciona flexibilidad y reutilización. Al habilitar los fragmentos de contenido en AEM, se puede crear contenido modular, mejorar la coherencia y la adaptabilidad.
En primer lugar, le guiaremos a través de la activación de los fragmentos de contenido en AEM, que cubren las configuraciones y ajustes necesarios para una integración perfecta.
A continuación, se explica la creación de modelos de fragmento, que definen la estructura y los atributos. Aprenda a diseñar modelos alineados con los requisitos de contenido y a administrarlos de forma eficaz.
A continuación, se mostrará la creación de fragmentos de contenido a partir de los modelos, con instrucciones paso a paso para la creación y publicación.
Además, exploraremos la definición de puntos finales de AEM GraphQL. GraphQL recupera datos de AEM de forma eficaz y configuraremos los puntos de conexión para exponer los datos deseados. Las consultas persistentes optimizarán el rendimiento y el almacenamiento en caché.
A lo largo del tutorial, proporcionaremos explicaciones, ejemplos de código y sugerencias prácticas. Al final, tendrá las habilidades para habilitar fragmentos de contenido, crear modelos de fragmentos, generar fragmentos y definir puntos finales y consultas persistentes de AEM GraphQL. ¡Vamos a empezar!
Configuración según el contexto
-
Vaya a Herramientas > Explorador de configuración para crear una configuración para la experiencia sin encabezado.
Proporcione un título y nombre, y compruebe Consultas persistentes de GraphQL y Modelos de fragmentos de contenido.
Modelos de fragmento de contenido
-
Vaya a Herramientas > Modelos de fragmento de contenido y seleccione la carpeta con el nombre de la configuración creada en el paso 1.
-
Dentro de la carpeta, seleccione Crear y asigne un nombre al modelo Teaser. Agregue los siguientes tipos de datos al modelo Teaser.
Tipo de datosNombreRequeridoOpcionesReferencia de contenidoRecursosíSi lo desea, añada una imagen predeterminada. Ejemplo: /content/dam/wknd-headless/assets/AdobeStock_307513975.mp4Texto de línea únicaTítulosíTexto de línea únicaPre-TitlenoTexto multilíneaDescripciónnoAsegúrese de que el tipo predeterminado sea texto enriquecidoLista desglosadaEstilosíProcesar como menú desplegable. Las opciones son Hero -> Hero y Destacado -> destacado -
Dentro de la carpeta, cree un segundo modelo llamado Oferta. Haga clic en Crear y asigne al modelo el nombre "Oferta" y añada los siguientes tipos de datos:
Tipo de datosNombreRequeridoOpcionesReferencia de contenidoRecursosíAgregar imagen predeterminada. Ejemplo:/content/dam/wknd-headless/assets/AdobeStock_238607111.jpeg
Texto multilíneaDescripciónnoTexto multilíneaArtículono -
Dentro de la carpeta, cree un tercer modelo denominado Lista de imágenes. Haga clic en Crear y asigne al modelo el nombre "Lista de imágenes" y añada los siguientes tipos de datos:
Tipo de datosNombreRequeridoOpcionesReferencia al fragmentoElementos de la listasíProcesar como campo múltiple. El modelo de fragmento de contenido permitido es Oferta.
Fragmentos de contenido
-
Ahora, vaya a Assets y cree una carpeta para el nuevo sitio. Haga clic en crear y asigne un nombre a la carpeta.
-
Una vez creada la carpeta, selecciónela y abra sus Propiedades.
-
En la ficha Configuraciones en la nube de la carpeta, seleccione la configuración creada anteriormente.
Haga clic en la carpeta nueva y cree un teaser. Haga clic en Crear y en Fragmento de contenido y seleccione el modelo Teaser. Asigne un nombre al modelo Hero y haga clic en Crear.
NombreNotasRecursoDeje como valor predeterminado o elija un recurso diferente (vídeo o imagen)TítuloExplore. Discover. Live.
Pre-TitleJoin use for your next adventure.
DescripciónDejar en blancoEstiloHero
Extremos de GraphQL
-
Vaya a Herramientas > GraphQL
-
Haga clic en Crear, asigne un nombre al nuevo extremo y elija la configuración recién creada.
Consultas persistentes de GraphQL
-
Vamos a probar el nuevo punto final. Vaya a Herramientas > Editor de consultas de GraphQL y elija el punto final en la lista desplegable de la parte superior derecha de la ventana.
-
En el editor de consultas, cree algunas consultas diferentes.
{ teaserList { items { title } } }
Debe obtener una lista que contenga el fragmento único creado arriba.
Para este ejercicio, cree una consulta completa que utilice la aplicación sin encabezado de AEM. Cree una consulta que devuelva un solo teaser por ruta. En el editor de consultas, introduzca la siguiente consulta:
query TeaserByPath($path: String!) { component: teaserByPath(_path: $path) { item { __typename _path _metadata { stringMetadata { name value } } title preTitle style asset { ... on MultimediaRef { __typename _authorUrl _publishUrl format } ... on ImageRef { __typename _authorUrl _publishUrl mimeType width height } } description { html plaintext } } } }
En la entrada variables de consulta de la parte inferior, escriba:
{ "path": "/content/dam/pure-headless/hero" }
NOTE
Es posible que necesite ajustar la variable de consultapath
en función de los nombres de carpeta y fragmento.Ejecute la consulta para recibir los resultados del fragmento de contenido creado anteriormente.
-
Haga clic en Guardar para mantener (guardar) la consulta y asigne un nombre a la consulta teaser. Esto nos permite hacer referencia a la consulta por su nombre en la aplicación.
Pasos siguientes
¡Enhorabuena! Ha configurado correctamente AEM as a Cloud Service para permitir la creación de fragmentos de contenido y extremos de GraphQL. También ha creado un modelo de fragmento de contenido y un fragmento de contenido, y ha definido un punto final de GraphQL y una consulta persistente. Ya está listo para pasar al siguiente capítulo del tutorial, donde aprenderá a crear una aplicación React de AEM sin encabezado que consuma los fragmentos de contenido y el extremo de GraphQL que ha creado en este capítulo.