Création d’une requête API - Configuration découplée

Découvrez comment utiliser l’API GraphQL pour une diffusion découplée du contenu du fragment de contenu et l’API REST AEM Assets pour gérer les fragments de contenu.

En quoi consistent les API REST GraphQL et Assets ?

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

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

Activation du point d’entrée GraphQL

Avant de pouvoir utiliser les API GraphQL, un point d’entrée GraphQL doit être créé.

  1. Accédez à Outils, Général, puis sélectionnez GraphQL.

  2. Sélectionnez Créer.

  3. La variable Créer un point de terminaison GraphQL s’ouvre. Vous pouvez spécifier ici les éléments suivants :

    • Nom : nom du point d’entrée ; vous pouvez saisir du texte.
    • Utiliser le schéma GraphQL fourni par : utilisez la liste déroulante pour sélectionner la configuration requise.
  4. Confirmez avec Créer.

  5. Dans la console, une Chemin s’affiche en fonction de la configuration créée précédemment. Ce chemin est utilisé pour exécuter des requêtes GraphQL.

    /content/cq:graphql/<configuration-name>/endpoint
    

Plus d’informations sur l’activation des points d’entrée GraphQL se trouvent ici.

Requête de contenu à l’aide de GraphQL avec GraphiQL

Les architectes d’informations créent des requêtes pour leurs points de terminaison de canal afin de diffuser du contenu. Considérez ces requêtes une seule fois par point de terminaison, par modèle. Pour les besoins de ce guide de prise en main, vous ne devez en créer qu’un seul.

GraphiQL est un IDE inclus dans votre environnement AEM ; il est accessible/visible après la configuration des points d’entrée.

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

    Vous pouvez accéder à l’éditeur de requêtes à partir de :

    • Outils -> Général -> Éditeur de requêtes GraphQL
    • directement ; par exemple, http://localhost:4502/aem/graphiql.html
  2. L’IDE 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.

    • La liste déroulante en haut à droite vous permet de sélectionner le point de terminaison.
    • Un panneau de gauche répertorie les requêtes persistantes (le cas échéant).
    • Le panneau du milieu à gauche vous permet de créer votre requête.
    • Le volet au milieu à 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 vous avez créé ait été appelé person avec des champs firstName, lastName, et position, vous pouvez créer une requête simple pour récupérer le contenu du 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. Dans le coin supérieur droit de la page, cliquez sur le bouton Documents lien pour afficher la documentation contextuelle afin que vous puissiez créer vos requêtes qui s’adaptent à vos propres modèles.
    Documentation GraphiQL

GraphQL active des requêtes structurées qui peuvent cibler non seulement des jeux de données spécifiques ou des objets de données individuels, mais aussi fournir des éléments spécifiques des objets, des résultats imbriqués, offrir une prise en charge des variables de requête, et bien plus encore.

GraphQL peut éviter les requêtes d’API itératives et la sur-diffusion, et permet à la place la diffusion en masse de ce qui est exactement nécessaire pour le rendu en tant que 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. Il existe de nombreuses autres ressources où vous pouvez approfondir vos connaissances pour une compréhension complète des fonctionnalités disponibles.

Sur cette page