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

Avec Adobe Experience Manager (AEM) as a Cloud Service, vous pouvez utiliser des fragments de contenu avec l’API AEM GraphQL (une implémentation personnalisée, basée sur GraphQL standard) pour fournir du contenu structuré à utiliser dans vos applications. La possibilité de personnaliser une seule requête d'API vous permet de récupérer et de diffuser le contenu spécifique que vous souhaitez/souhaitez rendre (en tant que réponse à la requête d'API unique).

REMARQUE

Voir Découplage et AEM pour une présentation du développement découplé pour AEM Sites as a Cloud Service.

CMS découplé

Un système de gestion de contenu (CMS) découplé est :

  • « 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.

    Voir Wikipedia.

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 sera 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 runtime pour répondre à ces requêtes avec vos données existantes.".

    Voir GraphQL.org

L’API AEM GraphQL permet d’effectuer des requêtes (complexes) sur vos fragments de contenu ; chaque requête étant conforme à un type de modèle spécifique. Le contenu renvoyé peut alors être utilisé par vos applications.

API AEM GraphQL

Pour Adobe Experience as a Cloud Experience, une implémentation personnalisée de l’API GraphQL standard a été développée. Voir AEM API GraphQL à utiliser avec les 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 à utiliser avec GraphQL

Fragments de contenu

Les fragments de contenu :

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é.

  • 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évisualisation 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 découplé 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é.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free