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
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.
-
Sur votre poste de travail local, modifiez le répertoire de votre projet.
-
Ajoutez le module Catalog Service.
code language-bash composer require "magento/catalog-service" "^3.0.1"
-
Mettez à jour les dépendances de package.
code language-bash composer update
-
Validation et modification du code push pour la variable
composer.json
etcomposer.lock
fichiers .
Sur site
Utilisez cette méthode pour installer le Catalog Service pour une instance sur site.
-
Utilisez le compositeur pour ajouter le module de service de catalogue à votre projet :
code language-bash composer require "magento/catalog-service" "^3.0.1"
-
Mettez à jour les dépendances et installez l’extension :
code language-bash composer update
-
Mettre à niveau Adobe Commerce :
code language-bash bin/magento setup:upgrade
-
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
, etProduct 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.