Ce tutoriel complet poursuit le tutoriel de base qui couvrait les principes de base d’Adobe Experience Manager (AEM) Headless et de GraphQL. Le tutoriel avancé illustre des aspects détaillés de l’utilisation des modèles de fragment de contenu, des fragments de contenu et des requêtes persistantes GraphQL d’AEM, y compris l’utilisation des requêtes persistantes GraphQL dans une application cliente.
Procédez à la configuration rapide d’AEM as a Cloud Service pour configurer votre environnement AEM as a Cloud Service.
Il est vivement recommandé d’effectuer le tutoriel de base précédent et les tutoriels vidéo avant de poursuivre ce tutoriel avancé. Bien que vous puissiez suivre le tutoriel à l’aide d’un environnement AEM local, ce tutoriel ne couvre que le workflow pour AEM as a Cloud Service.
Si vous n’avez pas accès à un environnement AEM as a Cloud Service, vous pouvez effectuer la configuration rapide d’AEM Headlesss à l’aide du SDK local. Toutefois, il est important de noter que certaines pages de l’interface utilisateur de produit, telles que la navigation des fragments de contenu, sont différentes.
Ce tutoriel couvre les sujets suivants :
La vidéo suivante présente un aperçu général des concepts abordés dans ce tutoriel. Le tutoriel comprend la définition de modèles de fragment de contenu avec des types de données plus avancés, l’imbrication de fragments de contenu et la conservation de requêtes GraphQL dans AEM.
Cette vidéo (à 2:25) mentionne l’installation de l’éditeur de requêtes GraphiQL via le gestionnaire de packages pour explorer les requêtes GraphQL. Cependant, dans les versions plus récentes d’AEM as a Cloud Service, une version intégrée de l’explorateur GraphiQL est fournie, l’installation du package n’est donc pas requise. Consultez Utilisation de l’IDE GraphiQL pour plus d’informations.
Le projet de WKND Site comporte toutes les configurations nécessaires pour que vous puissiez commencer le tutoriel juste après avoir terminé la configuration rapide. Cette section ne met en évidence que certaines étapes importantes que vous pouvez utiliser lors de la création de votre propre projet AEM Headless.
La première étape pour démarrer un nouveau projet dans AEM consiste à créer sa configuration en tant qu’espace de travail et à créer des points d’entrée d’API GraphQL. Pour vérifier ou créer une configuration, accédez à Outils > Général > Explorateur de configurations.
Notez que la configuration du site WKND Shared
a déjà été créée pour le tutoriel. Pour créer une configuration pour votre propre projet, sélectionnez Créer dans le coin supérieur droit et remplissez le formulaire dans la boîte de dialogue modale Créer une configuration qui s’affiche.
Ensuite, vous devez configurer les points d’entrée de l’API auxquels envoyer des requêtes GraphQL. Pour passer en revue les points d’entrée existants ou en créer un, accédez à Outils > Général > GraphQL.
Notez que le WKND Shared Endpoint
a déjà été créé. Pour créer un point d’entrée pour votre projet, sélectionnez Créer dans le coin supérieur droit et suivez le workflow.
Après avoir enregistré le point d’entrée, une boîte de dialogue modale s’affiche pour vous rendre dans la console de sécurité, ce qui vous permet d’ajuster les paramètres de sécurité si vous souhaitez configurer l’accès au point d’entrée. Toutefois, les autorisations de sécurité elles-mêmes ne font pas partie de ce tutoriel. Pour en savoir plus, consultez la documentation AEM.
Une structure de contenu bien définie est essentielle au succès de l’implémentation d’AEM Headless. Elle est utile pour la gestion de l’évolutivité, de la convivialité et des autorisations de votre contenu.
Un dossier racine de langue est un dossier dont le nom contient un code de langue ISO, tel que EN ou FR. Le système de gestion de traduction d’AEM utilise ces dossiers pour définir la langue principale de votre contenu et les langues de traduction du contenu.
Accédez à Navigation > Ressources > Fichiers.
Accédez au dossier WKND Shared. Observez le dossier dont le titre est « English » et le nom « EN ». Ce dossier est le dossier racine de langue du projet WKND Site.
Pour votre propre projet, créez un dossier racine de langue dans votre configuration. Voir la section sur la création de dossiers pour plus d’informations.
Enfin, vous devez attribuer la configuration de votre projet au dossier racine de langue. Cette attribution permet la création de fragments de contenu en fonction de modèles de fragment de contenu définis dans la configuration de votre projet.
Pour attribuer le dossier racine de langue à la configuration, sélectionnez le dossier, puis sélectionnez Propriétés dans la barre de navigation supérieure.
Ensuite, accédez à l’onglet Cloud Services et sélectionnez l’icône de dossier dans le champ Configuration du cloud.
Dans la boîte de dialogue modale qui s’affiche, sélectionnez la configuration précédemment créée pour lui affecter le dossier racine de langue.
Voici les bonnes pratiques à appliquer lors de la création de votre propre projet dans AEM :
Deux packages AEM sont disponibles et peuvent être installés via le Gestionnaire de packages.
Le projet Application React - Tutoriel avancé - WKND Adventures vous permet de consulter et d’explorer l’exemple d’application. Cet exemple d’application récupère le contenu d’AEM en appelant les requêtes GraphQL persistantes et le transforme en une expérience immersive.
Pour commencer à utiliser ce tutoriel avancé, procédez comme suit :