Entwicklung AEM Commerce

Die Entwicklung AEM Commerce-Projekte auf der Grundlage des Commerce Integration Framework (CIF) für AEM folgt denselben Regeln und Best Practices wie andere AEM Projekte. Sehen Sie sich zuerst die folgenden Artikel an:

Lokale Entwicklung für AEM Commerce

Für die Arbeit mit CIF-Projekten wird eine lokale Entwicklungsumgebung empfohlen.

HINWEIS

Die folgenden Anweisungen helfen Ihnen beim Einrichten einer lokalen AEM-Entwicklungsumgebung für AEM Commerce mithilfe von CIF mit Schwerpunkt für AEM 6.5). Wenn Sie AEM als Cloud Service verwenden, lesen Sie die AEM Commerce as a Cloud Service -Dokumentation.

Das AEM Commerce-Add-on für AEM 6.5 alias. Das CIF-Add-on steht auch für die lokale Entwicklung zur Verfügung und wird als AEM Paket bereitgestellt. Sie können sie als Feature Pack vom Software Distribution-Portal herunterladen.

Erforderliche Software

Folgendes sollte lokal installiert werden:

Zugreifen auf das CIF-Add-on

Das CIF-Add-on kann vom Software Distribution-Portal heruntergeladen werden. Suchen Sie nach "AEM Commerce-Add-on".

TIPP

Stellen Sie sicher, dass Sie immer die neueste Version des CIF-Add-ons verwenden.

Lokales Setup

Für die lokale CIF-Projektentwicklung mit dem AEM und dem CIF-Add-on gehen Sie wie folgt vor:

  1. Laden Sie die AEM 6.5-Version herunter und installieren Sie das AEM 6.5 Service Pack. AEM 6.5 Service Pack 7 ist erforderlich. Wir empfehlen jedoch, das letzte verfügbare Service Pack zu installieren.

  2. Entpacken Sie die AEM.jar, um den crx-quickstart-Ordner zu erstellen, und führen Sie Folgendes aus:

    java -jar <jar name> -unpack
    
  3. Erstellen Sie einen crx-quickstart/install-Ordner.

  4. Kopieren Sie das vom Software Distribution-Portal heruntergeladene CIF-Add-on für alle Pakete in den Ordner crx-quickstart/install .

TIPP

Alternativ kann das CIF-Add-On-Paket auch über Package Manager installiert werden.

  1. Starten des AEM-Schnellstarts

Überprüfen Sie das Setup über die OSGi-Konsole: http://localhost:4502/system/console/osgi-installer. Die Liste sollte die CIF-Add-on-bezogenen Bundles, Inhaltspakete und OSGi-Konfigurationen enthalten. Stellen Sie sicher, dass alle Bundles gestartet sind.

Projekt-Setup

Es gibt zwei Möglichkeiten, Ihr AEM Commerce-Projekt mit CIF zu starten.

Verwenden des AEM-Projektarchetyps

Der AEM-Projektarchetyp ist das wichtigste Tool für das Bootstrapping eines vorkonfigurierten Projekts, um mit CIF zu beginnen. CIF-Kernkomponenten und alle erforderlichen Konfigurationen können mit einer zusätzlichen Option in ein generiertes Projekt aufgenommen werden.

TIPP

Verwenden Sie AEM-Projektarchetyp 25 oder höher, um das Projekt zu erstellen.

Weitere Informationen zum Generieren eines AEM-Projekts finden Sie in den Anweisungen zur Verwendung des AEM-Projektarchetyps. Verwenden Sie die Option includeCommerce, um CIF in das Projekt aufzunehmen.

Beispiel:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

CIF-Kernkomponenten können in jedem Projekt verwendet werden, indem entweder das bereitgestellte all-Paket oder eine Einzelperson mit dem CIF-Inhaltspaket und den zugehörigen OSGI-Bundles eingeschlossen wird. Verwenden Sie die folgenden Abhängigkeiten, um einem Projekt manuell CIF-Kernkomponenten hinzuzufügen:

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

Verwenden des AEM Venia Reference Store

Eine zweite Möglichkeit, ein CIF-Projekt zu starten, besteht darin, den AEM Venia Reference Store zu klonen und zu verwenden. Der AEM Venia Reference Store ist ein Beispiel-Referenz-Storefront-Programm, das die Verwendung von CIF-Kernkomponenten für AEM demonstriert. Es ist als Best-Practice-Satz von Beispielen und als möglicher Ausgangspunkt für die Entwicklung Ihrer eigenen Funktionalität gedacht.

Um mit dem Venia Reference Store zu beginnen, klonen Sie einfach das Git-Repository und beginnen Sie mit der Anpassung des Projekts an Ihre Anforderungen.

HINWEIS

Das Venia Reference Store-Projekt enthält zwei Build-Profile für AEM as a Cloud Service und AEM 6.5. Schauen Sie sich die Datei readme.md des Projekts an, um zu sehen, wie sie verwendet werden. Verwenden Sie für AEM 6.5 das Profil classic .

AEM mit dem Commerce-System verbinden

Um Ihr Projekt mit dem Commerce-System zu verbinden, muss AEM mit dem GraphQL-Endpunkt Ihres Commerce-Systems konfiguriert werden.

Beide Projekte, die vom AEM Projektarchetyp oder vom AEM Venia Reference Store generiert wurden, enthalten bereits eine standardmäßige Konfiguration, die angepasst werden muss.

Ersetzen Sie den Wert von url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json durch den GraphQL-Endpunkt Ihres vom Projekt verwendeten Commerce-Systems.

Die AEM Commerce-Add-On- und CIF-Kernkomponenten stellen über den AEM-Server und direkt über den Browser eine Verbindung zum Commerce-GraphQL-Endpunkt her. Clientseitige CIF-Kernkomponenten und CIF-Add-On-Authoring-Tools verbinden standardmäßig /api/graphql. Bei Bedarf kann dies über die CIF-Cloud Service-Konfiguration angepasst werden (siehe unten).

Das CIF-Add-on stellt ein GraphQL-Proxy-Servlet unter /api/graphql bereit. Wenn Sie nicht planen, einen lokalen AEM Dispatcher zu verwenden, wird empfohlen, auch das GraphQL-Proxy-Servlet zu konfigurieren.

Navigieren Sie zu http://localhost:4502/system/console/configMgr und erstellen Sie eine OSGi-Konfiguration für den Dienst Adobe CIF GraphQL Proxy Configuration . Verwenden Sie denselben GraphQL-Endpunkt Ihres Commerce-Systems wie für den GraphQL-Client oben.

Zusätzliche Ressourcen

Auf dieser Seite