AEM Commerce ontwikkelen develop
Voor de ontwikkeling van AEM Commerce-projecten op basis van Commerce integration framework (CIF) voor AEM gelden dezelfde regels en beste praktijken als voor andere AEM-projecten. Bekijk eerst deze:
Lokale ontwikkeling voor AEM Commerce local
Een lokale ontwikkelomgeving wordt aanbevolen voor het werken met CIF-projecten.
De AEM Commerce Add-On voor AEM, de zogenaamde CIF Add-On, is ook beschikbaar voor lokale ontwikkeling en wordt geleverd als een AEM-pakket. Het kan van het portaal van de Distributie van de Softwareals eigenschappak worden gedownload.
Vereiste software
Het volgende moet lokaal worden geïnstalleerd:
- Lokale AEM 6.5 LTS
- Java 17/Java 21
- Apache Maven(3.3.9 of nieuwer)
- Knoop LTS
- npm 6+
- Git
Toegang tot de CIF Add-on
CIF toe:voegen-op kan van het portaal van de Distributie van de Software worden gedownload, onderzoek naar "toe:voegen-op van AEM Commerce".
Lokale instellingen
Voor de ontwikkeling van lokale CIF-projecten met de invoegtoepassing AEM en CIF gaat u als volgt te werk:
-
Pak de AEM .jar uit om de
crx-quickstart
-map te maken. Voer de volgende handelingen uit:code language-bash java -jar <jar name> -unpack
-
Een
crx-quickstart/install
-map maken -
Kopieer de invoegtoepassing CIF naar alle pakketten die u hebt gedownload van de portal voor softwaredistributie naar de map
crx-quickstart/install
.
- De AEM-snelstart starten
Controleer de installatie via de OSGI-console: http://localhost:4502/system/console/osgi-installer
. De lijst moet de CIF add-on gerelateerde bundels, content-package en OSGI configuraties bevatten. Zorg ervoor dat alle bundels zijn gestart.
Projectinstelling project
Er zijn twee manieren om uw AEM Commerce-project met CIF te starten.
AEM Project Archetype gebruiken
Het Archetype van het Project van AEMis het belangrijkste hulpmiddel om een vooraf gevormd project op te starten om met CIF te beginnen. CIF Core Components en alle vereiste configuraties kunnen met één extra optie in een gegenereerd project worden opgenomen.
Zie het Archieftype van het Project van AEM gebruiksinstructiesop hoe te om een project van AEM te produceren. Als u CIF wilt opnemen in het project, gebruikt u de optie includeCommerce
.
Bijvoorbeeld:
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 Core Components kan in elk project worden gebruikt door het meegeleverde all
-pakket op te nemen of door een individu te gebruiken met het CIF-inhoudspakket en verwante OSGI-bundels. Om de Componenten van de Kern van CIF aan een project manueel toe te voegen gebruiken de volgende gebiedsdelen:
<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>
AEM Venia Reference Store gebruiken
Een tweede optie om een project van CIF te beginnen is de Opslag van de Verwijzing van AEM te klonen en te gebruiken Venia. De AEM Venia Reference Store is een voorbeeldtoepassing die het gebruik van CIF Core Components voor AEM aantoont. Het is bedoeld als een set voorbeelden van best practices en een mogelijk beginpunt voor het ontwikkelen van uw eigen functionaliteit.
Om met de Opslag van de Verwijzing van Venia eenvoudig te beginnen klonen de bewaarplaats van het Giten beginnen het project overeenkomstig uw behoeften aan te passen.
classic
.AEM verbinden met het Commerce-systeem
Om uw project met het handelssysteem te verbinden moet AEM met het eindpunt van GraphQL van uw handelssysteem worden gevormd.
Zowel, omvat een project dat door het Archieftype van het Project van AEMof de Opslag van de Verwijzing van AEM Veniawordt geproduceerd, reeds a gebrek configdat moet worden aangepast.
Vervang de waarde van url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
met het eindpunt van GraphQL van uw handelsysteem dat door het project wordt gebruikt.
De AEM Commerce Add-On en CIF Core Components maken via de AEM-server en rechtstreeks via de browser verbinding met het GraphQL-eindpunt voor handel. CIF Core Components voor client-side en CIF Add-On ontwerpgereedschappen maken standaard verbinding met /api/graphql
. Indien nodig kan dit worden aangepast via de CIF Cloud Service config (zie hieronder).
De invoegtoepassing CIF biedt een servlet voor GraphQL-proxy op /api/graphql
. Als u geen lokale AEM Dispatcher wilt gebruiken, wordt u aangeraden ook de proxyserver van GraphQL te configureren.
Navigeer naar http://localhost:4502/system/console/configMgr en maak een OSGI-config voor de Adobe CIF GraphQL Proxy Configuration
-service. Gebruik hetzelfde GraphQL-eindpunt van uw handelssysteem als hierboven voor de GraphQL-client.