Utveckla AEM Commerce develop

Utveckla AEM Commerce-projekt som bygger på Commerce integration framework (CIF) för AEM följer samma regler och bästa praxis som i andra AEM-projekt. Granska följande först:

Lokal utveckling för AEM Commerce local

En lokal utvecklingsmiljö rekommenderas för CIF-projekt.

AEM Commerce-tillägget för AEM, så kallat CIF-tillägget, finns även för lokal utveckling och tillhandahålls som ett AEM-paket. Den kan hämtas från portalen för programvarudistribution som ett funktionspaket.

Nödvändig programvara

Följande bör installeras lokalt:

Åtkomst till CIF-tillägget

CIF-tillägget kan hämtas från portalen för programvarudistribution, sök efter AEM Commerce add-on.

Lokal installation

Gör följande för lokal projektutveckling i CIF med AEM och tilläggsprogrammet CIF:

Verifiera konfigurationen via OSGI-konsolen: http://localhost:4502/system/console/osgi-installer. Listan ska innehålla CIF tilläggspaket, innehållspaket och OSGI-konfigurationer. Se till att alla paket har startats.

Projektinställningar project

Det finns två sätt att starta AEM Commerce-projekt med CIF.

Använd AEM Project Archetype

AEM Project Archetype är huvudverktyget för Bootstrap, ett förkonfigurerat projekt för att komma igång med CIF. CIF Core Components och alla nödvändiga konfigurationer kan inkluderas i ett genererat projekt med ett extra alternativ.

Se användningsinstruktioner för AEM Project Archetype om hur du genererar ett AEM-projekt. Använd alternativet includeCommerce om du vill inkludera CIF i projektet.

Till exempel:

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

Du kan använda CIF Core Components i alla projekt. Inkludera bara det tillhandahållna all-paketet eller använd CIF-innehållspaketet och tillhörande OSGi-paket separat. Lägg till CIF Core Components i ett projekt manuellt med hjälp av följande beroenden:

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

Använd AEM Venia-referensarkiv

Ett andra alternativ för att starta ett CIF-projekt är att klona och använda AEM Venia Reference Store. AEM Venia Reference Store är ett exempel på hur CIF Core Components används för AEM. Det är avsett som en uppsättning med metodtips och en potentiell utgångspunkt för att utveckla din egen funktionalitet.

Kom igång med Venedig Reference Store genom att klona Git-databasen och börja anpassa projektet efter dina behov.

Anslut AEM till Commerce System

För att kunna ansluta ditt projekt till e-handelssystemet måste AEM konfigureras med GraphQL slutpunkt i e-handelssystemet.

Båda, ett projekt som genererats av AEM Project Archetype eller AEM Venia Reference Store, innehåller redan en standardkonfiguration som måste justeras.

Ersätt värdet för url i com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json med GraphQL-slutpunkten för det e-handelssystem som används av projektet.

AEM Commerce-tillägget och CIF Core Components ansluter till Commerce GraphQL-slutpunkten via AEM-servern. Eller direkt från webbläsaren. Klientbaserade CIF Core Components och CIF tilläggsredigeringsverktyg ansluter som standard till /api/graphql. Om det behövs kan du justera det med hjälp av CIF Cloud Service-konfigurationen (se nedan).

CIF-tillägget tillhandahåller en GraphQL-proxyserver på /api/graphql. Om du inte tänker använda en lokal AEM Dispatcher rekommenderar vi att du även konfigurerar GraphQL proxyserver.

Gå till http://localhost:4502/system/console/configMgr och skapa en OSGI-konfiguration för tjänsten Adobe CIF GraphQL Proxy Configuration. Använd samma GraphQL-slutpunkt i e-handelssystemet som för GraphQL-klienten ovan.

Ytterligare resurser