Konfigurieren der Experience Cloud-Integration mit Commerce Admin
Beginnen Sie mit der Experience Cloud-Integration in Commerce Admin, indem Sie das Commerce-Programm so konfigurieren, dass es die Erweiterungen Commerce Admin Unified Experience und Commerce Events verwendet.
Voraussetzungen
-
Adobe Commerce muss für die Verwendung der Adobe IMS-Authentifizierung“ konfiguriert
-
Kontobereitstellung und -berechtigungen: Administratoren müssen über ein Adobe-GeschäftsprofilZugriff 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 zum Generieren der Verbindungsanmeldeinformationen und der Projektkonfiguration für die Verwendung des Adobe I/O-Ereignisdienstes
- Commerce in einem Cloud-Infrastrukturprojekt—Installieren Sie die erforderlichen Module und konfigurieren Sie den Commerce-Anwendungsserver mithilfe der Adobe Commerce-CLI
- Commerce Admin: Aktualisieren der Store-Konfiguration und Verwalten von Commerce-Benutzerkonten
Konfigurationsübersicht
Aktivieren Sie die Integration, indem Sie die folgenden Aufgaben ausführen:
Überprüfen der Commerce-Umgebung und der Anwendungskonfiguration
Stellen Sie vor dem Konfigurieren der Experience Cloud-Integration sicher, dass Ihr Projekt und Commerce-Programm die Anforderungen erfüllen.
-
Wechseln Sie auf Ihrer lokalen Workstation in das Projektverzeichnis für Ihr Commerce-Projekt.
-
Checken Sie die Umgebungsverzweigung für die Instanz aus, die mit Experience Cloud integriert werden soll.
-
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 aktivieren Sie es mithilfe der Organisation und der Anmeldeinformationen für das IMS-Integrationsprojekt.
-
-
Vergewissern Sie sich, dass sich der Admin-Benutzer mit seiner Adobe ID bei Commerce Admin anmelden kann.
-
Navigieren Sie zur Commerce Admin-URL.
-
Wenn Sie angemeldet sind, melden Sie sich ab.
-
Stellen Sie sicher, dass der Administrator umgeleitet wird, um sich mit seiner Adobe ID anzumelden.
-
-
Ü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 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, verwenden Sie Composer, um sie zu installieren. Übertragen Sie dann die Änderungen und stellen Sie die Cloud-Umgebung erneut bereit.
code language-none composer require magento/module-unified-experience composer update
Einheitliches Erlebnis für Commerce Admin aktivieren
Aktivieren Sie die Commerce Admin Unified Experience-Erweiterung und melden Sie sich über Experience Cloud an.
-
Verwenden Sie im Stammverzeichnis Ihrer Cloud-Projektumgebung auf Ihrer lokalen Workstation das magento-cloud-CLI-Tool, um sich beim Commerce-Anwendungs-Server anzumelden.
code language-bash magento-cloud ssh
-
Aktivieren der
magento/module-unified-experience
-Erweiterung über die 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-Ereignisdienst Commerce-Ereignisdaten an Experience Cloud, um den Administratorzugriff auf Commerce-Projekte zu verwalten. Zum Einrichten des Service müssen Sie die Erweiterung Adobe I/O-Ereignisse für Commerce (magento/commerce-eventing
) aktivieren und den Dienst Adobe I/O-Ereignisse in der Admin Console konfigurieren.
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-Service zu senden.
-
Fügen Sie in Ihrer lokalen Commerce-Projektentwicklungsumgebung der
.magento.env.yaml
-Datei die folgende Konfiguration hinzu.code language-yaml stage: global: ENABLE_EVENTING: true deploy: CRON_CONSUMERS_RUNNER: cron_run: true max_messages: 0 consumers: []
-
Hinzufügen, Übertragen und Bereitstellen der aktualisierten
.magento.env.yaml file
in die Cloud-Umgebung.
.magento.env.yaml
finden Sie unter Konfigurieren von Umgebungsvariablen für die Bereitstellung.Konfigurieren der Commerce-Ereignisintegration
Konfigurieren Sie die Commerce-Ereignisintegration, indem Sie die folgenden Aufgaben ausführen. Detaillierte Anweisungen finden Sie in der Entwicklerdokumentation zu Adobe I/O-Ereignissen für Commerce.
-
Erstellen eines App Builder-Projekts um Ereignisdaten von der Commerce-Instanz zu erhalten.
Sie benötigen Anmeldedaten 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.
Melden Sie sich nicht an und abonnieren Sie keine Ereignisse aus der Commerce-Instanz. Die Ereignisregistrierung wird an das App Builder-Projekt übergeben, 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 in der 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 einheitlichen Admin-Erlebniserweiterung mithilfe der Adobe Commerce-CLI überprüfen.
code language-bash bin/magento bin/magento admin:uex:status
-
Testen der Integration
Stellen Sie sicher, dass sich ein Commerce-Administrator beim Experience Cloud anmelden kann, um verfügbare Commerce-Projekte anzuzeigen und auf die Admin- und Storefront für jedes Projekt zuzugreifen.
-
Melden Sie sich bei Experience Cloud an indem Sie die Adobe ID und das mit der Commerce-Instanz verknüpfte Unternehmen verwenden.
-
Anzeigen verfügbarer Commerce-Projekte durch Auswahl von Commerce.
-
Öffnen Sie den Administrator für eine Instanz, indem Sie Open auswählen.
-
Stellen Sie sicher, dass Sie Admin-Aufgaben erwartungsgemäß ausführen können.
Workflows in der Commerce Admin sollten demselben Prozess folgen. Wenn nach der Aktivierung der Experience Cloud-Integration Workflow-Änderungen oder -Fehler auftreten, wenden Sie sich an Ihren Commerce-Systemadministrator oder Sie ein Adobe-Support-Ticket.
Stellen Sie nach dem Konfigurieren der Experience Cloud-Integration sicher, dass Administratorkonten für den Zugriff auf Commerce-Projekte über Experience Cloud korrekt bereitgestellt wurden. Siehe Verwalten von Admin-.