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.
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.
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 :
Confirmez avec Créer.
Dans la console, un Chemin d’accès s’affiche désormais en fonction de la configuration créée précédemment. Il s’agit du chemin d’accès 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.
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.
GraphiQL est un IDE inclus dans votre environnement AEM ; il est accessible/visible après que vous configuration des points de fin.
Connectez-vous à AEM en as a Cloud Service et accédez à l’interface GraphiQL :
Vous pouvez accéder à l’éditeur de requêtes à partir de :
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 afin de récupérer des fragments de contenu afin de les diffuser sans affichage au format JSON.
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
}
}
}
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.
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.
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.
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.