Erste Schritte mit AEM Content and 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.

Onboarding

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 von der Softwareverteilung Portal.

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.

Von der AEM Projektarchetypund die Venia-Referenzspeicher AEM , die bereits im Standardkonfiguration muss angepasst werden.

Ersetzen Sie den Wert der url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json mit dem 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 standardmäßig /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 die optional für lokale Entwicklung. 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 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 in 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 normalerweise auf der Standardeinstellung bleiben.
  • Shop-Ansicht – die Kennung der Shop-Ansicht. Wenn leer, wird die standardmäßige Shop-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 darf der Standardwert /api/graphql 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

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

Komplexere Setups mit mehreren AEM-Website-Strukturen in Kombination mit verschiedenen Commerce-Katalogen finden Sie im Tutorial Einrichten von mehreren Commerce-Shops.

Zusätzliche Ressourcen

Auf dieser Seite