Konfigurieren der Experience Cloud-Integration mit Commerce Admin
Beginnen Sie mit der Experience Cloud-Integration mit Commerce Admin, indem Sie die Commerce-Anwendung für die Verwendung der Commerce Admin Unified Experience und Commerce Events-Erweiterungen konfigurieren.
Voraussetzungen
-
Adobe Commerce muss für die Verwendung von Adobe IMS-Authentifizierung konfiguriert werden
-
Kontobereitstellung und -berechtigungen - Administratoren müssen über ein Adobe-Geschäftsprofil mit Zugriff auf die folgenden Ressourcen verfügen, um die Experience Cloud-Integration zu konfigurieren:
- Adobe Admin Console - Hinzufügen und Verwalten von Adobe-Benutzer- und Entwicklerkonten für das Unternehmen
- Adobe Developer Console - Entwickler- oder Systemadministratorzugriff zum Erstellen von App Builder-Projekten und Generieren der Verbindungsanmeldeinformationen und der Projektkonfiguration für die Verwendung des Adobe I/O Events-Dienstes
- Commerce im Cloud-Infrastrukturprojekt - Installieren Sie die erforderlichen Module und konfigurieren Sie den Commerce-Anwendungsserver mithilfe der Adobe Commerce-CLI.
- Commerce Admin - Aktualisieren der Speicherkonfiguration und Verwalten von Commerce-Benutzerkonten
Konfigurationsübersicht
Aktivieren Sie die Integration, indem Sie die folgenden Aufgaben ausführen:
Überprüfen der Commerce-Umgebung und Anwendungskonfiguration
Bevor Sie die Experience Cloud-Integration konfigurieren, stellen Sie sicher, dass Ihr Projekt und Ihre Commerce-Anwendung die Anforderungen erfüllen.
-
Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis für Ihr Commerce-Projekt.
-
Sehen Sie sich die Umgebungsverzweigung an, damit die Instanz mit Experience Cloud integriert werden kann.
-
Stellen Sie sicher, dass Adobe IMS aktiviert ist.
-
Verwenden Sie die SSH-Zugriffs-URL für die Umgebung, um eine Verbindung zum Commerce-Anwendungsserver herzustellen.
-
Verwenden Sie in der Befehlszeile die Adobe Commerce-CLI, um den IMS-Modulstatus zu überprüfen.
code language-bash bin/magento admin:adobe-ims:status
Wenn das Modul nicht aktiviert ist, aktivieren Sie es mithilfe der Organisation und der Anmeldeinformationen für das IMS-Integrationsprojekt🔗.
-
-
Vergewissern Sie sich, dass sich der Admin-Benutzer über seine Adobe ID bei Commerce Admin anmelden kann.
-
Rufen Sie die Commerce Admin-URL auf.
-
Wenn Sie angemeldet sind, melden Sie sich ab.
-
Stellen Sie sicher, dass der Admin-Benutzer zur Anmeldung mit seinem Adobe ID umgeleitet wird.
{width="600" modal="regular"}
-
-
Überprüfen Sie im Cloud-Projektverzeichnis auf Ihrer lokalen Workstation, ob die Commerce Admin Unified Experience-Erweiterung installiert ist.
code language-bash composer show *unified-experience*
Wenn die Erweiterung installiert ist, gibt der Composer den Namen und die Beschreibung der Erweiterung zurück.
code language-none magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud
Wenn die Erweiterung nicht installiert ist, installieren Sie sie mit Composer. Übertragen Sie dann die Änderungen und stellen Sie die Cloud-Umgebung erneut bereit.
code language-none composer require magento/module-unified-experience composer update
Commerce Admin Unified Experience aktivieren
Aktivieren Sie die Commerce Admin Unified Experience-Erweiterung und melden Sie sich dann über Experience Cloud an.
-
Melden Sie sich über das CLI-Tool magento-cloud (Magento-Cloud) im Stammverzeichnis Ihrer Cloud-Projektumgebung auf Ihrer lokalen Workstation beim Commerce-Anwendungsserver an.
code language-bash magento-cloud ssh
-
Aktivieren Sie die Erweiterung "
magento/module-unified-experience
"mithilfe der Adobe Commerce-CLI:code language-bash bin/magento config:set admin/unified_experience/enabled 1 Admin Unified Experience integration is enabled
-
Löschen Sie den Cache.
code language-bash bin/magento cache:clean
Einrichten von Adobe I/O-Ereignissen für Commerce
Wenn die Experience Cloud-Integration aktiviert ist, sendet der Adobe I/O Events-Dienst Commerce-Ereignisdaten an Experience Cloud, um den Administratorzugriff auf Commerce-Projekte zu verwalten. Für die Einrichtung des Dienstes müssen die Adobe I/O-Ereignisse für die Commerce-Erweiterung (magento/commerce-eventing
) aktiviert und der Adobe I/O-Ereignisdienst in Admin konfiguriert werden.
Commerce-Ereignisse aktivieren
Aktivieren Sie die Commerce Events-Erweiterung (magento/commerce-eventing
), um benutzerdefinierte Ereignisdaten von der Commerce-Anwendung an den Adobe I/O Events-Dienst zu senden.
-
Fügen Sie in Ihrer lokalen Commerce-Projektentwicklungsumgebung die folgende Konfiguration zur Datei
.magento.env.yaml
hinzu.code language-yaml stage: global: ENABLE_EVENTING: true deploy: CRON_CONSUMERS_RUNNER: cron_run: true max_messages: 0 consumers: []
-
Fügen Sie das aktualisierte
.magento.env.yaml file
hinzu, übertragen Sie es und stellen Sie es in der Cloud-Umgebung bereit.
.magento.env.yaml
finden Sie unter Konfigurieren von Umgebungsvariablen für die Bereitstellung.Commerce Events-Integration konfigurieren
Konfigurieren Sie die Commerce Events-Integration, indem Sie die folgenden Aufgaben ausführen. Detaillierte Anweisungen finden Sie in der Entwicklerdokumentation für Commerce🔗 unter Adobe I/O-Ereignisse .
-
Erstellen Sie ein App Builder-Projekt , um Ereignisdaten von der Commerce-Instanz zu erhalten.
Sie benötigen Anmeldeinformationen und Konfigurationsdaten aus dem App Builder-Projekt, um die Integration in Commerce Admin zu konfigurieren.
-
Konfigurieren Sie Adobe Commerce für die Verwendung von Adobe I/O-Ereignissen.
-
Aktualisieren Sie das App Builder-Projekt, um Ereignisdaten von der Commerce-Instanz zu erhalten.
Registrieren Sie keine Ereignisse von der Commerce-Instanz oder abonnieren Sie sie. Die Ereignisregistrierung wird an das App Builder-Projekt gesendet, wenn Sie den Ereignisanbieter für die Commerce-Anwendung konfigurieren.
Nachdem Sie den Ereignisanbieter mit dem App Builder-Projekt verbunden haben, abonnieren Sie das
observer.uex_commerce_instance_update
-Ereignis und speichern Sie die Änderungen. -
Um die Verbindung herzustellen, senden Sie ein Ereignis über den Ereignisanbieter an den Verbraucher.
-
Verwenden Sie über die Befehlszeile im lokalen Cloud-Projektverzeichnis SSH, um eine Verbindung zum Commerce-Anwendungsserver herzustellen.
code language-bash magento-cloud ssh
-
Senden Sie Ereignisdaten, indem Sie den Status der Admin Unified Experience-Erweiterung mit der Adobe Commerce-CLI überprüfen.
code language-bash bin/magento bin/magento admin:uex:status
-
Integration testen
Stellen Sie sicher, dass sich ein Commerce-Administrator bei Experience Cloud anmelden kann, um verfügbare Commerce-Projekte anzuzeigen und auf die Admin- und Storefront für jedes Projekt zuzugreifen.
-
{width="600" modal="regular"}
-
Zeigen Sie verfügbare Commerce-Projekte durch Auswahl von "Commerce"an.
{width="600" modal="regular"}
-
Öffnen Sie den Admin für eine Instanz, indem Sie Open auswählen.
{width="600" modal="regular"}
-
Stellen Sie sicher, dass Sie Admin-Aufgaben erwartungsgemäß ausführen können.
Workflows in Commerce Admin sollten denselben Prozess verfolgen. Wenn Workflow-Änderungen oder Fehler nach der Aktivierung der Experience Cloud-Integration auftreten, wenden Sie sich an Ihren Commerce-Systemadministrator oder senden Sie ein Adobe-Supportticket🔗.
Nachdem Sie die Experience Cloud-Integration konfiguriert haben, stellen Sie sicher, dass die Administratorkonten ordnungsgemäß bereitgestellt wurden, um über Experience Cloud auf Commerce-Projekte zuzugreifen. Siehe Verwalten von Admin-Benutzern.