Intégration et installation
Installez Catalog Service pour demander et recevoir des données de produit d’une instance Commerce à l’aide de l’API GraphQL Catalog Service. Le service de catalogue est fourni en tant que métapaquet PHP de compositeur à partir du référentiel repo.magento.com.
Configuration requise
Configuration logicielle requise
- Adobe Commerce 2.4.4+
- PHP 8.1, 8.2, 8.3, 8.4
- Compositeur : 2.x
Plateformes prises en charge
- Adobe Commerce sur les infrastructures cloud : 2.4.4+
- Adobe Commerce on-premise : 2.4.4+
Points d’entrée
Catalog Service dispose de deux points d’entrée disponibles pour l’intégration :
- Sandbox (
https://catalog-service-sandbox.adobe.io/graphql) : utilisé à des fins de test et de validation avant la mise en ligne - Production (
https://catalog-service.adobe.io/graphql) : utilisé pour le trafic en direct pour les commerçants et les sites Web Commerce
Toutes les instances de test Commerce utilisent le point d’entrée Sandbox.
Effectuez tous les tests de chargement sur le point d’entrée Sandbox. Avant de commencer les tests de chargement, envoyez un ticket d’assistance afin que l’équipe des services puisse anticiper le trafic supplémentaire du serveur.
Installation et configuration
Pour commencer à utiliser Catalog Service pour Adobe Commerce, les étapes sont les suivantes :
- Installation de l’extension du service de catalogue (
magento/catalog-service) - Configuration du service et de l’export des données
- Accès au service
Installation de l’extension du service de catalogue
Prérequis
-
Accédez à repo.magento.com pour installer l’extension. Pour la génération des clés et l’obtention des droits nécessaires, voir Obtenir vos clés d’authentification . Pour les installations cloud, consultez le guide Commerce sur les infrastructures cloud
-
Accès à la ligne de commande du serveur applicatif Adobe Commerce.
Installez la dernière version de l’extension Catalog Services (magento/catalog-service) sur une instance Adobe Commerce qui exécute Adobe Commerce version 2.4.4 ou ultérieure. Le service de catalogue est fourni en tant que métapaquet de compositeur à partir du référentiel repo.magento.com.
Utilisez cette méthode pour installer le Catalog Service pour une instance Commerce Cloud.
-
Sur votre station de travail locale, accédez au répertoire du projet d’infrastructure cloud d’Adobe Commerce.
note NOTE Pour plus d’informations sur la gestion locale des environnements de projet Commerce, voir Gestion des branches avec l’interface de ligne de commande dans le Guide d’utilisation d’Adobe Commerce sur les infrastructures cloud. -
Consultez la branche d’environnement pour effectuer la mise à jour à l’aide de l’interface de ligne de commande Adobe Commerce Cloud.
code language-shell magento-cloud environment:checkout <environment-id> -
Ajoutez le module Service de catalogue .
code language-bash composer require magento/catalog-service --no-update -
Mettez à jour les dépendances de package.
code language-bash composer update "magento/catalog-service" -
Ajoutez, validez et envoyez les modifications de code des fichiers
composer.jsonetcomposer.lockà l’environnement cloud.code language-shell git add -A git commit -m "Add catalog service module" git push origin <branch-name>L’envoi des mises à jour à l’environnement cloud lance le processus de déploiement cloud de 🔗 pour appliquer les modifications. Vérifiez le statut du déploiement dans le journal de déploiement.
Utilisez cette méthode pour installer le Catalog Service pour une instance locale.
-
Utilisez le compositeur pour ajouter le module Service de catalogue à votre projet :
code language-bash composer require magento/catalog-service --no-update -
Mettez à jour les dépendances et installez l’extension :
code language-bash composer update "magento/catalog-service" -
Mettre à niveau Adobe Commerce :
code language-bash bin/magento setup:upgrade -
Effacez le cache :
code language-bash bin/magento cache:cleannote tip TIP Dans certains cas, en particulier lors d’un déploiement en production, vous pouvez éviter d’effacer le code compilé, car cela peut prendre un certain temps. Assurez-vous de sauvegarder votre système avant d’y apporter des modifications.
Configuration du service et de l’export des données
Après avoir installé le Catalog Service, effectuez les tâches suivantes pour intégrer le service de catalogue à votre instance Adobe Commerce. Cette intégration permet la synchronisation des données et la communication entre l’instance Commerce, le service de catalogue et d’autres services d’assistance. La synchronisation des données est gérée par l’extension Exportation de données SaaS.
-
Configurez Commerce Services Connector en spécifiant les clés API et en sélectionnant un espace de données SaaS.
La configuration du connecteur de services Commerce est un processus unique requis pour utiliser les services Adobe Commerce tels que le service de catalogue, la recherche en direct et les recommandations de produits. Si vous avez déjà configuré le connecteur pour un autre service, ignorez cette étape.
-
Effectuez une synchronisation initiale des données à partir du Tableau de bord de gestion des données.
La synchronisation initiale peut prendre de quelques minutes à plusieurs heures selon la taille du catalogue. Vous pouvez surveiller le statut de la synchronisation à partir du tableau de bord de Data Management. Après la synchronisation initiale, le catalogue exporte les données de produit de manière continue pour maintenir les services à jour.
note NOTE Vous pouvez également démarrer la synchronisation initiale à partir de la ligne de commande à l’aide de l’interface de ligne de commande Commerce. Voir Synchronisation initiale dans le Guide d’exportation des données SaaS.
Pour vous assurer que l’exportation du catalogue s’exécute correctement :
- Vérifiez que les tâches cron sont en cours d’exécution.
- Vérifiez que les indexeurs s’exécutent à partir de l’Admin ou à l’aide de la
bin/magento indexer:infode commande de l’interface de ligne de commande Commerce. - Vérifiez que les indexeurs
Catalog Attributes Feed, Product Feed, Product Overrides FeedetProduct Variant Feedsont définis surUpdate by Schedule.
Surveillance et dépannage de la synchronisation des données
Pour vérifier que la synchronisation des données fonctionne, vérifiez que les données ont bien été exportées depuis Adobe Commerce et que les données ont bien été diffusées au service Commerce connecté. Utilisez les tableaux de bord pour votre déploiement afin de vérifier les deux étapes.
Commencez par l’exportation, puis confirmez la diffusion.
-
Vérifiez le statut de synchronisation dans l’administration Commerce.
Accédez à System > Data Transfer > Data Feed Sync Status.
Lorsque la synchronisation est en cours, les données de flux affichent les enregistrements envoyés avec succès. Sélectionnez un flux pour afficher les détails ou résoudre les problèmes de synchronisation.
-
Vérifiez que les données ont été diffusées aux services Commerce connectés.
Dans l’administration Commerce, accédez à System > Data Transfer > Data Management Dashboard.
Vérifiez que les produits, prix et attributs attendus s’affichent.
Utilisez l’interface de ligne de commande pour resynchroniser manuellement les flux si nécessaire. Pour connaître les options de resynchronisation et les étapes de dépannage supplémentaires, consultez Gérer la synchronisation dans le Guide d’exportation des données SaaS.