Journaling und AEM-Ereignisse
Erfahren Sie, wie Sie den ersten Satz von AEM-Ereignissen aus dem Journal abrufen und sich die Details zu jedem Ereignis ansehen.
Das Journaling ist eine Abrufmethode zum Nutzen von AEM-Ereignissen und ein Journal ist eine geordnete Liste von Ereignissen. Mithilfe der Journaling-API für Adobe I/O-Ereignisse können Sie die AEM-Ereignisse aus dem Journal abrufen und in Ihrer Anwendung verarbeiten. Dieser Ansatz ermöglicht es Ihnen, Ereignisse basierend auf einem bestimmten Rhythmus zu verwalten und sie effizient massenweise zu verarbeiten. Unter Journaling finden Sie detaillierte Einblicke, einschließlich wesentlicher Aspekte wie Aufbewahrungszeiten und Paginierung.
Im Adobe Developer Console-Projekt wird das Journaling automatisch für jede Ereignisregistrierung aktiviert, was eine nahtlose Integration ermöglicht.
In diesem Beispiel können Sie dank einer von Adobe bereitgestellten gehosteten Web-Anwendung den ersten Batch von AEM-Ereignissen aus dem Journal abrufen, ohne Ihre Anwendung einrichten zu müssen. Diese von Adobe bereitgestellte Web-Anwendung wird auf Glitch gehostet, einer Plattform, die eine Web-basierte Umgebung zum Erstellen und Bereitstellen von Web-Anwendungen bietet. Wenn Sie es vorziehen, können Sie jedoch auch Ihre eigene Anwendung verwenden.
Voraussetzungen
Zum Durchführen dieses Tutorials benötigen Sie Folgendes:
-
AEM as a Cloud Service-Umgebung, in der AEM Eventing aktiviert ist.
-
Für AEM-Ereignisse konfiguriertes Adobe Developer Console-Projekt.
Zugreifen auf die Web-Anwendung
Gehen Sie wie folgt vor, um auf die von Adobe bereitgestellte Web-Anwendung zuzugreifen:
-
Stellen Sie sicher, dass Sie in einer neuen Browser-Registerkarte auf die von Glitch gehostete Web-Anwendung zugreifen können.
Erfassen von Adobe Developer Console-Projektdetails
Um die AEM-Ereignisse aus dem Journal abzurufen, sind Anmeldeinformationen wie IMS-Organisations-ID, Client-ID und Zugriffs-Token erforderlich. Gehen Sie wie folgt vor, um diese Anmeldeinformationen zu erfassen:
-
Navigieren Sie in der Adobe Developer Console zu Ihrem Projekt und klicken Sie darauf, um es zu öffnen.
-
Klicken Sie im Bereich Credentials (Anmeldeinformationen) auf den Link OAuth Server-to-Server, um die Registerkarte Credential details (Details zu Anmeldedaten) zu öffnen.
-
Klicken Sie auf die Schaltfläche Generate access token (Zugriffs-Token generieren), um das Zugriffs-Token zu generieren.
-
Kopieren Sie die Angaben für Generated access token (Generiertes Zugriffs-Token), CLIENT ID (CLIENT-ID) und ORGANIZATION ID (ORGANISATIONS-ID). Sie benötigen sie später in diesem Tutorial.
-
Das Journaling wird automatisch für jede Ereignisregistrierung aktiviert. Um den eindeutigen Journaling-API-Endpunkt Ihrer Ereignisregistrierung zu erhalten, klicken Sie auf die Ereigniskarte, für die AEM-Ereignisse abonniert sind. Kopieren Sie auf der Registerkarte Registration Details (Registrierungsdetails) die Informationen zu JOURNALING UNIQUE API ENDPOINT (EINDEUTIGER API-ENDPUNKT FÜR DAS JOURNALING).
Laden des AEM-Ereignisprotokolls
Um die Dinge einfach zu halten, ruft diese gehostete Web-Anwendung nur den ersten Batch von AEM-Ereignissen aus dem Journal ab. Dies sind die ältesten verfügbaren Ereignisse im Journal. Weitere Informationen finden Sie im Abschnitt zum ersten Batch von Ereignissen.
-
Geben Sie in Glitch – gehostete Webanwendung die IMS-Organisations-ID, die Kunden-ID und das Zugriffs-Token ein, die bzw. das Sie zuvor aus dem Adobe Developer Console-Projekt kopiert haben und klicken auf Senden.
-
Bei Erfolg zeigt die Tabellenkomponente die AEM-Ereignisjournaldaten an.
-
Um die vollständige Ereignis-Payload anzuzeigen, doppelklicken Sie auf die Zeile. Sie können sehen, dass die AEM-Ereignisdetails alle notwendigen Informationen enthalten, um das Ereignis im Webhook zu verarbeiten. Beispiele sind Ereignistyp (
type), Ereignisquelle (source), Ereignis-ID (event_id), Ereigniszeit (time) und Ereignisdaten (data).
Zusätzliche Ressourcen
-
Quell-Code für den Glitch-Webhook steht als Referenz zur Verfügung. Es ist eine einfache React-Anwendung, die Adobe React Spectrum-Komponenten zum Rendern der Benutzeroberfläche verwendet.
-
Die Adobe I/O-Ereignisjournal-API bietet detaillierte Informationen zur API, z. B. den ersten, nächsten und letzten Ereignis-Batch, Paginierung und mehr.