Erste Schritte mit AEM Content und Commerce

Um mit AEM Content and Commerce zu beginnen, müssen Sie das AEM Content and Commerce Add-On für AEM 6.5 installieren.

Mindestanforderung an Software

AEM 6.5 Service Pack 7 oder höher ist erforderlich.

Einstieg

Das Onboarding für AEM Content and Commerce erfolgt in zwei Schritten:

  1. Installieren Sie das AEM Content and Commerce Add-On für AEM 6.5

  2. AEM mit Ihrer Commerce-Lösung verbinden

Installieren Sie das AEM Content and Commerce Add-On für AEM 6.5

Laden Sie das AEM Commerce Add-On für AEM 6.5 vom Software Distribution-Portal herunter und installieren Sie es.

Starten und installieren Sie das erforderliche AEM 6.5 Service Pack. Es wird empfohlen, das letzte verfügbare Service Pack zu installieren.

HINWEIS

Dies wird vom CSE für AEM Managed Service-Kunden durchgeführt.

AEM mit Ihrem Commerce-System verbinden

AEM können mit jedem Commerce-System verbunden werden, das über einen zugänglichen GraphQL-Endpunkt für AEM verfügt. Diese Endpunkte sind in der Regel öffentlich verfügbar oder können je nach Projekteinrichtung über private VPN- oder lokale Verbindungen verbunden werden.

Optional kann ein Authentifizierungs-Header bereitgestellt werden, um zusätzliche CIF-Funktionen zu verwenden, für die eine Authentifizierung erforderlich ist.

Projekte, die vom AEM Projektarchetyp und vom AEM Venia Reference Store generiert wurden, der bereits in der standardmäßigen Konfiguration enthalten ist, müssen angepasst werden.

Ersetzen Sie den Wert von url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json durch den GraphQL-Endpunkt Ihres Commerce-Systems. Diese Konfiguration kann über die OSGi-Konsole oder durch Bereitstellung der OSGi-Konfiguration über das Projekt durchgeführt werden. Verschiedene Konfigurationen für Staging- und Produktionssysteme werden mit verschiedenen AEM Ausführungsmodi unterstützt.

Die AEM Content- und Commerce-Add-On- und CIF-Kernkomponenten verwenden sowohl AEM serverseitige als auch Client-seitige Verbindungen. Clientseitige CIF-Kernkomponenten und CIF-Add-On-Authoring-Tools verbinden sich standardmäßig mit /api/graphql. Dies kann bei Bedarf über die CIF-Cloud Service-Konfiguration angepasst werden (siehe unten).

Das CIF-Add-on stellt ein GraphQL-Proxy-Servlet unter /api/graphql bereit, das optional für lokale Entwicklung verwendet werden kann. Bei Produktionsbereitstellungen wird dringend empfohlen, einen Reverse-Proxy zum Commerce-GraphQL-Endpunkt über den AEM Dispatcher oder auf anderen Netzwerkschichten (wie CDN) einzurichten.

Konfigurieren von Stores und Katalogen

Das Add-On und die CIF-Kernkomponenten können 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 (Magento) verbunden ist.

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

  1. Navigieren Sie AEM zu Tools > Cloud Services > CIF-Konfiguration .

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

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

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. Dies sollte in der Regel standardmäßig beibehalten werden.

  • Store View - die Kennung der (Magento-)Store-Ansicht. Wenn leer, wird die standardmäßige Store-Ansicht verwendet.

  • GraphQL-Proxy-Pfad - der URL-Pfad GraphQL-Proxy in AEM zum Proxy von Anforderungen an den Commerce-Backend-GraphQL-Endpunkt verwendet wird.

    HINWEIS

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

  • Unterstützung der Catalog-UID aktivieren - Aktivieren Sie die Unterstützung für UID anstelle der ID in den Commerce-Backend-GraphQL-Aufrufen.

    HINWEIS

    Die Unterstützung für UIDs wurde in Adobe Commerce (Magento) 2.4.2 eingeführt. Aktivieren Sie dies 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 Stores

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

Komplexere Setups mit mehreren AEM Site-Strukturen in Kombination mit verschiedenen Commerce-Katalogen finden Sie im Tutorial Commerce Multi-Store Setup .

Zusätzliche Ressourcen

Auf dieser Seite