Utveckla AEM Commerce develop

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

Local Development for AEM Commerce local

En lokal utvecklingsmiljö rekommenderas för CIF.

AEM Commerce Add-On för AEM 6.5 alias. CIF Add-On finns även för lokal utveckling och tillhandahålls som ett AEM. Den kan hämtas från Software Distribution Portal som ett funktionspaket.

Nödvändig programvara

Följande bör installeras lokalt:

Åtkomst till CIF

Det CIF tillägget kan hämtas från portalen för programvarudistribution. Sök efter AEM Commerce-tillägg.

Lokal installation

För lokal CIF projektutveckling med AEM och CIF steg:

Verifiera konfigurationen via OSGI-konsolen: http://localhost:4502/system/console/osgi-installer. Listan ska innehålla de CIF tilläggspaketen, innehållspaketet 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 projekttyp

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

Se AEM användningsinstruktioner 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

CIF kärnkomponenter kan användas i alla projekt, antingen genom att inkludera det angivna all-paketet eller genom att använda det CIF innehållspaketet och relaterade OSGI-paket. Om du vill lägga till CIF kärnkomponenter manuellt i ett projekt använder du 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 Reference Store

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

Börja med att klona Git-databasen och börja anpassa projektet efter dina behov.

Anslut AEM till Commerce System

För att 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 Add-On och CIF Core Components ansluter till GraphQL-slutpunkten via AEM och direkt via webbläsaren. Klientsidan CIF kärnkomponenter och redigeringsverktygen för CIF tillägg ansluter som standard till /api/graphql. Vid behov kan detta justeras via CIF Cloud Service-konfigurationen (se nedan).

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

Navigera 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