Acceso y entrega de fragmentos de contenido Guía de inicio rápido sin encabezado

Aprenda a utilizar AEM API de REST de Assets para administrar fragmentos de contenido y la API de GraphQL para ofrecer contenido sin encabezado de fragmentos de contenido.

¿Qué son las API de REST de GraphQL y Assets?

Ahora que ha creado algunos fragmentos de contenido, puede utilizar API AEM para entregarlos sin problemas.

  • La API de GraphQL permite crear solicitudes para acceder a los fragmentos de contenido y enviarlos.
  • La API de REST de recursos permite crear y modificar fragmentos de contenido (y otros recursos).

El resto de esta guía se centrará en el acceso a GraphQL y la entrega de fragmentos de contenido.

Cómo entregar un fragmento de contenido mediante GraphQL

Los arquitectos de la información deberán diseñar consultas para sus extremos de canal para poder entregar contenido. Por lo general, estas consultas solo tendrán que considerarse una vez por punto final por modelo. Para los fines de esta guía de introducción solo tendremos que crear una.

  1. Inicie sesión en AEM como Cloud Service y acceda a la interfaz de GraphiQL:

    • Por ejemplo: https://<host>:<port>/content/graphiql.html.
  2. GraphiQL es un editor de consultas en el navegador para GraphQL. Puede utilizarla para crear consultas para recuperar fragmentos de contenido y entregarlos en encabezado como JSON.

    • El panel izquierdo le permite crear la consulta.

    • El panel derecho muestra los resultados.

    • El editor de consultas incluye la finalización del código y teclas de acceso directo para ejecutar fácilmente la consulta.

      Editor de GraphiQL

  3. Suponiendo que el modelo que creamos se llamó person con los campos firstName, lastName y position, podemos crear una consulta simple para recuperar el contenido de nuestro fragmento de contenido.

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Introduzca la consulta en el panel izquierdo.
    Consulta de GraphiQL

  5. Haga clic en el botón Execute Query o utilice la tecla de acceso directo Ctrl-Enter y los resultados se muestran como JSON en el panel derecho.
    Resultados de GraphiQL

  6. Haga clic en el enlace Docs en la parte superior derecha de la página para mostrar la documentación en contexto para ayudarle a crear sus consultas que se adapten a sus propios modelos.
    Documentación de GraphiQL

GraphQL permite consultas estructuradas que pueden dirigirse no solo a conjuntos de datos específicos u objetos de datos individuales, sino que también pueden proporcionar elementos específicos de los objetos, resultados anidados, ofrece compatibilidad con variables de consulta y mucho más.

GraphQL puede evitar solicitudes de API iterativas, así como envíos excesivos, y en su lugar permite realizar envíos masivos de exactamente lo que se necesita para procesar como respuesta a una única consulta de API. El JSON resultante se puede utilizar para enviar datos a otros sitios o aplicaciones.

Pasos siguientes

¡Eso es todo! Ahora tiene una comprensión básica de la administración de contenido sin encabezado en AEM. Por supuesto, hay muchos más recursos en los que puede profundizar para comprender las funciones disponibles.

  • Navegador de configuración : para obtener más información sobre el Explorador de configuración de AEM
  • Fragmentos de contenido : para obtener detalles sobre cómo crear y administrar fragmentos de contenido
  • Compatibilidad con fragmentos de contenido en la API HTTP de AEM Assets : para obtener más información sobre el acceso a AEM contenido directamente a través de la API HTTP, a través de operaciones CRUD (Crear, Leer, Actualizar, Eliminar)
  • API de GraphQL : para obtener detalles sobre cómo enviar fragmentos de contenido sin encabezado

En esta página