Développeur d’AEM Commerce develop

Le développement de projets AEM 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 local

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

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

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 « module complémentaire AEM Commerce ».

Configuration locale

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

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

Configuration du projet project

Il existe deux façons de démarrer votre projet AEM Commerce à 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.

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 package all fourni ou individuellement en utilisant le package de contenu CIF et les bundles 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. Cette application offre des exemples de bonnes pratiques, ainsi qu’un point de départ potentiel pour développer vos propres fonctionnalités.

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

Connexion d’AEM au système Commerce

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

Un projet généré par l’Archétype de projet AEM ou le Magasin de référence Venia AEM, ajoutez déjà une configuration par défaut, qui doit être ajustée.

Remplacez la valeur de l’url dans com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json avec le point d’entrée GraphQL de votre système Commerce 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 un servlet de 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 Commerce que celui utilisé pour le client GraphQL ci-dessus.

Ressources supplémentaires