Erste Schritte mit AEM Content and Commerce
- Themen:
- Commerce Integration Framework
Erstellt für:
- Admin
- Entwickler
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:
-
Installieren des AEM Content and Commerce-Add-Ons für AEM 6.5
-
Verbinden von AEM mit Ihrem E-Commerce-System
Installieren des AEM Content and Commerce-Add-Ons für AEM 6.5
Laden Sie das AEM Commerce-Add-On für AEM 6.5 vom Softwareverteilungs-Portal herunter.
Starten und installieren Sie das erforderliche AEM 6.5 Service Pack. Es wird empfohlen, das neueste verfügbare Service Pack zu installieren.
Verbinden von AEM mit Ihrem E-Commerce-System
AEM kann mit jedem E-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 Projekt-Setup über private VPN- oder lokale Verbindungen verbunden werden.
Optional kann ein Authentifizierungs-Header bereitgestellt werden, um zusätzliche CIF-Funktionen zu verwenden, die eine Authentifizierung erfordern.
Projekte, die mit dem AEM-Projektarchetyp generiert werden, und der AEM Venia Referenz-Store, der bereits in der Standardkonfiguration enthalten ist, müssen angepasst werden.
Ersetzen Sie den Wert der url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
durch den GraphQL-Endpunkt Ihres E-Commerce-Systems. Diese Konfiguration kann über die OSGI-Konsole oder durch Bereitstellung der OSGI-Konfiguration über das Projekt vorgenommen werden. Verschiedene Konfigurationen für Staging- und Produktionssysteme werden durch unterschiedliche AEM-Ausführungsmodi unterstützt.
Das AEM Content and Commerce-Add-On und die CIF-Kernkomponenten verwenden sowohl AEM-Server- als auch Client-seitige Verbindungen. Client-seitige CIF-Kernkomponenten und CIF-Add-On-Authoring-Tools können standardmäßig mit /api/graphql
verbunden werden. Dies kann bei Bedarf über die CIF-Cloud Service-Konfiguration angepasst werden (siehe unten).
Das CIF Add-On stellt unter /api/graphql
ein GraphQL-Proxy-Servlet zur Verfügung, das optional für die lokale Entwicklung genutzt werden kann. Für Produktionsbereitstellungen wird dringend empfohlen, einen Reverse-Proxy für den Commerce-GraphQL-Endpunkt über den AEM-Dispatcher oder auf anderen Netzwerkebenen (wie CDN) einzurichten.
Konfigurieren von Stores und Katalogen
Das Add-on und die CIF-Kernkomponenten können auf mehreren AEM-Website-Strukturen verwendet werden, die mit verschiedenen E-Commerce-Stores (oder Store-Ansichten usw.) verbunden sind. Standardmäßig wird das CIF-Add-On mit einer Standardkonfiguration bereitgestellt, die eine Verbindung mit dem Standard-Store und -Katalog von Adobe Commerce herstellt.
Diese Konfiguration kann mithilfe der CIF-Cloud Service-Konfiguration wie folgt für das Projekt angepasst werden:
-
Gehen Sie in AEM zu „Tools“ > „Cloud Services“ > „CIF-Konfiguration“
-
Wählen Sie die Commerce-Konfiguration aus, die Sie ändern möchten
-
Öffnen Sie die Konfigurationseigenschaften über die Symbolleiste
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.
-
Store-Ansicht – die Kennung der Store-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 GraphQL-Endpunkt für das Commerce-Backend verwendet wird.
NOTEIn 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.
NOTEDie 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
CAUTIONAb Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung fürid
entfernt und durchuid
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.