Développement d’AEM Commerce pour AEM as a Cloud Service develop
Le développement de projets AEM Commerce basés sur Commerce Integration Framework (CIF) pour AEM as a Cloud Service suit les mêmes règles et bonnes pratiques que les autres projets AEM dans AEM as a Cloud Service. Passez en revue les éléments suivants :
Développement local avec le SDK AEM as a Cloud Service local
Un environnement de développement local est recommandé pour travailler avec des projets CIF. Le module complémentaire CIF fourni pour AEM as a Cloud Service est également disponible pour le développement local. Il peut être téléchargé à partir du portail de distribution de logiciels.
Le module complémentaire est fourni sous la forme d’une archive de fonctionnalités Sling. Le fichier zip disponible sur le portail de distribution de logiciels comprend deux fichiers archivés de fonctionnalités Sling, l’un pour l’auteur AEM et l’autre pour les instances de publication AEM.
>Consultez un guide plus détaillé de configuration d’environnement de développement local à l’aide d’AEM as a Cloud Service SDK.
Logiciels requis required-software
Les logiciels suivants doivent être installés localement :
- SDK AEM as a Cloud Service
- Java™ 11
- Apache Maven (3.3.9 ou version ultérieure)
- Node.js v10+
- npm 6+
- Git
Accès au module complémentaire CIF accessing-add-on
Le module complémentaire CIF peut être téléchargé sous la forme d’un fichier zip à partir du portail Distribution de logiciels . Le fichier zip contient le module complémentaire CIF en tant qu’archive des fonctionnalités Sling, il ne s’agit pas d’un package AEM. Les listes de SDK sont accessibles avec une licence AEM as a Cloud Service.
Configuration locale local-setup
Pour le développement local du module complémentaire CIF à l’aide d’AEM as a Cloud Service SDK, procédez comme suit :
-
Obtenez la dernière version d’AEM as a Cloud Service SDK.
-
Décompressez le fichier AEM .jar afin de pouvoir créer le dossier
crx-quickstart. Exécutez la commande suivante :code language-bash java -jar <jar name> -unpack -
Créez un dossier
crx-quickstart/install. -
Copiez le fichier archivé de fonctionnalités Sling correct du module complémentaire CIF dans le dossier
crx-quickstart/install.- Le fichier zip du module complémentaire CIF contient deux fichiers
.fard’archive de fonctionnalités Sling. - Assurez-vous d’utiliser le fichier correspondant à AEM Author ou à AEM Publish, selon la manière dont vous envisagez d’exécuter le SDK AEM as a Cloud Service local.
- Le fichier zip du module complémentaire CIF contient deux fichiers
-
Créez une variable d’environnement de système d’exploitation locale nommée
COMMERCE_ENDPOINTet contenant le point d’entrée GraphQL d’Adobe Commerce.-
Cette variable est utilisée par AEM pour se connecter à votre système commercial. Le module complémentaire CIF comprend un proxy inverse local pour rendre le point d’entrée Commerce GraphQL disponible localement. Ce proxy est utilisé par les outils de création CIF (console de produit et sélecteurs) et pour les composants CIF côté client effectuant des appels GraphQL directs.
-
Cette variable doit également être configurée pour l’environnement AEM as a Cloud Service. Pour plus d’informations sur les variables, voir Configuration d’OSGi pour AEM as a Cloud Service.
-
Exemple sous macOS :
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql -
Exemple sous Windows :
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
-
-
(Facultatif) Pour activer les fonctionnalités de catalogue par étapes, vous devez créer un jeton d’intégration pour votre instance d’Adobe Commerce. Suivez les étapes décrites à la section Prise en main pour créer le jeton.
-
Définissez un secret OSGi portant le nom
COMMERCE_AUTH_HEADERsur la valeur suivante :code language-xml Authorization: Bearer <Access Token> -
Pour plus d’informations sur les secrets, voir Configuration d’OSGi pour AEM as a Cloud Service.
-
-
Démarrez AEM as a Cloud Service SDK.
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, le package de contenu et les configurations OSGi tels que définis dans le fichier de modèle de fonctionnalité.
Configuration du projet project
Il existe deux manières de démarrer votre projet CIF pour AEM as a Cloud Service.
Utilisation de l’archétype de projet AEM project-archetype
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 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
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 venia-reference
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, il vous suffit de cloner le référentiel Git et de personnaliser le projet en fonction de vos besoins.