Voraussetzungen
Zum Durchführen dieses Tutorials benötigen Sie Folgendes:
-
AEM as a Cloud Service-Umgebung, in der AEM Eventing aktiviert ist. Außerdem muss das WKND-Sites-Beispielprojekt darin bereitgestellt sein.
-
Rufen Sie die Adobe Developer Console auf.
-
Adobe Developer-CLI, die auf Ihrem lokalen Computer installiert ist.
Entwicklungsschritte
Die allgemeinen Entwicklungsschritte lauten:
-
Konfigurieren des Projekts in ADC
-
Konfigurieren des AEM Author-Service, um die ADC-Projektkommunikation zu aktivieren
-
Entwickeln einer Runtime-Aktion zur Orchestrierung von Folgendem:
- Metadatenabruf aus dem PIM-System
- Aktualisierung von Metadaten in AEM Assets mithilfe der Assets Author-API
-
Erstellen und Anwenden eines Asset-Metadatenschemas
-
Verifizieren von Asset-Upload und Metadatenaktualisierung
Weitere Informationen zu den ersten beiden Schritten finden Sie unter Aufrufen von OpenAPI-basierten AEM-APIs. Näheres zu den Schritten 3 bis 4 erfahren Sie durch das Beispiel unter Adobe I/O Runtime-Aktionen und AEM-Ereignisse. Mehr über die Schritte 5 bis 9 können Sie den folgenden Abschnitten entnehmen.
Konfigurieren des Projekts in Adobe Developer Console (ADC)
Um AEM Assets-Ereignisse zu empfangen und die im vorherigen Schritt erstellte Adobe I/O Runtime-Aktion auszuführen, konfigurieren Sie das Projekt in ADC.
-
Navigieren Sie in ADC zu dem Projekt, das Sie in Schritt 3 erstellt haben. Wählen Sie aus diesem Projekt den Arbeitsbereich
Stage
aus, in dem die Runtime-Aktion bereitgestellt wird, wenn Sieaio app deploy
als Teil der Anweisungen von Schritt 4 ausführen. -
Klicken Sie auf die Schaltfläche Dienst hinzufügen und wählen Sie die Option Ereignis aus. Klicken Sie im Dialogfeld Ereignisse hinzufügen auf Experience Cloud > AEM Assets und wählen Sie Weiter aus.
-
Wählen Sie im Schritt Ereignisregistrierung konfigurieren die gewünschte AEMCS-Instanz, dann das Ereignis Asset-Verarbeitung abgeschlossen und schließlich die Option „OAuth-Server-zu-Server“ als Authentifizierungstyp aus.
-
Erweitern Sie abschließend im Schritt Empfangen von Ereignissen die Option Runtime-Aktion und wählen Sie die im vorherigen Schritt erstellte generische Aktion aus. Klicken Sie auf Konfigurierte Ereignisse speichern.
-
Klicken Sie wieder auf die Schaltfläche Dienst hinzufügen und wählen Sie die Option API aus. Klicken Sie im Modal API hinzufügen auf Experience Cloud > AEM Assets Author-API und wählen Sie Weiter aus.
-
Wählen Sie anschließend OAuth-Server-zu-Server für den Authentifizierungstyp und klicken Sie auf Weiter.
-
Wählen Sie dann das korrekte Produktprofil aus, das mit der AEM Assets-Umgebung verknüpft ist, aus der das Ereignis erstellt wird, und das über ausreichende Zugriffsrechte verfügt, um Assets dort zu aktualisieren. Klicken Sie abschließend auf die Schaltfläche Konfigurierte API speichern.
In meinem Fall ist das Produktprofil AEM-Admins – Author - Programm XXX – Umgebung JJJJ ausgewählt. Es ist der Service für AEM Assets API-Benutzende aktiviert.