Concepts avancés d’AEM sans affichage

Ce tutoriel complet poursuit la tutoriel de base qui couvrait les principes de base d’Adobe Experience Manager (AEM) Headless et 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 AEM, y compris l’utilisation des requêtes persistantes GraphQL dans une application cliente.

Prérequis

Procédez comme suit : configuration rapide pour AEM as a Cloud Service pour configurer votre environnement as a Cloud Service AEM.

Il est vivement recommandé d’effectuer la tutoriel de base et série vidéo tutoriels avant de poursuivre ce tutoriel avancé. Bien que vous puissiez suivre le tutoriel à l’aide d’un environnement d’AEM local, ce tutoriel ne couvre que le processus pour AEM as a Cloud Service.

ATTENTION

Si vous n’avez pas accès à AEM environnement as a Cloud Service, vous pouvez effectuer les opérations suivantes : AEM Configuration rapide sans affichage à l’aide du SDK local. Toutefois, il est important de noter que certaines pages de l’interface utilisateur de produit, telles que la navigation Fragments de contenu, sont différentes.

Objectifs

Ce tutoriel couvre les rubriques suivantes :

  • Créez des modèles de fragment de contenu à l’aide de règles de validation et de types de données plus avancés tels que des espaces réservés d’onglet, des références de fragments imbriqués, des objets JSON et des types de données Date et heure.
  • Créez des fragments de contenu lorsque vous utilisez du contenu imbriqué et des références de fragments, et configurez des stratégies de dossier pour la gouvernance de création de fragments de contenu.
  • Explorez AEM fonctionnalités de l’API GraphQL à l’aide de requêtes GraphQL avec des variables et des directives.
  • Conserver les requêtes GraphQL avec des paramètres dans AEM et apprendre à utiliser les paramètres de contrôle du cache avec des requêtes persistantes.
  • Intégrez les requêtes de requêtes persistantes dans l’exemple d’application WKND GraphQL React à l’aide du SDK JavaScript sans affichage AEM.

Présentation des concepts avancés d’AEM sans affichage

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 persistance de requêtes GraphQL dans AEM.

ATTENTION

Cette vidéo (à 02h25) mentionne l’installation de l’éditeur de requêtes GraphiQL via Package Manager pour explorer les requêtes GraphQL. Cependant, dans les versions plus récentes d’AEM as Cloud Service, une version intégrée Explorateur GraphiQL est fournie, donc l’installation du package n’est pas requise. Voir Utilisation de l’IDE GraphiQL pour plus d’informations.

Configuration du projet

Le projet de site WKND 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 sans affichage.

Réviser la configuration existante

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 API GraphQL. Pour vérifier ou créer une configuration, accédez à Outils > Général > Explorateur de configuration.

Accédez à l’explorateur de configurations

Observez que WKND Shared la configuration du site 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 le modal Créer une configuration qui s’affiche.

Vérification de la configuration partagée WKND

Vérification des points d’entrée de l’API GraphQL

Ensuite, vous devez configurer les points d’entrée API pour envoyer des requêtes GraphQL à . Pour passer en revue les points de fin existants ou en créer un, accédez à Outils > Général > GraphQL.

Configuration des points de fin

Observez que WKND Shared Endpoint a déjà été créé. Pour créer un point de fin pour votre projet, sélectionnez Créer dans le coin supérieur droit et suivez le processus.

Vérification du point de terminaison partagé WKND

REMARQUE

Après avoir enregistré le point de terminaison, un modal 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 de terminaison. Toutefois, les autorisations de sécurité elles-mêmes ne font pas partie de ce tutoriel. Pour plus d’informations, reportez-vous à la section Documentation AEM.

Examinez la structure de contenu WKND et le dossier racine de langue

Une structure de contenu bien définie est essentielle au succès de AEM mise en oeuvre sans interface. Il s’avère 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 des traductions AEM utilise ces dossiers pour définir la Principale langue de votre contenu et les langues de traduction du contenu.

Accédez à Navigation > Ressources > Fichiers.

Accès aux fichiers

Accédez au WKND partagé dossier. Observez le dossier avec le titre "Anglais" et le nom "EN". Ce dossier est le dossier racine de langue du projet WKND Site.

Dossier anglais

Pour votre propre projet, créez un dossier racine de langue dans votre configuration. Voir la section sur création de dossiers pour plus d’informations.

Attribuer une configuration au dossier imbriqué

Enfin, vous devez affecter la configuration de votre projet au dossier racine de langue. Cette affectation permet la création de fragments de contenu en fonction de modèles de fragments 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.

Sélectionnez Propriétés

Ensuite, accédez au Cloud Services et sélectionnez l’icône de dossier dans la Configuration du cloud champ .

Configuration du cloud

Dans le modal qui s’affiche, sélectionnez la configuration précédemment créée pour lui affecter le dossier racine de langue.

Bonnes pratiques

Voici les bonnes pratiques à appliquer lors de la création de votre propre projet dans AEM :

  • La hiérarchie de dossiers doit être modélisée en tenant compte de la localisation et de la traduction. En d’autres termes, les dossiers de langue doivent être imbriqués dans des dossiers de configuration, ce qui permet une traduction facile du contenu dans ces dossiers de configuration.
  • La hiérarchie des dossiers doit être conservée à plat et simple. Évitez de déplacer ou de renommer des dossiers et des fragments ultérieurement, en particulier après publication pour une utilisation en direct, car cela modifie les chemins d’accès pouvant affecter les références aux fragments et les requêtes GraphQL.

Packages de démarrage et de solution

Deux AEM packages sont disponibles et peuvent être installées via Gestionnaire de modules

Le React App - Tutoriel avancé - WKND Adventures Vous pouvez consulter et 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 rend dans une expérience immersive.

Prise en main

Pour commencer à utiliser ce tutoriel avancé, procédez comme suit :

  1. Configuration d’un environnement de développement à l’aide de AEM as a Cloud Service.
  2. Démarrez le chapitre du tutoriel sur Création de modèles de fragment de contenu.

Sur cette page