Erste Schritte mit AEM Content and Commerce start

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 onboarding

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

  1. Installieren des AEM Content and Commerce-Add-Ons für AEM 6.5

  2. Verbinden von AEM mit Ihrem E-Commerce-System

Installieren des AEM Content and Commerce-Add-Ons für AEM 6.5 install-add-on

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.

NOTE
Für AEM Managed Service-Kunden wird dies vom CSE durchgeführt.

Verbinden von AEM mit Ihrem E-Commerce-System connect

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 catalog

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:

  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 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.

  • 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.

    note note
    NOTE
    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.

    note note
    NOTE
    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

    note caution
    CAUTION
    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 additional-resources

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2