Prise en main d’AEM Content and Commerce

Pour commencer à utiliser AEM Content and Commerce, vous devez installer AEM module complémentaire Content and Commerce pour 6.5.

Configuration logicielle minimale requise

AEM 6.5 Service Pack 7 ou version ultérieure est requis.

Intégration

L’intégration à AEM Content and Commerce est un processus en deux étapes :

  1. Installation du module complémentaire Content and Commerce AEM pour AEM 6.5

  2. Connexion d’AEM à votre solution commerciale

Installation du module complémentaire Content and Commerce AEM pour AEM 6.5

Téléchargez et installez le module complémentaire Commerce AEM pour AEM 6.5 à partir du portail Distribution logicielle.

Démarrez et installez le Service Pack d’AEM 6.5 requis. Nous vous recommandons d’installer le dernier Service Pack disponible.

REMARQUE

Cela sera effectué par l’ingénieur du service client pour les clients AEM Managed Service.

Connexion d’AEM à votre système Commerce

AEM peut être connecté à n’importe quel système commercial disposant d’un point d’entrée GraphQL accessible pour AEM. Ces points de terminaison sont généralement disponibles publiquement ou peuvent être connectés via des connexions VPN privées ou locales selon la configuration du projet individuel.

En option, l’en-tête d’authentification peut être fourni pour utiliser des fonctionnalités CIF supplémentaires nécessitant une authentification.

Les projets générés par AEM Project Archetype et le AEM Venia Reference Store qui est déjà inclus dans la configuration par défaut doivent être ajustés.

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. Cette configuration peut être effectuée via la console OSGI ou en déployant la configuration OSGI via le projet. Les différentes configurations pour les systèmes d’évaluation et de production sont prises en charge à l’aide de différents modes d’exécution AEM.

Le module complémentaire Content and Commerce AEM et les composants principaux CIF utilisent AEM connexions côté serveur et côté client. Les composants principaux CIF côté client et les outils de création de module complémentaire CIF se connectent par défaut à /api/graphql. Cela peut être ajusté via la configuration du Cloud Service CIF si nécessaire (voir ci-dessous).

Le module complémentaire CIF fournit une servlet proxy GraphQL à l’adresse /api/graphql qui peut éventuellement être utilisée pour le développement local. Pour les déploiements de production, il est vivement recommandé de configurer un proxy inverse vers le point d’entrée GraphQL de commerce via le Dispatcher AEM ou sur d’autres couches réseau (comme CDN).

Configuration de magasins et de catalogues

Le module complémentaire et les composants principaux CIF peuvent être utilisés sur plusieurs structures de site AEM connectées à différents magasins de commerce (ou vues de magasin, etc.). Par défaut, le module complémentaire CIF est déployé avec une configuration par défaut se connectant au magasin et au catalogue par défaut d’Adobe Commerce (Magento).

Cette configuration peut être ajustée pour le projet par le biais de la configuration de Cloud Service CIF en procédant comme suit :

  1. Dans AEM, accédez à Outils -> Cloud Services -> Configuration CIF.

  2. Sélectionnez la configuration commerciale à modifier.

  3. Ouvrez les propriétés de configuration via la barre d’actions.

Configuration des Cloud Services CIF

Les propriétés suivantes peuvent être configurées :

  • Client GraphQL : sélectionnez le client GraphQL configuré pour la communication du serveur principal Commerce. Cette sélection doit généralement être maintenue par défaut.

  • Affichage de magasin : identifiant de vue de magasin (Magento). Si cette valeur est vide, la vue de magasin par défaut est utilisée.

  • Chemin du proxy GraphQL : chemin d’URL du proxy GraphQL dans AEM utilisé pour les requêtes proxy vers le point d’entrée GraphQL principal de commerce.

    REMARQUE

    Dans la plupart des configurations, la valeur par défaut /api/graphql ne doit pas être modifiée. Seule une configuration avancée n’utilisant pas le proxy GraphQL fourni doit modifier ce paramètre.

  • Activer la prise en charge de l’UID du catalogue : activez la prise en charge de l’UID au lieu de l’ID dans les appels GraphQL du serveur principal de commerce.

    REMARQUE

    La prise en charge des UID a été introduite dans Adobe Commerce (Magento) 2.4.2. Activez cette option uniquement si votre serveur principal Commerce prend en charge un schéma GraphQL de la version 2.4.2 ou ultérieure.

  • Identifiant de catégorie racine du catalogue : l’identifiant (UID ou ID) de la racine du catalogue du magasin.

    ATTENTION

    À compter de la version 2.0.0 des composants principaux CIF, la prise en charge de id a été supprimée et remplacée par uid. Si votre projet utilise la version 2.0.0 des composants principaux CIF, vous devez activer la prise en charge de l’UID de catalogue et utiliser un UID de catégorie valide comme "identifiant de catégorie racine de catalogue".

La configuration illustrée ci-dessus est à titre de référence. Les projets doivent fournir leurs propres configurations.

Pour des configurations plus complexes à l’aide de plusieurs structures de site AEM combinées à différents catalogues commerciaux, consultez le tutoriel Configuration multi-magasin Commerce.

Ressources supplémentaires

Sur cette page