Chapitre 4 - Définitr des modèles Content Services
Le chapitre 4 du tutoriel sur AEM Headless aborde le rôle des modèles modifiables d’AEM dans le contexte d’AEM Content Services. Les modèles modifiables sont utilisés pour définir la structure de contenu JSON qu’AEM Content Services expose aux clients et clientes via la composition des composants AEM activés pour Content Services.
Comprendre le rôle des modèles dans AEM Content Services
Les modèles modifiables AEM sont utilisés pour définir les points d’entrée HTTP accessibles pour exposer le contenu de l’événement au format JSON.
En général, les modèles modifiables AEM sont utilisés pour définir des pages web, mais cette utilisation est une simple convention. Les modèles modifiables peuvent être utilisés pour composer tout ensemble de contenu et mode d’accès de contenu : en tant que HTML dans un navigateur ou que JSON utilisé par JavaScript (éditeur de SPA AEM), ou encore en tant qu’application mobile. Cela dépend de la manière dont cette page est demandée.
Dans AEM Content Services, des modèles modifiables sont utilisés pour définir la manière dont les données JSON sont exposées.
Pour l’application WKND Mobile, nous allons créer un modèle modifiable unique utilisé pour générer un point d’entrée API unique. Bien que cet exemple simple permette d’illustrer les concepts d’AEM Headless, vous pouvez créer plusieurs pages (ou points d’entrée) exposant chaque ensemble de contenu afin de créer une API plus complexe et mieux organisée.
Comprendre le point d’entrée de l’API
Pour comprendre comment composer notre point d’entrée d’API et comprendre quel contenu doit être exposé à notre application WKND Mobile, nous allons revoir la conception.
Comme nous pouvons le constater, nous disposons de trois ensembles logiques de contenu à fournir à l’application mobile.
- Le Logo.
- Le Ligne de balise.
- La liste des Événements.
Pour ce faire, nous pouvons mettre en correspondance ces exigences avec les composants AEM (et, dans notre cas, les composants AEM principaux de gestion de contenu web) afin d’exposer le contenu requis au format JSON.
- Le Logo est surfacé via un Composant d’image.
- La Ligne de balise est surfacée via un Composant de texte.
- La liste des Événements est surfacée via un Composant Liste de fragments de contenu qui, à son tour, fait référence à un ensemble de fragments de contenu d’événement.
Définir le modèle d’API d’événement
-
Accédez à Outils > Général > Modèles >WKND Mobile.
-
Créez le modèle Events API :
- Appuyez sur Créer dans la barre d’actions supérieure.
- Sélectionnez le modèle WKND Mobile - Empty Page.
- Appuyez sur Suivant dans la barre d’actions supérieure.
- Entrez Events API dans le champ Titre du modèle.
- Appuyez sur Créer dans la barre d’actions supérieure.
- Appuyez sur Ouvrir pour ouvrir le nouveau modèle à modifier.
-
Tout d’abord, nous autorisons les trois composants AEM identifiés dont nous avons besoin pour modéliser le contenu en modifiant la Stratégie du Conteneur de disposition racine. Assurez-vous que le mode Structure est actif, sélectionnez Layout Container [Root], puis appuyez sur le bouton Stratégie.
-
Sous Propriétés > Composants autorisés, recherchez WKND Mobile. Autorisez les composants suivants du groupe de composants WKND Mobile, afin qu’ils puissent être utilisés sur la page d’API Events.
-
WKND Mobile > Image
- Logo de l’application.
-
WKND Mobile > Text
- Texte d’introduction de l’application.
-
WKND Mobile > Content Fragment List
- Liste des catégories d’événement disponibles pour affichage dans l’application.
-
-
Cochez la case Terminé en haut à droite lorsque vous avez terminé.
-
Actualisez la fenêtre du navigateur pour afficher la liste des nouveaux Composants autorisés dans le rail de gauche.
-
Dans l’outil de recherche de composants du rail de gauche, faites glisser les composants AEM suivants :
- Image pour le Logo.
- Text pour la Ligne de balise.
- Content Fragment List pour les événements.
-
Pour chacun des composants ci-dessus, sélectionnez-les et appuyez sur le bouton Déverrouiller.
-
Cependant, assurez-vous que le conteneur de disposition est verrouillé pour empêcher l’ajout d’autres composants ou la suppression de ces trois composants.
-
Appuyez sur Informations sur la page > Afficher dans Admin pour revenir à la liste des modèles WKND Mobile. Sélectionnez le modèle Events API nouvellement créé et appuyez sur Activer dans la barre d’actions supérieure.
Étapes suivantes
Si vous le souhaitez, vous pouvez installer le package de contenu com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip sur l’instance de création AEM via le Gestionnaire de packages AEM. Ce package contient les configurations et le contenu décrits dans ce tutoriel et dans les chapitres précédents.