Utveckla AEM Commerce develop

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

Local Development for AEM Commerce local

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

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

Nödvändig programvara

Följande bör installeras lokalt:

Använda CIF Add-on

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

Lokal installation

För lokal projektutveckling i CIF med tillägget AEM och 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 att starta 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

CIF Core Components kan användas i alla projekt, antingen genom att inkludera det tillhandahållna all-paketet eller genom att använda CIF innehållspaket och relaterade OSGI-paket. Om du vill lägga till CIF Core-komponenter 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 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.

Börja med 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 Add-On och CIF Core Components ansluter till GraphQL-slutpunkten för e-handel via AEM-servern och direkt via webbläsaren. Klientsidan med CIF Core Components och CIF Add-On-redigeringsverktyg ansluter som standard till /api/graphql. Om det behövs kan detta justeras via 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.

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