Le chapitre 5 du tutoriel sur AEM Headless couvre la création de la page à partir des modèles définis dans le chapitre 4. La page créée dans ce chapitre agit comme point d’entrée du HTTP JSON pour l’application mobile.
L’architecture du contenu de la page de /content/wknd-mobile/en/api
a été préconfigurée. Les pages de base de en
et api
ont un objectif architectural et organisationnel, mais ne sont pas strictement requises. Si le contenu de l’API peut être localisé, il est recommandé de suivre les bonnes pratiques habituelles en matière de copie de la langue et d’organisation des pages de Multi Site Manager, car la page de l’API peut être localisée comme n’importe quelle page AEM Sites.
Le projet fournit une page CSS avec des styles de base pour l’expérience de création.
Modifiez la page d’API d’événements en accédant à AEM > Sites > WKND Mobile > Anglais > API, en sélectionnant la page d’API d’événements et en appuyant sur Modifier dans la barre d’actions supérieure.
Ajoutez une image de logo pour l’afficher dans l’application en la faisant glisser de l’outil de recherche de ressources vers l’espace réservé du composant Image.
/content/dam/wknd-mobile/images/wknd-logo.png
.Ajoutez une ligne de balise à afficher au-dessus des événements.
The WKND is here.
Sélectionnez les événements à afficher :
La sortie JSON et son format peuvent être examinés en demandant la page avec le sélecteur .model.json
.
Cette structure (ou schéma) JSON doit être bien comprise par les consommateurs et consommatrices de cette API. Il est essentiel que les clients et clientes de l’API comprennent quels aspects de la structure sont fixes (c’est-à-dire le logo (image) de l’API d’événements et la balise active (texte) et lesquels sont fluides, comme les événements répertoriés sous le composant Liste de fragments de contenu).
La rupture de ce contrat sur une API publiée peut entraîner un comportement incorrect dans les applications consommatrices.
Dans les nouveaux onglets du navigateur, demandez les pages d’API d’événements à l’aide du sélecteur .model.json
, qui appelle l’exporteur JSON d’AEM Content Services et sérialise la page et les composants dans une structure JSON normalisée et bien définie.
La structure JSON générée par ces pages est la structure sur laquelle les applications consommatrices doivent s’aligner.
Demandez la page d’API d’événements en tant que JSON.
Le résultat doit ressembler à ce qui suit :
Ce fichier JSON peut être généré de façon propre (formaté) pour la lisibilité humaine à l’aide du sélecteur .tidy
:
Si vous le souhaitez, vous pouvez installer le package de contenu com.adobe.aem.guides.wknd-mobile.content.chapter-5.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.