M2E Multichannel für Adobe Commerce PaaS – Installationsanleitung

In diesem Leitfaden wird erläutert, wie Sie M2E Multichannel für Adobe Commerce PaaS beziehen, bereitstellen und installieren.

Mit PaaS sind sowohl Adobe Commerce in der Cloud-Infrastruktur als auch Adobe Commerce vor Ort gemeint.

M2E Multichannel wird als nicht herunterladbare Adobe App Builder-Anwendung bereitgestellt. Sie müssen den Quellcode der Anwendung nicht herunterladen oder lokal mithilfe der Adobe I/O-CLI bereitstellen.

💡 Video-Anleitung: Sehen Sie sich die Schritt-für-Schritt-Anleitung zur Installation von M2E Multichannel für Adobe Commerce PaaS an

Voraussetzungen #

Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie Folgendes haben:

• Adobe Commerce 2.4.5 oder höher muss installiert und in Betrieb sein.
• Zugriff auf Adobe Exchange.
• Zugriff auf das Adobe-Konto und die Organisation, die Ihrer Adobe Commerce-Umgebung zugeordnet sind.
• Administratorzugriff auf Adobe Commerce Admin.
• Berechtigung zum Erwerben, Bereitstellen, Zuordnen und Installieren von App Builder-Anwendungen.

ℹ️ M2E Multichannel nutzt die Adobe IMS-Authentifizierung für Adobe Commerce PaaS. Die Authentifizierung über Commerce Integration (OAuth 1.0a) wird nicht unterstützt.

Schritt 1. Adobe IMS aktivieren #

Adobe IMS muss für die PaaS Commerce-Umgebung aktiviert sein, bevor M2E Multichannel die IMS-Authentifizierung nutzen kann.

Um Adobe IMS zu aktivieren, führen Sie die folgenden Befehle im Stammverzeichnis der Adobe Commerce-Anwendung aus:

php bin/magento admin:adobe-ims:enable
php bin/magento cache:flush

Geben Sie bei Aufforderung Ihre Organisations-ID, Client-ID und Client-Secret ein und vergewissern Sie sich, dass die Zwei-Faktor-Authentifizierung (2FA) für Ihre Adobe-Organisation aktiviert ist. Adobe Commerce 2.4.5 und höher enthält das IMS-Metapaket, die Integration muss jedoch vor der Nutzung konfiguriert werden.

💡 Befolgen Sie die Anleitung zur Integration von Adobe Commerce Admin mit Adobe ID, um Informationen zur Konfiguration von Adobe IMS zu erhalten.

Schritt 2. Einrichten des Admin-UI-SDK #

Für M2E Multichannel müssen „App Management“ und das Admin-UI-SDK in Ihrer Adobe Commerce-Umgebung verfügbar sein.

Adobe Commerce 2.4.8 und höher #

Das Admin-UI-SDK und die App-Verwaltung sind automatisch enthalten. Es ist keine zusätzliche Installation erforderlich.

Adobe Commerce 2.4.5–2.4.7 #

Installieren Sie das Admin-UI-SDK 3.3 oder höher aus dem Stammverzeichnis der Adobe Commerce-Anwendung:

composer require magento/commerce-backend-sdk:^3.0

php bin/magento module:enable \
  Magento_AdminUISDK \
  Magento_AdobeIms \
  Magento_AdminAdobeIms

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

💡 Weitere Informationen finden Sie im Installationshandbuch zum Adobe Admin UI SDK.

Admin-UI-SDK aktivieren #

Sobald das SDK verfügbar ist:

1) Gehen Sie zu Stores > Einstellungen > Konfiguration.

2) Öffnen Sie Adobe Services > Admin UI SDK.

3) Setzen Sie Admin-UI-SDK aktivieren auf Ja.

4) Speichern Sie die Konfiguration.

Schritt 3. App-Verwaltung überprüfen #

Sobald IMS und das Admin-UI-SDK konfiguriert sind, vergewissern Sie sich, dass Apps > App-Verwaltung in Ihrem Adobe Commerce-Adminbereich verfügbar ist.

Im Bereich „App-Verwaltung“ können Sie die bereitgestellte M2E Multichannel-Anwendung zuordnen und installieren.

Schritt 4: M2E Multichannel von Adobe Exchange beziehen #

1) Melden Sie sich bei Adobe Exchange an.

2) Suchen Sie unter Experience Cloud nach M2E Multichannel for Adobe Commerce Cloud.

3) Öffnen Sie die App-Seite und klicken Sie auf Erwerben.

4) Es erscheint eine Meldung, dass für die App Adobe App Builder erforderlich ist. Klicken Sie auf Ja, fortfahren, um fortzufahren.

5) Sobald die App erworben wurde, klicken Sie auf App verwalten.

Sie werden zur App-Verwaltungsseite in Adobe Exchange weitergeleitet.

Schritt 5. Eine Umgebung erstellen #

Sobald die Anwendung erworben und genehmigt wurde, erstellen Sie eine Umgebung, in der sie bereitgestellt werden soll.

1) Klicken Sie auf der App-Verwaltungsseite auf den App-Namen M2E Multichannel for Commerce Cloud.

2) Klicken Sie auf + „Umgebung hinzufügen“.

3) Geben Sie einen Namen für die Umgebung ein, z. B. Test oder Produktion. Der Name muss zwischen 3 und 10 Zeichen lang sein.

4) Klicken Sie auf Umgebung speichern.

Nachdem die Umgebung gespeichert wurde, erstellt Adobe automatisch das entsprechende App Builder-Projekt in der Adobe Developer Console.

Öffnen Sie die neu erstellte Umgebung, um fortzufahren.

Schritt 6. Konfigurieren und Bereitstellen der Umgebung #

Eine neu erstellte Umgebung hat den Status Entwurf und muss konfiguriert und bereitgestellt werden.

1) Öffnen Sie im Menü der Umgebung den Punkt Konfiguration.

2) Wählen Sie das gewünschte Produktprofil aus.

3) Klicken Sie auf „Bereitstellen“.

4) Warten Sie, bis die Bereitstellung abgeschlossen ist.

Die Bereitstellung kann einige Minuten dauern. Sobald sie abgeschlossen ist, ändert sich der Status der Umgebung zu Bereitgestellt.

Während der Bereitstellung werden die erforderlichen IMS-Authentifizierungswerte automatisch konfiguriert:

Variable	Beschreibung
AIO_COMMERCE_AUTH_IMS_ORG_ID	Ihre Adobe-Organisations-ID.
AIO_COMMERCE_AUTH_IMS_CLIENT_ID	Gibt Ihre OAuth-Server-zu-Server-Anmeldedaten an.
AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS	Das Client-Geheimnis aus denselben OAuth-Server-zu-Server-Anmeldedaten.
AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID	Die Maschinenidentität, für die das Zugriffstoken ausgestellt wurde.
AIO_COMMERCE_AUTH_IMS_SCOPES	Berechtigungen, die das resultierende Token nutzen darf.

💡 Weitere Informationen zu OAuth-Server-zu-Server-Anmeldeinformationen finden Sie in der Adobe-Dokumentation zur Authentifizierung.

Schritt 7. Verknüpfen Sie die App mit Adobe Commerce #

Verknüpfen Sie die App Builder-Anwendung mit Ihrer Adobe Commerce-Instanz.

1) Melden Sie sich bei Ihrem Adobe Commerce-Adminbereich an.

2) Gehen Sie zu Apps > App-Verwaltung.

3) Klicken Sie auf + App verknüpfen.

4) Wählen Sie das gewünschte Projekt aus.

5) Wählen Sie den entsprechenden Arbeitsbereich aus.

6) Klicken Sie auf Zuordnen.

Sobald die Zuordnung abgeschlossen ist, wird M2E Multichannel in der App-Verwaltung mit dem Status Zugeordnet angezeigt.

Schritt 8. M2E Multichannel installieren #

1) Suchen Sie in der App-Verwaltung nach „M2E Multichannel für Adobe Commerce Cloud“.

2) Klicken Sie auf Installieren.

3) Bestätigen Sie den Vorgang, indem Sie erneut auf Installieren klicken.

4) Das Fenster mit dem Installationsfortschritt wird geöffnet. Während der Installation, App-Verwaltung:

• aktiviert das Admin-UI-SDK und registriert die Erweiterung bei der Adobe Commerce Admin-UI;
• führt den benutzerdefinierten Installationsschritt „M2E-Konto initialisieren“ aus, der die für die Initialisierung des M2E-Kontos erforderlichen Daten übermittelt.

5) Während diese Schritte ausgeführt werden, sind keine weiteren Maßnahmen erforderlich. Lassen Sie die Seite geöffnet, bis die Installation abgeschlossen ist.

Sobald dies geschehen ist, wird die App in der App-Verwaltung den Status „Installiert“ anzeigen.

M2E Multichannel wird unter Apps im Adobe Commerce-Adminbereich verfügbar sein. Sie können die App öffnen und mit der Ersteinrichtung fortfahren, die im M2E Multichannel-Benutzerhandbuch beschrieben ist.

Brauchst du Hilfe? #

Wenn Sie Fragen haben oder Hilfe bei der Installation von M2E Multichannel benötigen, wenden Sie sich bitte an das Support-Team.