Création d’une requête API - Configuration découplée accessing-delivering-content-fragments
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 ? what-are-the-apis
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. Cette API offre l’ensemble de fonctionnalités le plus robuste pour interroger et utiliser du contenu de fragment de contenu.
- Pour utiliser l’API, définissez et activez des points d’entrée dans AEM, et si nécessaire, l’interface GraphiQL installée.
- 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.
Activation du point d’entrée GraphQL enable-graphql-endpoint
Avant de pouvoir utiliser les API GraphQL, un point d’entrée GraphQL doit être créé.
-
Accédez à Outils, Général, puis sélectionnez GraphQL.
-
Sélectionnez Créer.
-
La boîte de dialogue Créer un point d’entrée 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.
-
Confirmez en sélectionnant Créer.
-
Dans la console, un Chemin d’accès s’affiche désormais en fonction de la configuration créée précédemment. Ce chemin d’accès est utilisé pour exécuter des requêtes GraphQL.
code language-none /content/cq:graphql/<configuration-name>/endpoint
Pour plus d’informations sur l’activation des points de fin GraphQL, voir Gestion des points de fin GraphQL dans AEM.
Requête de contenu à l’aide de GraphQL avec GraphiQL
Les architectes d’informations créent des requêtes pour leurs points d’entrée de canal afin de diffuser du contenu. Considérez ces requêtes une seule fois par point d’entrée et par modèle. Pour les besoins de ce guide de prise en main, il suffit d’en créer une.
GraphiQL est un IDE inclus dans votre environnement AEM ; il est accessible/visible après la configuration des points d’entrée.
-
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
-
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.
-
En supposant que le modèle que vous avez créé s’appelle
person
, avec les champsfirstName
,lastName
etposition
, vous pouvez créer une requête simple pour récupérer le contenu du fragment de contenu.code language-text query { personList { items { _path firstName lastName position } } }
-
Entrez la requête dans le volet de gauche.
-
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.
-
Dans le coin supérieur droit de la page, cliquez sur le lien Documents pour afficher la documentation contextuelle afin que vous puissiez créer des requêtes qui s’adaptent à vos propres modèles.
GraphQL permet d’utiliser des requêtes structurées qui peuvent cibler non seulement des jeux de données spécifiques ou des objets de données particuliers, mais peuvent également fournir des éléments spécifiques d’objets, des résultats imbriqués, prendre en charge des variables de requête, etc.
GraphQL permet d’éviter les requêtes d’API itératives ainsi que la surdiffusion, et permet au contraire la diffusion en masse de ce qui est nécessaire au 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 next-steps
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.
- 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