Développement d’AEM Commerce

Le développement AEM projets Commerce basés sur Commerce Integration Framework (CIF) pour AEM suit les mêmes règles et bonnes pratiques que les autres projets d’AEM. Veuillez d’abord examiner les éléments suivants :

Développement local pour AEM Commerce

Un environnement de développement local est recommandé pour travailler avec des projets CIF.

REMARQUE

Les instructions suivantes vous aident à configurer un environnement de développement d’AEM local pour AEM Commerce à l’aide de CIF avec la cible d’action pour la version 6.5 d’). Si vous utilisez AEM en tant que Cloud Service, consultez la documentation AEM Commerce as a Cloud Service.

Module complémentaire Commerce AEM pour AEM 6.5 alias. Le module complémentaire CIF est également disponible pour le développement local et est fourni sous la forme d’un module AEM. Il peut être téléchargé à partir du portail de distribution de logiciels en tant que Feature Pack.

Logiciels requis

Les logiciels suivants doivent être installés localement :

Accès au module complémentaire CIF

Le module complémentaire CIF peut être téléchargé à partir du portail de distribution de logiciels, recherchez "AEM module complémentaire Commerce".

CONSEIL

Veillez à toujours utiliser la dernière version du module complémentaire CIF.

Configuration locale

Pour le développement de projet CIF local à l’aide de l’AEM et du module complémentaire CIF, procédez comme suit :

  1. Procurez-vous la version AEM 6.5 et installez le Service Pack AEM 6.5. AEM 6.5 Service Pack 7 est requis, mais nous vous recommandons d’installer le dernier Service Pack disponible.

  2. Décompressez le fichier AEM .jar pour créer le dossier crx-quickstart et exécutez :

    java -jar <jar name> -unpack
    
  3. Créez un dossier crx-quickstart/install.

  4. Copiez tous les modules complémentaires CIF, téléchargés à partir du portail de distribution de logiciels, dans le dossier crx-quickstart/install.

CONSEIL

Le module complémentaire CIF peut également être installé via Package Manager.

  1. Démarrez AEM démarrage rapide

Vérifiez la configuration via la console OSGI : http://localhost:4502/system/console/osgi-installer. La liste doit inclure les lots liés au module complémentaire CIF, les configurations content-package et OSGI. Assurez-vous que tous les lots sont démarrés.

Configuration du projet

Il existe deux façons de démarrer votre projet Commerce AEM à l’aide de CIF.

Utilisation de l’archétype de projet AEM

L’archétype de projet AEM est le principal outil utilisé pour démarrer un projet préconfiguré afin de démarrer avec CIF. Les composants principaux CIF et toutes les configurations requises peuvent être inclus dans un projet généré avec une option supplémentaire.

CONSEIL

Utilisez la version 25 ou ultérieure de l’archétype de projet AEM pour générer le projet.

Reportez-vous aux instructions d’utilisation de l’archétype de projet AEM pour savoir comment générer un projet AEM. Pour inclure CIF dans le projet, utilisez l’option includeCommerce.

Par exemple :

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

Les composants principaux CIF peuvent être utilisés dans n’importe quel projet en incluant le module all fourni ou individuellement en utilisant le module de contenu CIF et les lots OSGI associés. Pour ajouter manuellement des composants principaux CIF à un projet, utilisez les dépendances suivantes :

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

Utilisation du magasin de référence Venia AEM

Une deuxième manière de démarrer un projet CIF consiste à cloner et à utiliser le magasin de référence Venia AEM. Le magasin de référence Venia AEM est un exemple d’application storefront de référence qui illustre l’utilisation des composants principaux CIF pour AEM. Il s’agit d’un ensemble de bonnes pratiques et d’un point de départ potentiel pour développer vos propres fonctionnalités.

Pour commencer à utiliser le magasin de référence Venia, il vous suffit de cloner le référentiel Git et de commencer à personnaliser le projet en fonction de vos besoins.

REMARQUE

Le projet de magasin de référence Venia contient deux profils de version pour AEM as a Cloud Service et AEM 6.5. Reportez-vous au fichier readme.md du projet pour savoir comment ces profils sont utilisés. Pour AEM 6.5, utilisez le profil classic.

Connexion d’AEM à Commerce System

Pour connecter votre projet au système de commerce, AEM doit être configuré avec le point d’entrée GraphQL de votre système de commerce.

Tous deux, un projet généré par AEM Project Archetype ou AEM Venia Reference Store, incluent déjà une configuration par défaut qui doit être ajustée.

Remplacez la valeur de url dans com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json par le point d’entrée GraphQL de votre système commercial utilisé par le projet.

Le module complémentaire Commerce AEM et les composants principaux CIF se connectent au point d’entrée Commerce GraphQL via le serveur AEM et directement via le navigateur. Par défaut, les composants principaux CIF côté client et les outils de création du module complémentaire CIF se connectent à /api/graphql. Si nécessaire, vous pouvez l’ajuster via la configuration du Cloud Service CIF (voir ci-dessous).

Le module complémentaire CIF fournit une servlet proxy GraphQL à l’adresse /api/graphql. Si vous ne prévoyez pas d’utiliser un Dispatcher d’AEM local, il est recommandé de configurer également le servlet proxy GraphQL.

Accédez à http://localhost:4502/system/console/configMgr et créez une configuration OSGI pour le service Adobe CIF GraphQL Proxy Configuration. Utilisez le même point d’entrée GraphQL de votre système commercial que celui utilisé pour le client GraphQL ci-dessus.

Ressources supplémentaires

Sur cette page