Envío de contenido sin cabeza mediante fragmentos de contenido con GraphQL

Con Adobe Experience Manager (AEM) como Cloud Service, puede utilizar Fragmentos de contenido, junto con la API de GraphQL de AEM (una implementación personalizada, basada en GraphQL estándar), para ofrecer contenido estructurado para su uso en las aplicaciones.

CMS sin cabeza

Un sistema de Gestor de contenido sin cabeza (CMS) es:

• "Un sistema de gestor de contenido sin cabezales, o CMS sin cabezal, es un sistema de gestor de contenido solo de back-end (CMS) creado desde cero como un repositorio de contenido que hace que el contenido sea accesible a través de una API para su visualización en cualquier dispositivo.

  El término "sin cabeza" proviene del concepto de cortar la "cabeza" (el front-end, es decir, el sitio web) del "cuerpo" (el back-end, es decir, el repositorio de contenido)."

  Consulte Wikipedia.

En cuanto a la creación de fragmentos de contenido en AEM, esto significa que:

• Puede utilizar Fragmentos de contenido para crear contenido que no se vaya a publicar directamente (1:1) en páginas con formato.

• El contenido de los fragmentos de contenido se estructurará de una manera predeterminada, según los modelos de fragmento de contenido. Esto simplifica el acceso para las aplicaciones, lo que permitirá procesar aún más el contenido.

GraphQL: Información general

GraphQL es:

• "…un lenguaje de consulta para las API y un tiempo de ejecución para cumplir esas consultas con los datos existentes. GraphQL proporciona una descripción completa y comprensible de los datos de su API, brinda a los clientes la capacidad de preguntar exactamente lo que necesitan y nada más, facilita la evolución de las API con el tiempo y permite herramientas potentes para desarrolladores.".

  Consulte GraphQL.org

• "…una especificación abierta para una capa de API flexible. Coloque GraphQL sobre los servidores de fondo existentes para crear productos más rápido que nunca…".

  Consulte Explorar GraphQL. "Explore GraphQL es mantenido por el equipo de Apollo. Nuestro objetivo es dar a los desarrolladores y líderes técnicos de todo el mundo todas las herramientas que necesitan para entender y adoptar GraphQL.".

La API de GraphQL de AEM le permite realizar consultas (complejas) en sus fragmentos de contenido; con cada consulta en función de un tipo de modelo específico. El contenido devuelto puede ser utilizado por las aplicaciones.

Terminología de GraphQL

GraphQL utiliza lo siguiente:

• Consultas

• Esquemas y tipos : mediante estos, GraphQL presenta los tipos y operaciones permitidos para la implementación de GraphQL en AEM.

• Campos

• Extremo de GraphQL: la ruta de AEM que responde a consultas de GraphQL y proporciona acceso a los esquemas de GraphQL.

Consulte la (GraphQL.org) Introducción a GraphQL para obtener información detallada, incluidas las optimizaciones.

Tipos de Consulta de GraphQL

Con GraphQL puede realizar consultas para:

• Entrada única

• Lista de entradas

API de AEM GraphQL

Para Adobe Experience as a Cloud Experience, se ha implementado una implementación personalizada de la API GraphQL estándar.

La implementación de la API de AEM GraphQL se basa en las bibliotecas Java de GraphQL.

Fragmentos de contenido para usar con la API de AEM GraphQL

Los fragmentos de contenido se pueden usar como base para GraphQL en consultas de AEM como:

• Permiten diseñar, crear, depurar y publicar contenido independiente de las páginas.
• Los Modelos de fragmento de contenido proporcionan la estructura requerida mediante tipos de datos definidos.
• La Referencia de fragmento, disponible al definir un modelo, puede utilizarse para definir capas adicionales de estructura.

Fragmentos de contenido

Fragmentos de contenido:

• Contiene contenido estructurado.

• Se basan en un Modelo de fragmento de contenido, que predefine la estructura del fragmento resultante.

Modelos de fragmento de contenido

Estos Modelos de fragmento de contenido:

• Proporcione los tipos de datos y los campos requeridos para GraphQL. Garantizan que la aplicación sólo solicite lo posible y recibe lo que se espera.

• El tipo de datos Referencias de fragmento se puede usar en el modelo para hacer referencia a otro fragmento de contenido y, por lo tanto, introducir niveles adicionales de estructura.

Referencias de fragmento

La Referencia de fragmento:

• Es de particular interés en conjunto con GraphQL.

• Es un tipo de datos específico que se puede utilizar al definir un modelo de fragmento de contenido.

• Hace referencia a otro fragmento, según un modelo de fragmento de contenido específico.

• Permite recuperar datos estructurados.

  • Cuando se define como una fuente múltiple, el fragmento principal puede hacer referencia (recuperar) a varios subfragmentos.

Previsualización JSON

Para ayudarle a diseñar y desarrollar el modelo de fragmento de contenido, puede realizar la previsualización salida de JSON.

Aprender a usar GraphQL con AEM: Contenido de muestra y Consultas

Consulte Aprendizaje de utilizar GraphQL con AEM: Contenido de muestra y Consultas para obtener una introducción al uso de la API de GraphQL de AEM.

Tutorial: Introducción a AEM sin encabezado y GraphQL

¿Busca un tutorial práctico? Consulte Introducción a AEM sin encabezado y GraphQL tutorial completo que ilustra cómo crear y exponer contenido mediante las API de GraphQL de AEM y consumido por una aplicación externa, en un escenario CMS sin encabezado.