Intégration et installation

Les vidéos suivantes vous guident tout au long de la Catalog Service processus.

Partie 1: intégration et installation

Partie 2: en utilisant la variable Catalog Service

recommendation-more-help

Conditions préalables

Le processus d’intégration pour Catalog Service requiert l’accès à la ligne de commande du serveur. Si vous n’êtes pas familiarisé avec l’utilisation de la ligne de commande, demandez de l’aide à un développeur ou à un intégrateur système.

Exigences logicielles

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2
  • Compositeur : 2.x

Plateformes prises en charge

  • Adobe Commerce sur l’infrastructure cloud : 2.4.4+
  • Adobe Commerce sur site : 2.4.4+

Points de fin

Catalog Service comporte deux points de terminaison disponibles pour l’intégration :

  • Environnement de test (https://catalog-service-sandbox.adobe.io/graphql) : utilisé pour les tests et la 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 de commerce.

Toutes les instances de test de Commerce doivent utiliser le point de terminaison Sandbox.

Le test de chargement ne doit être effectué que sur le point de terminaison Sandbox. Il est recommandé d’effectuer une ticket d’assistance être ouvert lors du test de chargement afin que l’équipe Services puisse anticiper le trafic de serveur supplémentaire.

Installation et configuration

Pour commencer à utiliser Catalog Service Pour Adobe Commerce, les étapes suivantes sont requises :

  • Installation des extensions d’exportation de données
  • Configuration du service et de l’exportation des données
  • Accès au service

Installation des extensions d’exportation de données

Le processus d’intégration pour Catalog Service requiert l’accès à la ligne de commande du serveur.

La variable Catalog Service L’extension peut être installée sur l’infrastructure cloud Adobe Commerce et sur les instances sur site.

La variable Catalog Service est installé avec les clés du compositeur, qui sont liées au compte Commerce. mageid fourni pendant le processus d’inscription. Le compositeur utilise ces clés lors de l’installation initiale d’Adobe Commerce, ou dans les cas où les clés du compositeur n’étaient pas précédemment enregistrées dans une instance externe auth.json fichier .

Voir Obtention des clés d’authentification pour plus d’informations sur l’obtention des clés du compositeur.

Adobe Commerce sur l’infrastructure cloud

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

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Ajoutez le module Catalog Service.

    code language-bash
    composer require "magento/catalog-service" "^3.0.1"
    
  3. Mettez à jour les dépendances de package.

    code language-bash
    composer update
    
  4. Validation et modification du code push pour la variable composer.json et composer.lock fichiers .

Sur site

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

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

    code language-bash
    composer require "magento/catalog-service" "^3.0.1"
    
  2. Mettez à jour les dépendances et installez l’extension :

    code language-bash
    composer update
    
  3. Mettre à niveau Adobe Commerce :

    code language-bash
    bin/magento setup:upgrade
    
  4. Effacez le cache :

    code language-bash
    bin/magento cache:clean
    

Configuration du service et de l’exportation des données

Après l’installation Catalog Service, vous devez configurer le Connecteur Commerce Services en spécifiant les clés d’API et en sélectionnant un espace de données SaaS.

Une fois la configuration SaaS terminée, effectuez une synchronisation initiale des données en suivant la Synchronisation du catalogue guide.

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 sont en cours d’exécution.
  • Assurez-vous que la variable Catalog Attributes Feed, Product Feed, Product Overrides Feed, et Product Variant Feed les indexeurs sont définis sur "Mise à jour par planification".

La synchronisation initiale peut prendre de quelques minutes à des heures selon la taille du catalogue. Après la synchronisation initiale, le catalogue exporte en permanence les données de produit du serveur Commerce vers les services Commerce afin de maintenir les services à jour. Pour surveiller l’état de la synchronisation, reportez-vous à la section Data Management Dashboard.

Accès au service

La variable Catalog Service L’API est accessible à l’aide des commandes du POST via HTTPS.

Pour obtenir la clé api, accédez à la zone Commerce Service Connector dans l’administrateur et copiez la clé API publique.

Lisez la section Documentation GraphQL pour comprendre comment interroger et envoyer les en-têtes nécessaires à la génération de requêtes d’API.

Pour autoriser Catalog Service via un pare-feu, ajoutez commerce.adobe.io à la liste autorisée.

Service de catalogue et maillage d’API

La variable Maillage d’API pour Adobe Developer App Builder permet aux développeurs d’intégrer des API privées ou tierces, ainsi que d’autres interfaces avec des produits Adobe à l’aide des E/S d’Adobe.

Voir Catalog Service et maillage API pour plus d’informations sur l’installation et la configuration.

Tableau de bord de la gestion des données

Les utilisateurs peuvent se référer à la section Tableau de bord de la gestion des données pour plus d’informations sur Catalog Service synchronisation des données.

7c786b3e-f793-4e26-b38a-3fe76d8eca72