Erste Schritte mit AEM Commerce as a Cloud Service

Um mit Adobe Experience Manager (AEM) Commerce as a Cloud Service zu beginnen, muss Ihr Experience Manager Cloud Service über das Add-on Commerce integration framework (CIF) verfügen. Das CIF-Add-on ist ein zusätzliches Modul zusätzlich zu AEM Sites as a Cloud Service.

Einstieg

Das Onboarding für AEM Commerce as a Cloud Service erfolgt in zwei Schritten:

  1. AEM Commerce as a Cloud Service aktivieren und das CIF-Add-on bereitstellen
  2. AEM Commerce as a Cloud Service mit Ihrer Lösung für den Handel verbinden

Der erste Onboarding-Schritt wird von Adobe ausgeführt. Weitere Informationen zu Preisen und Bereitstellung erhalten Sie von Ihrem Vertriebsmitarbeiter.

Nachdem Sie das CIF Add-on bereitgestellt haben, wird es auf alle vorhandenen Cloud Manager-Programme angewendet. Wenn Sie kein Cloud Manager-Programm haben, müssen Sie eines erstellen. Weitere Informationen finden Sie unter Einrichten des Programms.

Der zweite Schritt erfolgt per Self-Service für die einzelnen AEM as a Cloud Service-Umgebungen. Es gibt einige zusätzliche Konfigurationen, die Sie nach der ersten Bereitstellung des CIF-Add-ons vornehmen müssen.

AEM mit einer Lösung für den Handel verbinden

So verbinden Sie das CIF-Add-on und das CIF-Kernkomponenten AEM mit einer Commerce-Lösung verwenden, müssen Sie die GraphQL-Endpunkt-URL über eine Cloud Manager-Umgebungsvariable bereitstellen. Der Variablenname lautet COMMERCE_ENDPOINT. Eine sichere Verbindung über HTTPS muss konfiguriert werden.

Diese Umgebungsvariable wird an zwei Stellen verwendet:

  • GraphQL-Aufrufe vom AEM zum Commerce-Backend über einen gemeinsamen GraphQl-Client, der von den AEM CIF Kernkomponenten und Kundenprojektkomponenten verwendet wird.
  • Richten Sie in jeder AEM Umgebung, in der die Variable festgelegt ist, eine GraphQL-Proxy-URL ein unter /api/graphql. Diese URL wird von den AEM Commerce-Authoring-Tools (CIF Add-on) und CIF Client-seitigen Komponenten verwendet.

Für jede AEM as a Cloud Service-Umgebung kann eine andere GraphQL-Endpunkt-URL verwendet werden. Auf diese Weise können Projekte AEM-Staging-Umgebungen, die über Commerce-Staging-Systeme und eine AEM-Produktionsumgebung verfügen, mit einem Commerce-Produktionssystem verbinden. Der entsprechende-GraphQL-Endpunkt muss öffentlich verfügbar sein; private VPN- oder lokale Verbindungen werden nicht unterstützt. Optional kann ein Authentifizierungs-Header bereitgestellt werden, um zusätzliche CIF Funktionen zu verwenden, für die eine Authentifizierung erforderlich ist.

Optional und nur für Adobe Commerce Enterprise/Cloud unterstützt das CIF Add-on die Verwendung von gestaffelten Katalogdaten für AEM Autoren. Für diese Daten müssen Sie einen Autorisierungs-Header konfigurieren. Diese Kopfzeile ist aus Sicherheitsgründen nur in AEM Autoreninstanzen verfügbar und wird verwendet. AEM Veröffentlichungsinstanzen können keine gestaffelten Daten anzeigen.

Es gibt zwei Optionen zum Konfigurieren des Endpunkts:

Über die Benutzeroberfläche von Cloud Manager (Standard)

Diese Konfiguration kann über ein Dialogfeld auf der Seite "Umgebungsdetails"durchgeführt werden. Wenn Sie diese Seite für ein Commerce-aktiviertes Programm anzeigen, wird eine Schaltfläche angezeigt, wenn der Endpunkt derzeit nicht konfiguriert ist:

CM-Umgebungsinformationen

Durch Klicken auf diese Schaltfläche wird ein Dialogfeld geöffnet:

CM-Commerce-Endpunkt

Nachdem der Endpunkt und optional ein Autorisierungsheader für die staging-Katalogunterstützung festgelegt wurden, wird der Endpunkt auf der Detailseite angezeigt. Klicken Sie auf das Symbol Bearbeiten , um dasselbe Dialogfeld zu öffnen, in dem Sie den Endpunkt bei Bedarf bearbeiten können.

CM-Umgebungsinformationen

Über Adobe I/O CLI

Gehen Sie wie folgt vor, um AEM über Adobe I/O CLI mit einer Commerce-Lösung zu verbinden:

  1. Adobe I/O CLI mit dem Cloud Manager-Plug-in abrufen

    Überprüfen Sie die Dokumentation zu Adobe Cloud Manager Informationen zum Herunterladen, Einrichten und Verwenden des ADOBE I/O CLI mit dem Cloud Manager-CLI-Plug-in.

  2. Adobe I/O CLI mit dem AEM as a Cloud Service-Programm authentifizieren

  3. COMMERCE_ENDPOINT-Variable in Cloud Manager festlegen

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
    

    Weitere Informationen finden Sie in den CLI-Dokumentationen.

    Die Commerce-GraphQL-Endpunkt-URL muss auf den GraphQL-Service von Magento verweisen und eine sichere HTTPS-Verbindung nutzen. Beispiel: https://<yourcommercesystem>/graphql.

  4. Aktivieren von Funktionen für gestaffelte Katalogdaten, für die eine Authentifizierung erforderlich ist (optional)

    HINWEIS

    Diese Funktion ist nur mit Adobe Commerce Enterprise oder Cloud Edition verfügbar. Weitere Informationen finden Sie unter Token-basierte Authentifizierung.

    Legen Sie die COMMERCE_AUTH_HEADER-Geheimnis-Variable in Cloud Manager fest:

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
    
TIPP

Sie können alle Cloud Manager-Variablen mithilfe des folgenden Befehls zur Überprüfung auflisten: aio cloudmanager:list-environment-variables ENVIRONMENT_ID

Sie können AEM Commerce as a Cloud Service verwenden und Ihr Projekt über Cloud Manager bereitstellen.

Konfigurieren von Stores und Katalogen

Das CIF-Add-on und das CIF Kernkomponenten kann auf mehreren AEM Site-Strukturen verwendet werden, die mit verschiedenen Commerce-Stores (oder Store-Ansichten usw.) verbunden sind. Standardmäßig wird das CIF-Add-on mit einer Standardkonfiguration bereitgestellt, die mit dem Standardspeicher und -katalog von Adobe Commerce verbunden ist.

Diese Konfiguration kann mithilfe der CIF-Cloud Service-Konfiguration wie folgt für das Projekt angepasst werden:

  1. Gehen Sie AEM zu Tools > Cloud Service > CIF Konfiguration .

  2. Wählen Sie die Commerce-Konfiguration aus, die Sie ändern möchten.

  3. Öffnen Sie die Konfigurationseigenschaften über die Aktionsleiste.

CIF-Cloud Services-Konfiguration

Die folgenden Eigenschaften können konfiguriert werden:

  • GraphQL-Client – Wählen Sie den konfigurierten GraphQL-Client für die Commerce-Backend-Kommunikation aus. Dieser Client sollte normalerweise standardmäßig beibehalten werden.
  • Shop-Ansicht – die Kennung der Shop-Ansicht. Wenn leer, wird die standardmäßige Store-Ansicht verwendet.
  • GraphQL-Proxy-Pfad – der URL-Pfad des GraphQL-Proxy in AEM, der als Proxy für Anfragen an den Commerce-Backend-GraphQL-Endpunkt verwendet wird.
    HINWEIS

    In den meisten Setups wird der Standardwert /api/graphql darf nicht geändert werden. Nur komplexere Setups, die nicht den bereitgestellten GraphQL-Proxy verwenden, sollten diese Einstellung ändern.

    - Unterstützung der Catalog-UID aktivieren – aktiviert die Unterstützung für UID anstelle von ID in den Commerce-Backend-GraphQL-Aufrufen.
    HINWEIS

    Unterstützung für UIDs wurde in Adobe Commerce 2.4.2 eingeführt. Aktivieren Sie UIDs nur, wenn Ihr Commerce-Backend ein GraphQL-Schema der Version 2.4.2 oder höher unterstützt.

    - Kennung der Stammkategorie des Katalogs – die Kennung (UID oder ID) des Stammverzeichnisses des Shops
    VORSICHT

    Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id entfernt und durch uid ersetzt. Wenn Ihr Projekt Version 2.0.0 der CIF-Kernkomponenten verwendet, müssen Sie die Unterstützung der Catalog-UID aktivieren und eine gültige Kategorie-UID als „Katalogstamm-Kategorienkennung“ verwenden.

Die oben dargestellte Konfiguration dient als Referenz. Projekte sollten ihre eigenen Konfigurationen bereitstellen.

Für komplexere Setups finden Sie unter Verwendung mehrerer AEM Site-Strukturen in Kombination mit verschiedenen Commerce-Katalogen die Commerce-Multi-Store-Einrichtung Tutorial.

Zusätzliche Ressourcen

Auf dieser Seite