Guide de prise en main pour l’accès et la diffusion de fragments de contenu découplés

Découvrez comment utiliser l’API HTTP Assets d’AEM pour gérer les fragments de contenu et l’API GraphQL dans la diffusion de contenu de fragments de contenu en mode découplé.

Que sont les API GraphQL et REST Assets ?

Maintenant que vous avez créé des fragments de contenu, vous pouvez utiliser les API d’AEM pour une diffusion découplée.

  • L’API GraphQL permet de créer des requêtes d’accès et de diffusion de fragments de contenu.
  • L’API REST Assets permet de créer et de modifier des fragments de contenu (et d’autres ressources).

Le reste de ce guide porte sur l’accès à GraphQL et la diffusion de fragments de contenu.

Comment diffuser un fragment de contenu avec GraphQL

Les architectes de l’information doivent concevoir des requêtes pour leurs points d’entrée de canaux afin de diffuser du contenu. Ces requêtes ne doivent généralement être prises en compte qu’une seule fois par point d’entrée et par modèle. Pour les besoins de ce guide de prise en main, nous ne devrons en créer qu’une.

  1. Connectez-vous à AEM en as a Cloud Service et accédez à l’interface GraphiQL :

    • Par exemple : https://<host>:<port>/content/graphiql.html.
  2. GraphiQL est un éditeur de requêtes intégré au navigateur pour GraphQL. Vous pouvez l’utiliser pour créer des requêtes permettant de récupérer des fragments de contenu afin de les diffuser de manière découplée en mode JSON.

    • Le volet de gauche permet de construire votre requête.
    • Le volet de droite affiche les résultats.
    • L’éditeur de requêtes comprend la saisie du code et des touches d’accès rapide pour exécuter facilement la requête.
      Éditeur GraphiQL
  3. En supposant que le modèle que nous avons créé s’appelle person, avec les champs firstName, lastName et position, nous pouvons créer une requête simple pour récupérer le contenu de notre fragment de contenu.

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Entrez la requête dans le volet de gauche.
    Requête GraphiQL

  5. Cliquez sur le bouton Exécuter la requête ou utilisez le raccourci Ctrl-Enter pour faire apparaître les résultats sous la forme JSON dans le volet de droite.
    Résultats GraphiQL

  6. Cliquez sur le lien Docs en haut à droite de la page pour afficher la documentation contextuelle afin de vous aider à créer vos requêtes adaptées à vos propres modèles.
    Documentation GraphiQL

GraphQL permet d’utiliser des requêtes structurées qui peuvent cibler non seulement des ensembles de données spécifiques ou des objets de données individuels, mais peuvent également fournir des éléments spécifiques des objets, des résultats imbriqués, prend en charge les variables de requête, et bien plus encore.

GraphQL permet d’éviter les requêtes d’API itératives ainsi que la surdiffusion, et permet la diffusion en masse de ce qui est exactement nécessaire pour le rendu en réponse à une requête d’API unique. Le fichier JSON produit peut être utilisé pour diffuser des données vers d’autres sites ou applications.

Étapes suivantes

C’est terminé ! Vous possédez maintenant une compréhension de base de la gestion de contenu découplée dans AEM. Bien entendu, il existe beaucoup d’autres ressources que vous pouvez approfondir pour une compréhension complète des fonctionnalités disponibles.

  • Explorateur de configurations – Pour plus d’informations sur l’Explorateur de configurations AEM
  • Fragments de contenu – Pour plus d’informations sur la création et la gestion de fragments de contenu
  • Prise en charge des fragments de contenu dans l’API HTTP AEM Assets – Pour plus d’informations sur l’accès direct au contenu AEM via l’API HTTP, via des opérations CRUD (création, lecture, mise à jour, suppression)
  • API GraphQL – Pour plus d’informations sur la diffusion découplée de fragments de contenu

Sur cette page