esc
Surveillance et santé

Resynchronisation et outils en ligne de commande

Quand et comment utiliser la resynchronisation, ainsi que les commandes CLI à disposition des développeurs et du support.

La plupart du temps, vous n’ouvrirez jamais cette page. L’extension se maintient d’elle-même en phase : les envois échoués sont retentés automatiquement, et le travail en file d’attente n’est jamais perdu. Les outils présentés ici existent pour deux moments : lorsque vous modifiez délibérément ce qui doit être synchronisé, par exemple une fenêtre de commandes plus large, et lorsque le support vous accompagne dans une récupération. Si vous constatez que vous utilisez régulièrement la resynchronisation, cela vaut la peine d’envoyer un message au support ; quelque chose en amont mérite un examen, et le trouver est exactement notre rôle.

Élargissez votre fenêtre, la file se reconstitue d’elle-même

Pour remonter plus loin dans le temps, lancez une resynchronisation (Resync All Data) et choisissez une fenêtre plus large ; vous y retrouverez les mêmes options que dans le Setup Wizard (3, 12, 24, 36, 48 mois ou tout l’historique). La fenêtre s’applique à l’historique des commandes et des paniers : les abonnés ne sont jamais filtrés par date, tout contact abonné est donc déjà inclus quelle que soit la fenêtre choisie. L’extension repeuple la file d’attente en arrière-plan dès que vous confirmez. Votre admin ne se fige jamais, et Backfill traite les nouveaux enregistrements à son rythme habituel.

Ça fonctionne : suivez le Cron Monitor

Après avoir élargi la période, ouvrez l’onglet Cron Monitor (Marketing → Intuit Mailchimp → Dashboard). Vous y verrez les tâches de synchronisation parcourir les nouveaux enregistrements. Laissez-leur le temps de les traiter plutôt que de modifier à nouveau le réglage.

La resynchronisation : la remise à plat délibérée

La resynchronisation remet en file d’attente chaque enregistrement d’une boutique afin que le moteur pousse à nouveau l’ensemble des données. C’est un bon outil, au périmètre bien délimité : après avoir corrigé un problème de données en masse, ou lorsque le support vous le demande. Une boutique en bonne santé n’en a jamais besoin de façon régulière ; l’exactitude au quotidien est le travail du moteur, pas le vôtre. Une resynchronisation pousse vers Mailchimp les statuts d’abonnement de Magento. Une personne désabonnée dans Magento n’est jamais abonnée, et en fonctionnement normal le webhook maintient les deux côtés au diapason. Là où les deux divergent, c’est le statut de Magento qui l’emporte.

Pour la lancer, ouvrez Marketing → Intuit Mailchimp → Configuration, cliquez sur Manage Connection, puis choisissez Resync All Data dans l’onglet Manage. Sélectionnez votre fenêtre et confirmez.

Rattraper les commandes en invité

L’écran Resync porte lui aussi l’option Update Audience Members from Guest Orders. Cela compte si vous êtes passé en production sans elle : l’activer dans Configuration ne concerne que les commandes en invité passées ensuite, alors que l’activer ici puis lancer le resync l’applique également à votre historique de commandes. C’est ainsi que l’on récupère les commandes en invité manquées à la mise en service.

Outils en ligne de commande

Ces commandes s’adressent aux développeurs et au support ebizmarts. Exécutez-les depuis la racine de votre installation Magento avec php bin/magento.

Commande Ce qu’elle fait
mailchimp:sync:start Peuple la file d’attente pour la synchronisation initiale, ou la repeuple après une réinitialisation.
mailchimp:sync:status Affiche le nombre d’enregistrements en attente, synchronisés et en erreur par boutique, pour faire le point sans ouvrir l’admin.
mailchimp:sync:reset Marque les enregistrements comme non envoyés afin qu’ils soient remis en file d’attente à la prochaine exécution du cron.
mailchimp:resync --store=<id> --force Équivalent en ligne de commande du bouton Resync (utilisez --all --force pour toutes les boutiques connectées). Exécutez-la sans --force, ou avec --dry-run, pour prévisualiser les décomptes par boutique sans rien modifier.
mailchimp:queue:drain Supprime l’intégralité de la file de synchronisation, chaque ligne quel que soit son statut, avec la possibilité de la limiter à une seule boutique via --store.
mailchimp:migrate:from-mc-magento2 S’inscrit dans la migration depuis l’extension précédente. Voir Migrer depuis l’extension précédente.
Une commande réservée au support

mailchimp:queue:drain supprime la file d’attente entière, y compris la trace de ce qui a déjà été synchronisé, et pas seulement les éléments encore en attente. Exécutez-la uniquement lorsque le support ebizmarts vous le demande.

Des questions en cours de route ? Dépannage a les réponses, et le support ebizmarts est à un e-mail de vous.

Suivant: Paramètres de configurationLa carte de tous les groupes de paramètres d'Intuit Mailchimp : retrouvez chaque option en un coup d'œil.