Journalisation et événements AEM
Découvrez comment récupérer le jeu initial d’événements AEM dans le journal et explorer les détails de chaque événement.
La journalisation est une méthode d’extraction permettant d’utiliser des événements AEM, et un journal est une liste d’événements ordonnés. À l’aide de l’API de journalisation des événements Adobe I/O, vous pouvez récupérer les événements AEM du journal et les traiter dans votre application. Cette approche vous permet de gérer les événements selon une cadence spécifiée et de les traiter efficacement en bloc. Voir la section Journalisation pour obtenir des informations détaillées, notamment sur des points essentiels tels que les périodes de conservation, la pagination, etc.
Dans le projet Adobe Developer Console, chaque enregistrement d’événement est automatiquement activé pour la journalisation, ce qui permet une intégration transparente.
Dans cet exemple, en utilisant une application web hébergée fournie par Adobe, vous pouvez récupérer le premier lot d’événements AEM à partir du journal, sans avoir à configurer votre application. Cette application web fournie par Adobe est hébergée sur Glitch, une plateforme connue pour proposer un environnement web propice à la création et au déploiement d’applications web. Cependant, vous pouvez aussi utiliser votre propre application si vous préférez.
Conditions préalables
Les éléments suivants sont requis afin de terminer ce tutoriel :
-
Environnement AEM as a Cloud Service avec AEM Eventing activé.
-
Projet Adobe Developer Console configuré pour des événements AEM.
Accéder à une application web
Pour accéder à l’application web fournie par Adobe, procédez comme suit :
-
Vérifiez que vous pouvez accéder à l’application web hébergée par Glitch dans un nouvel onglet du navigateur.
Collecter des détails du projet Adobe Developer Console
Pour récupérer les événements AEM à partir du journal, des informations d’identification telles que l’identifiant de l’organisation IMS, l’identifiant du client ou de la cliente et le Jeton d’accès sont obligatoires. Pour collecter ces informations d’identification, procédez comme suit :
-
Dans Adobe Developer Console, accédez à votre projet et cliquez pour l’ouvrir.
-
Sous la section Informations d’identification, cliquez sur le lien OAuth serveur à serveur pour ouvrir l’onglet Détails des informations d’identification.
-
Cliquez sur le bouton Générer un jeton d’accès pour générer le jeton d’accès.
-
Copiez le jeton d’accès généré, l’identifiant du client ou de la cliente et l’identifiant de l’organisation. Vous en aurez besoin plus loin dans ce tutoriel.
-
Chaque enregistrement d’événement est automatiquement activé pour la journalisation. Pour obtenir le point d’entrée de l’API de journalisation unique de l’enregistrement de votre événement, cliquez sur la carte d’événement qui est abonnée aux événements AEM. Dans l’onglet Détails de l’enregistrement, copiez le point d’entrée de l’API unique de journalisation.
Charger le journal des événements AEM
Pour simplifier les choses, cette application web hébergée récupère uniquement le premier lot d’événements AEM à partir du journal. Il s’agit des événements disponibles les plus anciens du journal. Pour plus d’informations, consultez le premier lot d’événements.
-
Dans l’application web hébergée sur Glitch, saisissez l’identifiant de l’organisation IMS, l’identifiant du client ou de la cliente et le jeton d’accès que vous avez préalablement copiés à partir du projet Adobe Developer Console, puis cliquez sur Envoyer.
-
En cas de succès, le composant de tableau affiche les données du journal des événements AEM.
-
Pour afficher la payload d’événement complète, double-cliquez sur la ligne. Vous constatez que les détails de l’événement AEM disposent de toutes les informations nécessaires pour traiter l’événement dans le webhook. Par exemple, le type d’événement (
type), la source de l’événement (source), l’identifiant de l’événement (event_id), l’heure de l’événement (time) et les données de l’événement (data).
Ressources supplémentaires
-
Le code source du webhook Glitch est disponible à titre de référence. Il s’agit d’une application React simple qui utilise des composants Adobe React Spectrum pour effectuer le rendu de l’interface utilisateur.
-
L’API de journalisation des événements Adobe I/O fournit des informations détaillées sur l’API, telles que le premier lot d’événements, le suivant et le dernier, la pagination, etc.