Synchroniser les flux à l’aide de l’interface de ligne de commande Commerce
La commande saas:resync du package magento/saas-export permet de gérer la synchronisation des données pour Adobe Commerce services SaaS.
saas:resync s’applique également aux flux Adobe Commerce Optimizer Connector tels que products, categories et priceBooks. Consultez Flux pris en charge pour obtenir la liste complète des flux de connecteur et des noms d’indexeur.Adobe déconseille d’utiliser régulièrement la commande saas:resync. Les scénarios classiques d’utilisation de la commande sont les suivants :
- Synchronisation initiale
- Synchronisez les données avec un nouvel espace de données après avoir modifié l’identifiant de l’espace de données SaaS
- Dépannage
Surveillez les opérations de synchronisation dans le fichier var/log/saas-export.log.
Synchronisation initiale
aco:config:init planifie la synchronisation complète initiale en invalidant tous les indexeurs de flux du connecteur. Voir Activation de l’intégration Commerce Optimizer et Gestion de la synchronisation vers Commerce Optimizer.Lorsque vous déclenchez une saas:resync à partir de la ligne de commande, en fonction de la taille de votre catalogue, la mise à jour des données peut prendre de quelques minutes à quelques heures.
Les synchronisations de flux peuvent être exécutées dans n’importe quel ordre ; il n’existe aucune dépendance matérielle entre elles. La séquence suivante commence par les données de la portée en premier, ce qui est un point de départ logique puisque les portées définissent les vues du magasin auxquelles les autres flux font référence.
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed productAttributes
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed products
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed productoverrides
Options des commandes
La commande saas:resync prend en charge diverses opérations de synchronisation :
- Synchronisation partielle par SKU
- Reprise des synchronisations interrompues
- Valider les données sans synchronisation
Afficher toutes les options de commande et les indicateurs :
bin/magento saas:resync --help
Consultez les sections suivantes pour obtenir une description des options ainsi que des exemples.
--feed
Obligatoire. Indique l’entité de flux à resynchroniser.
Options de commande et indicateurs des documents bin/magento saas:resync --help. Il ne répertorie pas tous les flux disponibles dans votre environnement. Pour obtenir la liste complète des flux avec les noms de flux de l’interface de ligne de commande, les ID d’indexeur et les tableaux de flux, voir Flux pris en charge.
productOverrides nécessite une Adobe Commerce sur le cloud, sur site ou Commerce as a Cloud Service, et orders nécessite le module Commandes client.Exemple:
bin/magento saas:resync --feed products
--by-ids
Resynchronisez partiellement des entités spécifiques en fonction de leurs identifiants. Prend en charge les flux products, productAttributes, productOverrides, inventoryStockStatus, prices, variants et categoryPermissions.
Par défaut, lorsque vous utilisez l’option --by-ids , vous spécifiez des valeurs à l’aide des valeurs de SKU du produit. Pour utiliser des ID de produit à la place, ajoutez l’option --id-type=productId .
Exemples :
bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'
bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'
--cleanup-feed
Nettoyez la table de l’indexeur de flux avant de réindexer et d’envoyer des données au SaaS. Pris en charge uniquement pour products, productAttributes, productOverrides, inventoryStockStatus, prices, variants et categoryPermissions.
Si elle est utilisée avec l’option --dry-run , l’opération effectue une opération de resynchronisation d’essai pour tous les éléments.
cleanup-feed efface l’état d’exportation du flux local et peut entraîner une synchronisation incomplète. Par exemple, les suppressions d’entités dans Adobe Commerce peuvent ne pas être reflétées dans les services Commerce connectés, ou les entités obsolètes peuvent rester dans les index des services Commerce distants même si elles ont été supprimées ou mises à jour dans Adobe Commerce. N’utilisez cette option que pour les reconstructions complètes de l’environnement, par exemple après un nettoyage de l’espace de données SaaS.Exemple:
bin/magento saas:resync --feed products --cleanup-feed
--continue-resync
Reprend une opération de resynchronisation interrompue. Pris en charge uniquement pour les flux products, productAttributes et productOverrides.
Exemple:
bin/magento saas:resync --feed productAttributes --continue-resync
--dry-run
Exécute le processus de réindexation des flux sans envoyer le flux à SaaS et sans enregistrer dans la table des flux. Cette option est utile pour identifier les problèmes éventuels liés à votre jeu de données.
Ajoutez la variable d’environnement EXPORTER_EXTENDED_LOG=1 pour enregistrer la payload dans var/log/saas-export.log.
Exemple:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run
Test d’éléments de flux spécifiques
Testez des éléments de flux spécifiques en ajoutant l’option --by-ids avec la collection de journaux étendue pour afficher la payload générée dans le fichier var/log/saas-export.log.
Exemple:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'
Tester tous les éléments de flux
Par défaut, le flux envoyé au cours d’une opération de resync --dry-run ne comprend que les nouveaux éléments ou les éléments dont l’exportation a échoué précédemment. Pour inclure tous les éléments du flux à traiter, utilisez l’option --cleanup-feed .
Exemple:
bin/magento saas:resync --feed products --dry-run --cleanup-feed
--no-reindex
Envoie à nouveau les données de catalogue existantes à Commerce Services sans réindexation. Non pris en charge pour les flux liés au produit.
Le comportement varie selon le mode d’exportation :
- Mode hérité : renvoie toutes les données sans les tronquer.
- Mode immédiat : l’option est ignorée et ne synchronise que les mises à jour/échecs.
Exemple:
bin/magento saas:resync --feed productAttributes --no-reindex