Documentation Commerce Guide Data Export pour les services SaaS

Synchroniser les flux à l’aide de l’interface de ligne de commande Commerce

Dernière mise à jour : 5 mai 2025

Rubriques :

Créé pour :

Administration

La commande saas:resync du package magento/saas-export permet de gérer la synchronisation des données pour les services SaaS Adobe Commerce.

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

REMARQUE

La synchronisation initiale s’exécute automatiquement lorsque Live Search ou les recommandations de produits sont activées. Les commandes manuelles ne sont pas nécessaires.

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.

Pour la synchronisation initiale, Adobe recommande d’exécuter les commandes dans l’ordre suivant :

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

Synchronisation à l’aide des commandes de l’interface de ligne de commande

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 disponibles :

bin/magento saas:resync --help

Consultez les sections suivantes pour obtenir une description des options ainsi que des exemples.

NOTE

Pour obtenir des options avancées de gestion du traitement des exportations, voir Personnaliser le traitement des exportations.

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

IMPORTANT

À utiliser uniquement après le nettoyage de l’environnement ou avec l’option --dry-run . Si elle est utilisée dans d’autres cas, l’opération de nettoyage peut entraîner une perte de données et des problèmes de synchronisation des données.

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

`--feed`

Obligatoire. Indique l’entité de flux à resynchroniser.

Flux disponibles :

categories
categoryPermissions
inventoryStockStatus
orders
prices
products
productAttributes
productOverrides
scopesWebsite
scopesCustomerGroup
variants

Exemple:

bin/magento saas:resync --feed products

`--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

`--id-type=ProductId`

Par défaut, les entités spécifiées lorsque vous utilisez la commande saas:resync feed avec l’option --by-ids sont spécifiées par SKU du produit. Utilisez l’option --id-type=ProductId pour spécifier des entités par ID de produit.

bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'

Exemple:

Dépannage

Si vous ne voyez pas les données attendues dans les services Commerce connectés, résolvez les problèmes en vérifiant les journaux d’erreurs d’exportation des données et en utilisant la commande saas:resync avec des variables d’environnement pour passer en revue les payloads et les données de profil. Voir Vérification des journaux et dépannage.

recommendation-more-help