Diffusion de contenu découplée à l’aide de fragments de contenu avec GraphQL

Avec les fragments de contenu et l’API GraphQL, vous pouvez utiliser Adobe Experience Manager (AEM) as a Cloud Service en tant que système de gestion de contenu (CMS) découplé.

Les fragments de contenu d’AEM peuvent être utilisées conjointement avec l’API AEM GraphQL (une implémentation personnalisée, basée sur GraphQL standard), pour fournir du contenu découplé structuré à utiliser dans vos applications. La possibilité de personnaliser une seule requête API vous permet de récupérer et de diffuser le contenu spécifique que vous souhaitez/devez rendre (en tant que réponse à la requête API unique).

CMS découplé

Un système de gestion de contenu découplé, ou CMS découplé, est un système de gestion de contenu (CMS) back-end uniquement créé dès le départ comme un référentiel de contenu qui rend le contenu accessible via une API pour l’afficher sur n’importe quel appareil.

En termes de création de fragments de contenu dans AEM, cela signifie que :

• Vous pouvez utiliser des fragments de contenu pour créer du contenu qui n’est pas principalement destiné à être publié directement (1:1) sur des pages formatées.

• Le contenu de vos fragments de contenu est structuré d’une manière prédéterminée, selon les modèles de fragments de contenu. Cela simplifie l’accès à vos applications qui poursuivront le traitement de votre contenu.

GraphQL – Présentation

GraphQL est :

• « …un langage de requête pour les API et un environnement d’exécution pour répondre à ces requêtes avec vos données existantes ».

  Voir GraphQL.org

La variable API GRAPHQL AEM vous permet d’effectuer des requêtes (complexes) sur votre Fragments de contenu; chaque requête étant en fonction d’un type de modèle spécifique. Le contenu renvoyé peut alors être utilisé par vos applications.

API AEM GraphQL

Une implémentation personnalisée de l’API GraphQL standard a été développée pour Adobe Experience as a Cloud Experience. Consultez API AEM GraphQL à utiliser avec des fragments de contenu pour plus d’informations.

L’implémentation de l’API AEM GraphQL repose sur les bibliothèques Java GraphQL.

Fragments de contenu à utiliser avec l’API AEM GraphQL

Les fragments de contenu peuvent servir de base à GraphQL pour les requêtes AEM car :

• Ils permettent de concevoir, créer, traiter et publier du contenu indépendant des pages.
• Les modèles de fragments de contenu fournissent la structure requise au moyen de types de données définis.
• La Référence du fragment, disponible lors de la définition d’un modèle, peut être utilisée pour définir des couches supplémentaires de structure.

Fragments de contenu

Les fragments de contenu :

• contiennent du contenu structuré ;

• reposent sur un modèle de fragment de contenu, qui prédéfinit la structure pour le fragment résultant.

Modèles de fragment de contenu

Ces modèles de fragment de contenu :

• Sont utilisés pour générer les Schémas, une fois Activés.

• fournissent les types de données et les champs requis pour GraphQL ; garantissent que votre application ne demande que ce qui est possible et reçoive ce qui est attendu.

• Le type de données Références de fragments peut être utilisé dans votre modèle pour faire référence à un autre fragment de contenu et introduit ainsi des niveaux de structure supplémentaires.

Références à un fragment

La référence à un fragment :

• est particulièrement intéressante en lien avec GraphQL ;

• est un type de données spécifique qui peut être utilisé lors de la définition d’un modèle de fragment de contenu ;

• fait référence à un autre fragment, en fonction d’un modèle de fragment de contenu spécifique ;

• Permet de récupérer des données structurées.

  • Lorsqu’elle est définie comme référence à sources multiples, plusieurs sous-fragments peuvent être référencés (récupérés) par le fragment principal.

Prévisualisation JSON

Pour faciliter la conception et le développement de vos modèles de fragments de contenu, vous pouvez prévisualiser la sortie JSON.

Apprendre à utiliser GraphQL avec AEM – Exemple de contenu et de requêtes

Voir Utilisation de GraphQL avec AEM – Exemple de contenu et de requêtes pour une présentation de l’utilisation de l’API AEM GraphQL.

Tutoriel – Prise en main d’AEM découplé et de GraphQL

Vous cherchez un tutoriel pratique ? Consultez le tutoriel complet Prise en main d’AEM Headless et de GraphQL illustrant comment créer et exposer du contenu à l’aide des API GraphQL d’AEM et consommé par une application externe, dans un scénario CMS découplé.