Ontwikkeling AEM Commerce develop

Voor de ontwikkeling 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 CIF projecten.

NOTE
De volgende instructies helpen u bij het instellen van een lokale AEM-ontwikkelomgeving voor AEM Commerce die CIF gebruikt met focus voor AEM 6.5). Als u AEM as a Cloud Service gebruikt, zie AEM de as a Cloud Servicedocumentatie van Commerce.

De AEM Commerce Add-On voor AEM 6.5 ook bekend. CIF Add-On is ook beschikbaar voor lokale ontwikkeling en wordt als een AEM pakket geleverd. Het kan van het portaal van de Distributie van de Softwareals eigenschappak worden gedownload.

Vereiste software

Het volgende moet lokaal worden geïnstalleerd:

Toegang tot de CIF

CIF toe:voegen-op kan van het portaal van de Distributie van de Software worden gedownload, onderzoek naar "AEM Commerce toe:voegen-op".

TIP
Zorg ervoor u altijd de recentste versie CIF toe:voegen-aan gebruikt.

Lokale instellingen

Voor de ontwikkeling van lokale CIF projecten met behulp van de AEM en de CIF:

  1. Krijg AEM 6.5 versie en installeer AEM 6.5 Service Pack. AEM 6.5 Service Pack 7 is vereist, nochtans adviseert de Adobe installerend het laatste beschikbare de dienstpak.

  2. Pak de AEM .jar uit om de map crx-quickstart te maken en voer de volgende handelingen uit:

    code language-bash
    java -jar <jar name> -unpack
    
  3. Een crx-quickstart/install -map maken

  4. Kopieer de CIF add-on alle pakketten, gedownload van de Software Distribution Portal, naar de map crx-quickstart/install .

TIP
U kunt het CIF invoegpakket ook installeren via Package Manager.
  1. Start de AEM

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 te starten met CIF.

Projectarchetype AEM gebruiken

Het AEM Archetype van het Projectis het belangrijkste hulpmiddel om een vooraf gevormd project op te starten om met CIF te beginnen. CIF de Componenten van de Kern en alle vereiste configuraties kunnen in een geproduceerd project met één extra optie worden omvat.

TIP
Het gebruik AEM Archetype 25 van het Project of recenterom het project te produceren.

Zie AEM het gebruiksinstructies van de Archetype van het Project 🔗 op hoe te om een AEM project 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 kunnen in elk project worden gebruikt door ofwel het meegeleverde all -pakket op te nemen ofwel het individuele pakket met CIF inhoud en verwante OSGI-bundels. Om CIF de Componenten van de Kern 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 CIF project te beginnen is het AEM de Opslag van de Verwijzing van Veniate klonen en te gebruiken. De AEM Venia Reference Store is een voorbeeldtoepassing van de verwijzingsopslag 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.

NOTE
Het Venia Reference Store-project bevat twee buildprofielen voor AEM as a Cloud Service en AEM 6.5. Controleer project readme.mdom te zien hoe zij worden gebruikt. Gebruik voor AEM 6.5 het profiel classic .

AEM verbinden met het Commerce-systeem

Om uw project met het handelssysteem te verbinden AEM moet met het eindpunt van GraphQL van uw handelssysteem worden gevormd.

Zowel, omvat een project dat door het AEM Archieftype van het Projectof AEM de Opslag van de Verwijzing van 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 toe:voegen-aan en CIFComponenten van de Kern verbinden met het handelsGraphQL eindpunt via de AEM server en direct via browser. Client-side CIF Core Components and CIF Add-on authoring tools by default connect to /api/graphql. Indien nodig kan dit worden aangepast via de configuratie van de CIF Cloud Service (zie hieronder).

De CIF add-on biedt een GraphQL-proxyservlet op /api/graphql . Als u niet van plan bent om een lokale AEM Dispatcher te gebruiken, wordt het geadviseerd om de volmachtsservlet van GraphQL eveneens te vormen.

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.

Aanvullende bronnen

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2