Diffusion de contenu découplée à l’aide de fragments de contenu avec GraphQL headless-content-delivery-using-content-fragments-with-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 d’API vous permet de récupérer et de diffuser le contenu spécifique que vous souhaitez rendre, ou avez besoin de rendre (comme réponse à la requête d’API unique).

NOTE
Voir également :

CMS découplé headless-cms

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 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-overview

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

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 aem-graphql-api

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 content-fragments-use-with-aem-graphql-api

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 content-fragments

Les fragments de contenu :

Modèles de fragment de contenu content-fragments-models

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 fragment-references

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.

Analyse de la structure de fragments de contenu analyzing-content-fragments-structure

Pour faciliter l’analyse, AEM propose plusieurs méthodes d’affichage de la structure de vos fragments à partir de l’ éditeur de fragments de contenu.

Pour plus d’informations, voir Analyse de la structure de fragment de contenu :

Apprendre à utiliser GraphQL avec AEM – Exemple de contenu et de requêtes learn-graphql-with-aem-sample-content-queries

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab