fullmetrixDocs

Dépannage

Résoudre les problèmes du module Magento, du menu introuvable aux erreurs de connexion et aux données qui n'avancent plus.

Commencez toujours par les vérifications qui ne changent rien. Ne cliquez pas sur Déconnecter, ni dans Magento ni dans Fullmetrix, pour « repartir de zéro ». Dans Magento, la déconnexion efface le lien avec Fullmetrix et le code ne peut pas être réutilisé. Dans Fullmetrix, elle supprime les données importées.

Plusieurs vérifications de cette page se font en ligne de commande. Transmettez-les à votre développeur.

Les deux commandes de diagnostic

Depuis le dossier du projet Magento, votre développeur exécute ces deux commandes.

bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:status

La première confirme que le module est activé. La seconde affiche l'état de la connexion, ligne par ligne.

LigneCe qu'elle indique
VersionLa version du module installée
Registeredyes si la boutique est connectée à Fullmetrix, no sinon
Connection codeLe code utilisé. Masquez cette ligne avant de partager la sortie.
Webhooksenabled si les changements sont bien transmis
QueueLe nombre de changements en attente d'envoi et l'ancienneté du plus vieux
orders, customers, products...Le nombre d'éléments que la boutique peut envoyer, par type

Une file Queue qui reste à 0 ou presque est normale. Une file qui grossit d'heure en heure signifie que le cron ne tourne pas ou que l'envoi vers Fullmetrix est bloqué.

Le menu Fullmetrix n'apparaît pas dans Magento

  1. Déconnectez-vous de l'administration Magento puis reconnectez-vous. Le menu est souvent mis en cache dans la session.
  2. Votre développeur vérifie que le module est activé avec bin/magento module:status Fullmetrix_Connector. S'il ne l'est pas, il exécute bin/magento module:enable Fullmetrix_Connector.
  3. Il exécute bin/magento setup:upgrade, puis bin/magento setup:di:compile si la boutique est en mode production, puis bin/magento cache:flush.
  4. Si vous utilisez un rôle administrateur personnalisé, vérifiez que la ressource Fullmetrix est cochée, comme expliqué dans Compatibilité.

Messages d'erreur à la connexion

Quand la connexion échoue, Magento affiche Échec de la connexion suivi d'une raison. En ligne de commande, la raison suit le message Connexion echouee.

Raison affichéeCe qu'elle veut direQue faire
invalid_code_formatLe code n'a pas la forme FMTX-XXXX-XXXX-XXXXRecopiez-le depuis Fullmetrix. Il ne contient jamais les lettres O et I ni les chiffres 0 et 1.
invalid_storeLa vue boutique choisie n'existe pas ou n'est pas activeChoisissez une vue active. En ligne de commande, vérifiez le numéro passé à --store-id.
Code de connexion introuvableCe code n'existe pas dans FullmetrixRecopiez le code affiché dans votre organisation, sans caractère en trop
Plateforme incorrecte pour ce codeLe code a été créé pour une autre plateformeDans Fullmetrix, revenez au choix de la plateforme, choisissez Magento, puis copiez le code affiché et réessayez
Ce code est déjà associé à un autre siteUne boutique a déjà accepté ce codeVoir la section suivante
Trop de tentatives, réessayez dans quelques minutes.Trop d'essais en peu de tempsAttendez dix minutes avant de réessayer
Cette boutique est déjà connectée à une autre Organization.La boutique appartient déjà à une autre organisation FullmetrixUtilisez cette organisation, ou retirez-en la boutique d'abord
Cette boutique a déjà bénéficié d'un essai Fullmetrix...La période d'essai a déjà servi pour cette boutiqueUn abonnement est nécessaire, voir Facturation
invalid_response, HTTP suivi d'un nombre, ou un message réseauLe serveur n'a pas pu joindre Fullmetrix correctementVotre développeur vérifie que le serveur peut ouvrir des connexions HTTPS sortantes vers fullmetrix.com (pare-feu, proxy, DNS, certificats)

Le code est « déjà associé à un autre site »

Un code ne sert qu'une fois. Ce message apparaît quand vous réessayez avec un code déjà accepté, par exemple après avoir cliqué sur Déconnecter dans Magento, ou si une autre installation (une préproduction, par exemple) l'a utilisé avant.

Si la carte de la boutique dans Fullmetrix fonctionne toujours, il n'y a rien à faire, la connexion est en place. Si vous avez déconnecté la boutique dans Magento et voulez la reconnecter, il faut un nouveau code. Ouvrez Paramètres, puis Intégrations, cliquez sur Déconnecter sur la carte Magento, confirmez, puis ajoutez de nouveau la boutique pour obtenir un code neuf. Cette opération efface les données importées dans Fullmetrix, qui sont ensuite importées de nouveau depuis votre boutique.

La boutique est connectée mais les données n'avancent plus

  1. Dans Magento, ouvrez Marketing, puis Fullmetrix, et vérifiez que la pastille Connecté est toujours affichée.

  2. Votre développeur exécute bin/magento fullmetrix:status et regarde la ligne Queue. Si elle grossit, le cron ne tourne pas ou l'envoi est bloqué.

  3. Il vérifie que le cron de Magento est installé et actif, puis lance une fois le groupe Fullmetrix pour tester.

    bin/magento cron:run --group=fullmetrix
  4. Il consulte var/log/system.log et var/log/exception.log autour de l'heure du problème.

  5. Dans Fullmetrix, ouvrez Paramètres, puis Intégrations, et lisez la carte Magento. Un message rouge précise la cause de la dernière erreur.

La carte Fullmetrix indique que la boutique est injoignable

Le message La dernière synchronisation n'a pas pu joindre votre boutique. Vérifiez qu'elle est en ligne et accessible publiquement. Aucune donnée n'a été mise à jour. veut dire que Fullmetrix n'a pas pu appeler votre site. Vérifiez que la boutique est en ligne, qu'elle n'est pas en mode maintenance et qu'aucune protection ne bloque les adresses en /fullmetrix/api/. Si vous utilisez Cloudflare, suivez Cloudflare et pare-feu.

Après une erreur, le bouton Synchroniser laisse la place à Reprendre et Réinitialiser. Une fois la cause corrigée, cliquez sur Reprendre pour repartir de l'endroit où l'import s'était arrêté. Si Reprendre n'est pas proposé, cliquez sur Réinitialiser, qui remet l'avancement à zéro et relance la synchronisation sans effacer les commandes déjà importées. C'est vrai aussi quand la carte affiche Synchro auto désactivée après N erreurs consécutives, même si ce message parle du bouton Synchroniser. Les autres états de la carte sont décrits dans État de la synchronisation.

Des erreurs apparaissent après une mise à jour du module

Sur une boutique en mode production, chaque mise à jour du module doit être suivie de bin/magento setup:upgrade, bin/magento setup:di:compile et bin/magento cache:flush. Si l'une de ces commandes a été oubliée, des erreurs peuvent apparaître dans l'administration ou au moment du paiement. Votre développeur relance les trois commandes dans cet ordre.

Le suivi des visiteurs ne reçoit rien

  • Vérifiez que la boutique est connectée, avec la pastille Connecté dans Magento.
  • Videz le cache de pages de Magento ou de votre cache externe, pour que les pages servies contiennent le suivi.
  • Faites votre test en acceptant les cookies si un bandeau de consentement est en place.
  • Contrôlez la réception dans Script de suivi.

Écrire au support

Si le problème persiste, contactez-nous avec les éléments suivants.

  • La version de Magento ou d'Adobe Commerce et la version de PHP.
  • La sortie de bin/magento fullmetrix:status, avec la ligne Connection code effacée.
  • La vue boutique connectée et l'adresse publique de la boutique.
  • Le message exact et l'heure où il est apparu.
  • La présence éventuelle d'un pare-feu, de Cloudflare, d'un mode maintenance ou d'un mot de passe sur le site.
  • Les lignes utiles des journaux Magento, sans données de clients.

N'envoyez jamais de mot de passe ni le code de connexion.

Sur cette page