Prise en main d’AEM Commerce as a Cloud Service

Pour commencer à utiliser AEM Commerce as a Cloud Service, votre instance Experience Manager Cloud Service doit être configurée avec le module complémentaire CIF (Commerce Integration Framework). Le module complémentaire CIF est un module supplémentaire ajouté à AEM Sites as a Cloud Service.

Intégration

L’intégration à AEM Commerce as a Cloud Service est un processus à deux étapes :

  1. Activation d’AEM Commerce as a Cloud Service et approvisionnement du module complémentaire CIF
  2. Connexion d’AEM Commerce as a Cloud Service à votre solution de commerce

La première étape d’intégration est effectuée par Adobe. Pour plus d’informations sur la tarification et l’approvisionnement, contactez votre représentant commercial.

Une fois que vous disposez du module complémentaire CIF, celui-ci est appliqué à tout programme Cloud Manager existant. Si vous n’avez pas de programme Cloud Manager, vous devrez en créer un. Pour plus d’informations, voir Configuration de votre programme.

La deuxième étape s’effectue en libre-service pour chaque environnement AEM as a Cloud Service. Il existe d’autres configurations que vous devrez effectuer après l’approvisionnement initial du module complémentaire CIF.

Connexion d’AEM à une solution de commerce

Pour connecter le module complémentaire CIF et les composants principaux AEM CIF à votre environnement, vous devez fournir l’URL du point d’entrée GraphQL via une variable d’environnement Cloud Manager. Le nom de la variable est COMMERCE_ENDPOINT. Une connexion sécurisée via HTTPS doit être configurée.

Cette variable d’environnement est utilisée à deux endroits :

  • Appels GraphQL d’AEM au serveur principal Commerce, via un client GraphQl partageable commun, utilisé par les composants principaux CIF AEM et les composants de projet client.
  • Configurez une URL de proxy GraphQL sur chaque environnement AEM, la variable est définie sur /api/graphql. Elle est utilisée par les outils de création de commerce AEM (module complémentaire CIF) et les composants côté client CIF.

Une autre URL de point d’entrée GraphQL peut être utilisée pour chaque environnement AEM as a Cloud Service. De cette façon, les projets peuvent connecter les environnements d’évaluation AEM avec les systèmes d’évaluation de commerce et l’environnement de production AEM à un système de production de commerce. Ce point d’entrée GraphQL doit être accessible au public, et les connexions VPN privées ou locales ne sont pas prises en charge. Vous pouvez éventuellement fournir un en-tête d’authentification afin d’utiliser des fonctionnalités CIF supplémentaires nécessitant une authentification.

Facultatif et destiné uniquement à Adobe Commerce Enterprise/Cloud, le module complémentaire CIF prend en charge l’utilisation de données de catalogue intermédiaires pour les auteurs d’AEM. Pour ce faire, vous devez configurer un jeton d’autorisation. Pour des raisons de sécurité, le jeton d’autorisation configuré n’est disponible et utilisé que sur les instances d’auteur AEM. Les instances AEM de publication ne peuvent pas afficher de données intermédiaires.

Il existe deux options pour configurer le point d’entrée :

Via l’interface utilisateur de Cloud Manager (par défaut)

Vous pouvez le faire à l’aide d’une boîte de dialogue sur la page Détails de l’environnement. Lorsque vous affichez cette page pour un programme compatible avec le commerce, un bouton s’affiche si le point d’entrée n’est pas actuellement configuré :

Informations sur l’environnement de CM

Cliquez sur ce bouton pour ouvrir une boîte de dialogue :

Point d’entrée CM Commerce

Une fois le point d’entrée (éventuellement un jeton d’authentification pour la prise en charge d’un catalogue intermédiaire) défini, il s’affiche sur la page de détails. Cliquez sur l’icône Modifier pour ouvrir la boîte de dialogue dans laquelle le point d’entrée peut être modifié, si nécessaire.

Informations sur l’environnement de CM

via l’interface de ligne de commande Adobe I/O

Pour connecter AEM à une solution de commerce via l’interface de ligne de commande d’Adobe I/O, procédez comme suit :

  1. Procurez-vous l’Adobe I/O CLI avec le plug-in Cloud Manager.

    Consultez la documentation d’Adobe Cloud Manager relative à la manière de télécharger, de configurer et d’utiliser l’Adobe I/O CLI avec le plug-in de ligne de commande Cloud Manager.

  2. Authentifiez la ligne de commande Adobe I/O avec le programme AEM as a Cloud Service.

  3. Définissez la variable COMMERCE_ENDPOINT dans Cloud Manager.

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
    

    Pour plus d’informations, voir la documentation sur la ligne de commande.

    L’URL du point d’entrée commerce GraphQL doit pointer vers le service GraphQl de commerce et utiliser une connexion HTTPS sécurisée. Par exemple : https://<yourmagentosystem>/graphql.

  4. Activation des fonctionnalités de catalogue intermédiaire nécessitant une authentification (facultatif)

    REMARQUE

    Cette fonctionnalité est disponible uniquement avec Adobe Commerce Enterprise ou Cloud Edition. Voir la section Authentification basée sur un jeton pour en savoir plus.

    Définissez la variable secrète COMMERCE_AUTH_HEADER dans Cloud Manager :

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
    
CONSEIL

Pour vérifier, vous pouvez répertorier toutes les variables de Cloud Manager à l’aide de la commande suivante : aio cloudmanager:list-environment-variables ENVIRONMENT_ID

Vous êtes ainsi prêt à utiliser AEM Commerce as a Cloud Service et vous pouvez déployer votre projet via Cloud Manager

Configuration des magasins et des catalogues

Le module complémentaire CIF et les composants principaux CIF peuvent être utilisés sur plusieurs structures de site AEM connectées à différents magasins commerciaux (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