Pour commencer à utiliser AEM Content and Commerce, vous devez installer AEM module complémentaire Content and Commerce pour 6.5.
AEM Service Pack 6.5 La version 7 ou ultérieure est requise.
L’intégration à AEM Content and Commerce est un processus en deux étapes :
Installation du module complémentaire Content and Commerce AEM pour AEM 6.5
Connexion d’AEM à votre solution commerciale
Téléchargez et installez le module complémentaire Commerce AEM pour AEM 6.5 à partir du Distribution logicielle Portal.
Démarrez et installez le Service Pack d’AEM 6.5 requis. Nous vous recommandons d’installer le dernier Service Pack disponible.
Cela sera effectué par l’ingénieur du service client pour les clients AEM Managed Service.
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.
Projets générés par AEM Archétype de projet, et la variable Magasin de référence Venia AEM qui est déjà inclus dans la variable configuration par défaut doivent être ajustées.
Remplacez la valeur de la variable url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
avec 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é pour 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).
Le module complémentaire et la variable Composants principaux CIF peut être utilisé 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.
Cette configuration peut être ajustée pour le projet par le biais de la configuration de Cloud Service CIF en procédant comme suit :
Dans AEM, accédez à Outils -> Cloud Services -> Configuration CIF.
Sélectionnez la configuration commerciale à modifier.
Ouvrez les propriétés de configuration via la barre d’actions.
Les propriétés suivantes peuvent être configurées :
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.
La prise en charge des UID a été introduite dans Adobe Commerce 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.
À 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.