DocumentationCommerceGuide Catalog Service

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Intégration et installation

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

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 de compositeur à partir du référentiel repo.magento.com.

NOTE
Si votre instance de Commerce utilise Live Search ou Product Recommendations, le service de catalogue est installé ou mis à jour automatiquement lorsque vous intégrez ou mettez à niveau ces services. Pour plus d’informations, consultez les instructions d’installation de Live Search et Product Recommendations.

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

recommendation-more-help

Prérequis

style
shade-box

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.

Infrastructure cloud

Utilisez cette méthode pour installer le Catalog Service pour une instance Commerce Cloud.

  1. Sur votre station de travail locale, accédez au répertoire du projet d’infrastructure cloud d’Adobe Commerce.

    note 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.

  2. 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>

  3. Ajoutez le module Service de catalogue .

    code language-bash 
    composer require magento/catalog-service --no-update

  4. Mettez à jour les dépendances de package.

    code language-bash 
    composer update "magento/catalog-service"

  5. Ajoutez, validez et envoyez les modifications de code des fichiers composer.json et composer.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 Commerce pour appliquer les modifications. Vérifiez le statut du déploiement dans le journal de déploiement.

Sur site

Utilisez cette méthode pour installer le Catalog Service pour une instance locale.

  1. Utilisez le compositeur pour ajouter le module Service de catalogue à votre projet :

    code language-bash 
    composer require magento/catalog-service --no-update

  2. Mettez à jour les dépendances et installez l’extension :

    code language-bash 
    composer update  "magento/catalog-service"

  3. Mettre à niveau Adobe Commerce :

    code language-bash 
    bin/magento setup:upgrade

  4. Effacez le cache :

    code language-bash 
    bin/magento cache:clean
    note 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.

  1. 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.

  2. 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
    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:info de commande de l’interface de ligne de commande Commerce.
  • Vérifiez que les indexeurs Catalog Attributes Feed, Product Feed, Product Overrides Feed et Product Variant Feed sont définis sur Update by Schedule.

Surveillance et dépannage de la synchronisation des données

Dans l’administration Commerce, vous pouvez surveiller le processus de synchronisation à l’aide du tableau de bord Data Management Dashboard. Utilisez l’interface de ligne de commande Commerce et les journaux pour gérer et résoudre les problèmes liés au processus.

caa758b0-fff2-4350-a281-16253ff7b81f