Prise en main d’AEM Content and Commerce start
Pour commencer à utiliser AEM Content and Commerce, vous devez installer le module complémentaire Content and Commerce pour AEM 6.5.
Configuration logicielle minimale requise
Pack de services AEM 6.5, version 7 ou ultérieure.
Intégration onboarding
L’intégration à AEM Content and Commerce est un processus en deux étapes :
-
Installez le module complémentaire Content and Commerce AEM pour AEM 6.5.
-
Connectez AEM à votre solution de commerce.
Installation du module complémentaire Content and Commerce AEM pour AEM 6.5 install-add-on
Téléchargez et installez le module complémentaire AEM Commerce pour AEM 6.5, que vous trouverez dans le portail de distribution logicielle.
Démarrez et installez le pack de services d’AEM 6.5 requis. Nous vous recommandons d’installer le dernier pack de services disponible.
Connexion d’AEM à votre système Commerce connect
AEM peut être connecté à n’importe quel système Commerce disposant d’un point d’entrée GraphQL accessible à AEM. Ces points d’entrée sont généralement disponibles publiquement ou peuvent être connectés via des connexions VPN privées ou locales selon la configuration de chaque projet.
Vous pouvez éventuellement fournir un en-tête d’authentification afin d’utiliser des fonctionnalités CIF supplémentaires nécessitant une authentification.
Les projets générés par l’Archétype de projet AEM et le Magasin de référence Venia AEM 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
avec le point d’entrée GraphQL de votre système Commerce. 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 d’exploitation 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 les connexions AEM 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
. Vous pouvez l’ajuster 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 un développement local. Pour les déploiements d’exploitation, 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 le CDN).
Configuration des magasins et des catalogues catalog
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 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 > Services Cloud > 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 :
-
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 d’affichage du magasin. 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.
note note NOTE 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.
note note NOTE La prise en charge des UID a été introduite dans Adobe Commerce version 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.
note caution CAUTION À compter de la version 2.0.0 des composants principaux CIF, la prise en charge de id
a été supprimée et remplacée paruid
. 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 fournie à 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.