Scénarios de dépannage pour SaaS Data Export
Cette page décrit les comportements que vous pouvez observer lors de l’utilisation des SaaS Data Export, qui sont généralement causés par une mauvaise configuration ou une mauvaise interprétation des résultats de synchronisation. Utilisez les descriptions ci-dessous pour identifier la cause première et appliquer la résolution appropriée.
Produit configurable ou groupé manquant dans les services Commerce configurable-bundle-missing
Problème : un produit configurable ou groupé a le statut Activé dans Adobe Commerce mais n’est pas renvoyé dans le storefront ou s’affiche avec un statut Désactivé dans les services SaaS Commerce.
Cause : le statut effectif des produits composites dépend du statut de leurs produits enfants, et pas seulement du statut du produit parent. Les services SaaS Commerce reflètent ce statut calculé :
- Produits configurables - au moins une variante de produit doit être activée.
- Lots de produits - au moins un produit doit être activé pour chaque option de lot requise.
Si ces conditions ne sont pas remplies, le produit parent est traité comme désactivé même si son propre statut est défini sur Activé.
Solution :
- Pour les produits configurables, vérifiez qu’au moins une variante de produit simple associée est activée et affectée à la vue de site web et de magasin appropriée.
- Pour les produits groupés, vérifiez que chaque option de bundle requise comporte au moins un produit enfant activé. Une option obligatoire avec tous les enfants désactivés entraîne le traitement de l’ensemble du lot comme désactivé.
- Après avoir activé les produits enfants appropriés, déclenchez une resynchronisation ou attendez la prochaine synchronisation planifiée, puis confirmez le statut mis à jour dans les services SaaS Commerce.
Prix non mis à jour après l’activation de la règle de prix de catalogue prices-not-updated
Problème : après l’activation d’une règle de prix de catalogue à l’aide de la fonction Mise à jour planifiée, les prix ne sont pas mis à jour. La commerce-data-export.log affiche les synced: 0 pour prices flux après l’application des mises à jour planifiées.
Cause : une condition de concurrence peut se produire entre les groupes cron lorsque des mises à jour planifiées sont utilisées pour les règles de prix de catalogue. L’indexeur catalog_data_exporter_product_prices peut s’exécuter avant que sa dépendance, l’index catalogrule_product, ne soit complètement reconstruite. Par conséquent, l’exportateur de prix lit des données obsolètes et n’exporte aucune modification.
Solution :
La solution immédiate à ce problème est une solution : configurez les deux groupes cron pour qu’ils s’exécutent de manière séquentielle afin d’éliminer la condition de concurrence :
-
Accédez à Stores > Configuration > Advanced > System > Cron (Scheduled Tasks).
-
Définissez Use Separate Process sur No pour les deux :
- Options de configuration cron pour le groupe : index
- Options de configuration cron pour le groupe : staging
-
Videz le cache de configuration après l’enregistrement.
Incohérence des données de catalogue entre les services Adobe Commerce et connectés catalog-data-discrepancy
Problème : les données de produit affichées dans les services Commerce connectés (tels que Live Search ou Product Recommendations) ne correspondent pas aux données du catalogue dans Adobe Commerce. Par exemple, le nom, le prix ou la description d’un produit semble obsolète ou incorrect sur le storefront.
Cause : lorsqu’une resynchronisation est déclenchée, la mise à jour et la prise en compte des données dans les composants de l’interface utilisateur peuvent prendre jusqu’à une heure. Si l’incohérence persiste au-delà de cette fenêtre, l’élément n’a peut-être pas été récupéré lors de la dernière synchronisation ou la synchronisation n’a pas détecté de modification, car les données de flux étaient déjà marquées comme à jour.
Solution :
- Ouvrez les résultats de la recherche à partir du storefront Commerce. Sélectionnez ensuite le produit en question pour ouvrir sa vue détaillée.
- Copiez la sortie JSON et vérifiez qu’elle correspond à ce que vous avez dans le catalogue Commerce.
- Si le contenu ne correspond pas, apportez une modification mineure au produit de votre catalogue, par exemple en ajoutant un espace ou un point, pour forcer la détection de la modification.
- Attendez une resynchronisation ou déclenchez une resynchronisation manuelle à partir de l’interface de ligne de commande ou de la page Data Feed Sync Status dans l’interface d’administration.
Pour résoudre d’autres problèmes liés aux données de catalogue dans Product Recommendations, voir Résolution des problèmes du module de recommandations de produits dans la base de connaissances de Commerce.
La synchronisation des données ne s’exécute pas selon le calendrier sync-not-on-schedule
Problème : la synchronisation des données ne s’exécute pas selon le calendrier ou aucun élément n’est synchronisé malgré les modifications du produit dans Adobe Commerce.
Cause : les causes les plus courantes sont les tâches cron qui ne s’exécutent pas ou les indexeurs qui ne sont pas configurés en mode Update by Schedule.
Solution :
- Vérifiez que les tâches cron sont en cours d’exécution.
- Vérifiez que les indexeurs des flux suivants sont définis sur Update by Schedule : Attributs de catalogue, Produit, Remplacements de produit et Variante de produit. Vérifiez à partir de Index Management dans l’administration Commerce ou à l’aide de l’interface de ligne de commande :
bin/magento indexer:show-mode | grep -i feed.
La synchronisation du catalogue a le statut En échec . catalog-sync-failed
Problème : la synchronisation du catalogue affiche un statut Échec sur la page Data Feed Sync Status.
Cause : une erreur irrécupérable s’est produite lors de la phase de collecte de données ou d’envoi. Les causes courantes incluent les problèmes d’authentification des API, les erreurs réseau ou les échecs de validation des données.
Solution :
-
Consultez les journaux d’erreurs d’exportation des données pour plus d’informations sur l’échec. Consultez la section Vérification et dépannage des journaux pour connaître le format de journal et les options de journalisation étendues :
var/log/commerce-data-export-errors.logles erreurs lors de la collecte de données.var/log/saas-export-errors.logles erreurs lors de l’envoi des données.
-
Si l’erreur n’est pas liée à la configuration ou à une extension tierce, envoyez un ticket d’assistance avec les entrées de journal appropriées.
Le journal affiche les messages « opération ignorée - processus verrouillé » process-locked
Problème : le fichier commerce-data-export.log contient des entrées similaires à celles-ci :
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
Cause : il s’agit d’un comportement attendu, et non d’une erreur. Le message s’affiche lorsqu’une synchronisation partielle déclenchée par cron tente de s’exécuter alors qu’une réindexation complète ou une saas:resync est déjà en cours. L’extension SaaS Data Export utilise un mécanisme de verrouillage de flux pour empêcher les opérations de synchronisation simultanées en conflit.
Solution :
Aucune action n’est requise. Une fois que le processus en cours d’exécution se termine et libère le verrouillage, l’exécution cron suivante reprend et synchronise toutes les modifications en attente. Pour plus d’informations sur le fonctionnement du mécanisme de verrouillage, consultez la section Mécanisme de verrouillage de flux pour l’exportation de données SaaS.