DocumentatieAEM as a Cloud ServiceHandboek

AEM Commerce ontwikkelen voor AEM as a Cloud Service develop

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Van toepassing op:
  • Experience Manager as a Cloud Service

Gemaakt voor:

  • Beheerder

Voor de ontwikkeling van AEM Commerce-projecten op basis van Commerce integration framework (CIF) voor AEM as a Cloud Service gelden dezelfde regels en beste praktijken als voor andere AEM-projecten op AEM as a Cloud Service. Lees eerst het volgende:

Lokale ontwikkeling met AEM as a Cloud Service SDK local

https://video.tv.adobe.com/v/39476/?quality=12&learn=on

Een lokale ontwikkelomgeving wordt aanbevolen voor het werken met CIF-projecten. De CIF Add-On voor AEM as a Cloud Service is ook beschikbaar voor lokale ontwikkeling. Het kan van het portaal van de Distributie van de Software worden gedownload.

De CIF Add-On wordt geleverd als een archief met verkoopfuncties. Het ZIP-bestand dat beschikbaar is op de portal Softwaredistributie bevat twee Sling Feature-archiefbestanden: een voor AEM-auteur en een voor AEM-publicatie-exemplaren.

TIP
Nieuw aan AEM as a Cloud Service?
​>Controle uit een meer gedetailleerde gids aan vestiging een lokale ontwikkelomgeving gebruikend AEM as a Cloud Service SDK.

Vereiste software required-software

Het volgende moet lokaal worden geïnstalleerd:

Toegang tot de CIF Add-on accessing-add-on

De toe:voegen-op van CIF kan als zip dossier van het portaal van de Distributie van de Software worden gedownload. Het zip dossier bevat de toe:voegen-op van CIF als het Sling archief van de Eigenschap, is het geen pakket van AEM. SDK-aanbiedingen zijn toegankelijk met een AEM as a Cloud Service-licentie.

TIP
Gebruik altijd de nieuwste versie van CIF Add-On.

Lokale instelling local-setup

Ga als volgt te werk voor lokale ontwikkeling van de invoegtoepassing CIF met AEM as a Cloud Service SDK:

  1. Kies voor de nieuwste AEM as a Cloud Service SDK.

  2. Pak de AEM.jar uit zodat u de map crx-quickstart kunt maken. Voer de volgende opdracht uit:

    code language-bash 
    java -jar <jar name> -unpack

  3. Maak een map crx-quickstart/install .

  4. Kopieer het correcte archiefbestand voor de verkoopfunctie van de CIF-invoegtoepassing naar de map crx-quickstart/install .

    • Het ZIP-bestand van de invoegtoepassing CIF bevat twee Sling Feature archive-bestanden .far .
    • Gebruik de juiste versie voor AEM Author of AEM Publish, afhankelijk van hoe u de lokale AEM as a Cloud Service SDK wilt uitvoeren.

  5. Maak een lokale besturingssysteemomgevingsvariabele met de naam COMMERCE_ENDPOINT die het Adobe Commerce GraphQL-eindpunt vasthoudt.

    • Deze variabele wordt gebruikt door AEM om met uw handelssysteem te verbinden. De invoegtoepassing CIF bevat een lokale reverse-proxy waarmee het Commerce GraphQL-eindpunt lokaal beschikbaar wordt gemaakt. Deze proxy wordt gebruikt door de CIF-ontwerpgereedschappen (productconsole en kiezers) en voor de CIF-clientcomponenten die directe GraphQL-aanroepen uitvoeren.

    • Deze variabele moet ook voor de AEM as a Cloud Service-omgeving worden ingesteld. Voor meer informatie over variabelen, zie Vormend OSGi voor AEM as a Cloud Service.

    • Voorbeeld onder macOS:

      code language-bash 
      export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql

    • Voorbeeld onder Windows:

      code language-bash 
      set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql

  6. (Optioneel) Als u niet-actieve catalogusfuncties wilt inschakelen, moet u een integratietoken maken voor uw Adobe Commerce-instantie. Volg de stappen bij Begonnen het wordenom het teken tot stand te brengen.

    • Stel een geheim OSGi met de naam COMMERCE_AUTH_HEADER in op de volgende waarde:

      code language-xml 
      Authorization: Bearer <Access Token>

    • Voor meer informatie over geheimen, zie Vormend OSGi voor AEM as a Cloud Service.

  7. Start de AEM as a Cloud Service SDK.

NOTE
Zorg ervoor dat u AEM as a Cloud Service SDK start in hetzelfde terminalvenster. De omgevingsvariabele is ingesteld in stap 5. Als u het in een afzonderlijk eindvenster, of door het .jar dossier tweemaal te klikken begint, zorg ervoor dat de omgevingsvariabele zichtbaar is.

Verifieer de opstelling via console OSGi: http://localhost:4502/system/console/osgi-installer. De lijst moet de aan de CIF-invoegtoepassing gerelateerde bundels, het inhoudspakket en de OSGi-configuraties bevatten, zoals gedefinieerd in het bestand met het model van de functie.

Projectinstelling project

Er zijn twee manieren om uw CIF-project voor AEM as a Cloud Service te Bootstrap.

AEM Project Archetype gebruiken project-archetype

Het Archetype van het Project van AEMis het belangrijkste hulpmiddel aan Bootstrap een vooraf gevormd project om met CIF te beginnen. CIF Core Components en alle vereiste configuraties kunnen met één extra optie in een gegenereerd project worden opgenomen.

TIP
Gebruik altijd de recentste versie van het Archetype van het Project van AEMzodat kunt u het project produceren.

Zie het Archieftype van het Project van AEM gebruiksinstructiesop hoe te om een project van AEM te produceren. Als u CIF in het project wilt opnemen, gebruikt u de optie includeCommerce .

Bijvoorbeeld:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=35 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D includeCommerce=y

CIF Core Components kan in elk project worden gebruikt door het meegeleverde all -pakket op te nemen of afzonderlijk met het CIF-inhoudspakket en verwante OSGi-bundels. Om de Componenten van de Kern van CIF aan een project manueel toe te voegen, gebruik 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 venia-reference

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 aan de slag te gaan met de Venia Reference Store, kloont u de Git-opslagplaats en begint u het project aan te passen aan uw behoeften.

NOTE
Het Venia Reference Store-project bevat twee buildprofielen voor AEM as a Cloud Service en AEM 6.5. Controle project readme.mdzodat kunt u zien hoe zij worden gebruikt.

Aanvullende bronnen additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab