Show Menu
SUJETS×

Développer le commerce AEM pour l'AEM en tant que Cloud Service

Le développement de projets de commerce AEM basés sur le cadre d'intégration commerciale (CIF) pour l'AEM en tant que Cloud Service suit les mêmes règles et bonnes pratiques que d'autres projets d'AEM sur l' en tant que Cloud Service. Veuillez d'abord les lire :

Développement local avec AEM comme SDK Cloud Service


Un environnement de développement local est recommandé pour travailler avec les projets du FCI. L'Ajoute du FCI, qui permet l'AEM en tant qu'environnement Cloud Service, est également disponible pour le développement local. Il peut être téléchargé à partir du portail de distribution de logiciels.
L’Ajoute CIF est fournie sous la forme d’une archive de fonctionnalité Sling. Le fichier zip disponible sur le portail de distribution de logiciels comprend deux fichiers d’archives de fonctionnalités Sling, l’un pour l’auteur AEM et l’autre pour les instances de publication AEM.

Logiciels requis

Les éléments suivants doivent être installés localement :

Accès au module complémentaire CIF

The CIF add-on can be downloaded as a zip file from the Software Distribution portal . Le fichier zip contient le module complémentaire CIF en tant qu’archive de fonctionnalité Sling, il ne s’agit pas d’un package AEM. Notez que l’accès aux listes de SDK est limité à celles avec AEM en tant que licence Cloud Service.
Veillez à toujours utiliser la dernière version d’Ajoute CIF.

Configuration locale

Pour le développement d’Ajoutes CIF locales à l’aide de l’AEM en tant que SDK Cloud Service, procédez comme suit :
  1. Nouveautés AEM en tant que SDK Cloud Service
  2. Décompressez le fichier AEM .jar pour créer le crx-quickstart dossier, exécutez :
    java -jar <jar name> -unpack
    
    
  3. Create a crx-quickstart/install folder
  4. Copiez le fichier d’archive des fonctionnalités Sling du module complémentaire CIF dans le crx-quickstart/install dossier.
    Le fichier zip du module complémentaire CIF contient deux .far fichiers d’archives de la fonctionnalité Sling. Assurez-vous d’utiliser l’AEM appropriée pour AEM Author ou AEM Publish, selon la manière dont vous envisagez d’exécuter l’locale en tant que SDK Cloud Service.
  5. Créez une variable d’environnement système d’exploitation locale nommée COMMERCE_ENDPOINT contenant le point de terminaison GraphQL Magento.
    Exemple Mac OSX :
    export COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    
    
    Exemple de fenêtres :
    set COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    
    
    Cette variable doit également être configurée pour l’AEM en tant qu’environnement Cloud Service.
  6. Début de l’AEM en tant que SDK Cloud Service
  7. Début du serveur proxy GraphQL local
    Pour rendre le point de terminaison GraphQL Magento disponible localement pour le module complémentaire CIF et les composants CIF, utilisez la commande suivante. Le point de terminaison GraphQL sera alors disponible à http://localhost:3002/graphql . Exemple Mac OSX :
    npx local-cors-proxy --proxyUrl https://demo.magentosite.cloud --port 3002 --proxyPartial ''
    
    
    Exemple de fenêtres :
    npx local-cors-proxy --proxyUrl https://demo.magentosite.cloud --port 3002 --proxyPartial '""'
    
    
    L'argument --proxyPartial doit recevoir une chaîne vide.
    Vous pouvez tester le proxy GraphQL local en pointant un outil de requête GraphQL vers http://localhost:3002/graphql et en testant quelques requêtes.
  8. Connectez-vous à AEM SDK et configurez CIF pour utiliser le serveur proxy GraphQL local.
    Accédez à la configuration du Cloud Service CIF (Outils > Cloud Services > Configuration CIF). Ouvrez la vue de propriétés de la configuration utilisée par votre projet.
    Pour la GraphQL Proxy Path propriété, utilisez le point de terminaison du serveur proxy local http://localhost:3002/graphql . Enregistrez la configuration.
N’insérez pas la configuration de l’étape 8 dans le référentiel du projet. Cette configuration n'est requise que pour une configuration de développement local. aem en tant qu'environnements Cloud Service sont déjà configurés avec le proxy GraphQL lors de l'intégration.
Vérifiez la configuration via la console OSGI : http://localhost:4502/system/console/osgi-installer . La liste doit inclure les lots de module complémentaire CIF, les configurations content-package et OSGI associés, comme défini dans le fichier de modèle de fonctionnalité.

Configuration du projet

Il existe deux façons d'amorcer votre projet CIF pour AEM en tant que Cloud Service.

Utiliser l'archétype de projet AEM

L'archétype de projet AEM est le principal outil pour amorcer un projet préconfiguré pour démarrer avec le FIC. Les composants de base CIF et toutes les configurations requises peuvent être inclus dans un projet généré avec une option supplémentaire.
Utilisez AEM Project Archetype 24 ou version ultérieure pour générer le projet.
Voir les instructions aem-project-archetype#usage d'utilisation de l'archétype de projet AEM pour savoir comment générer un projet AEM. Pour inclure le FIC dans le projet, utilisez l' includeCommerce option.
Par exemple :
mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

Les composants de base CIF peuvent être utilisés dans tout projet en incluant le all package fourni ou individuellement en utilisant le package de contenu CIF et les lots OSGI connexes. 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-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>

Utiliser AEM Venia Reference Store

Une deuxième option pour début d'un projet CIF consiste à cloner et à utiliser l' AEM Venia Reference Store . Le magasin de référence d'AEM Venia est un exemple d'application de vitrine de référence qui montre l'utilisation des composants principaux de CIF pour l'AEM. Il s’agit d’un ensemble d’exemples de bonnes pratiques ainsi que d’un point de départ potentiel pour développer votre propre fonctionnalité.
Pour commencer avec le Venia Reference Store, il vous suffit de cloner le référentiel Git et de personnaliser le projet en fonction de vos besoins.
Le projet Venia Reference Store contient deux profils de génération pour AEM en tant qu'Cloud Service et AEM 6.5. Consultez le projet readme.md pour voir comment ils sont utilisés.