fullmetrixDocs

Risoluzione dei problemi

Risolvi i problemi del modulo Magento, da un menu mancante agli errori di connessione e ai dati che smettono di muoversi.

Parti sempre da controlli che non cambiano nulla. Non cliccare su Disconnect, né in Magento né in Fullmetrix, per "ricominciare da capo". In Magento, disconnettere cancella il legame con Fullmetrix e il codice non può essere riutilizzato. In Fullmetrix, elimina i dati importati.

Diversi controlli di questa pagina si eseguono da riga di comando. Passali al tuo sviluppatore.

I due comandi di diagnostica

Dalla cartella del progetto Magento, il tuo sviluppatore esegue questi due comandi.

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

Il primo conferma che il modulo è attivato. Il secondo mostra lo stato della connessione, riga per riga.

RigaCosa mostra
VersionLa versione installata del modulo
Registeredyes se il negozio è connesso a Fullmetrix, no altrimenti
Connection codeIl codice in uso. Nascondi questa riga prima di condividere l'output.
Webhooksenabled se le modifiche vengono inviate
QueueIl numero di modifiche in attesa di essere inviate e l'età della più vecchia
orders, customers, products...Il numero di elementi che il negozio può inviare, per tipo

Una Queue che resta a 0 o vicina a 0 è normale. Una coda che cresce ora dopo ora significa che il cron non è in esecuzione o che l'invio a Fullmetrix è bloccato.

Il menu Fullmetrix non compare in Magento

  1. Esci dall'amministrazione di Magento e rientra. Il menu spesso resta in cache nella sessione.
  2. Il tuo sviluppatore controlla che il modulo sia attivato con bin/magento module:status Fullmetrix_Connector. Se non lo è, esegue bin/magento module:enable Fullmetrix_Connector.
  3. Esegue bin/magento setup:upgrade, poi bin/magento setup:di:compile se il negozio è in modalità produzione, poi bin/magento cache:flush.
  4. Se usi un ruolo di amministrazione personalizzato, controlla che la risorsa Fullmetrix sia spuntata, come spiegato in Compatibilità.

Messaggi di errore di connessione

Quando la connessione fallisce, Magento mostra Échec de la connexion (connessione non riuscita) seguito da un motivo. Da riga di comando, il motivo segue il messaggio Connexion echouee. Alcuni motivi tornano in francese anche in un'amministrazione in italiano. Sono citati qui sotto così come compaiono.

Motivo mostratoCosa significaCosa fare
invalid_code_formatIl codice non ha la forma FMTX-XXXX-XXXX-XXXXCopialo di nuovo da Fullmetrix. Non contiene mai le lettere O e I né le cifre 0 e 1.
invalid_storeLa store view scelta non esiste o non è attivaScegli una vista attiva. Da riga di comando, controlla il numero passato a --store-id.
Code de connexion introuvableQuesto codice non esiste in FullmetrixCopia di nuovo il codice mostrato nella tua organizzazione, senza caratteri in più
Plateforme incorrecte pour ce codeIl codice è stato creato per un'altra piattaformaIn Fullmetrix, torna alla scelta della piattaforma, scegli Magento, poi copia il codice mostrato e riprova
Ce code est déjà associé à un autre siteUn negozio ha già accettato questo codiceVedi la sezione successiva
Trop de tentatives, réessayez dans quelques minutes.Troppi tentativi in poco tempoAspetta dieci minuti prima di riprovare
Cette boutique est déjà connectée à une autre Organization.Il negozio appartiene già a un'altra organizzazione FullmetrixUsa quell'organizzazione, oppure rimuovi prima il negozio da essa
Cette boutique a déjà bénéficié d'un essai Fullmetrix...La prova gratuita è già stata usata per questo negozioServe un abbonamento, vedi Fatturazione
invalid_response, HTTP seguito da un numero, o un messaggio di reteIl server non è riuscito a raggiungere correttamente FullmetrixIl tuo sviluppatore controlla che il server possa aprire connessioni HTTPS in uscita verso fullmetrix.com (firewall, proxy, DNS, certificati)

Il codice è "già associato a un altro sito"

Un codice funziona una sola volta. Questo messaggio, Ce code est déjà associé à un autre site, compare quando riprovi con un codice già accettato, per esempio dopo aver cliccato su Disconnect in Magento, o se un'altra installazione (un sito di staging, per esempio) lo ha usato per prima.

Se la scheda del negozio in Fullmetrix funziona ancora, non c'è nulla da fare, la connessione è attiva. Se hai disconnesso il negozio in Magento e vuoi riconnetterlo, ti serve un nuovo codice. Apri Impostazioni, poi Integrazioni, clicca su Disconnetti sulla scheda Magento, conferma, poi aggiungi di nuovo il negozio per ottenere un codice nuovo. Questo cancella i dati importati in Fullmetrix, che vengono poi importati di nuovo dal tuo negozio.

Il negozio è connesso ma i dati smettono di muoversi

  1. In Magento, apri Marketing, poi Fullmetrix, e controlla che il badge Connected sia ancora mostrato.

  2. Il tuo sviluppatore esegue bin/magento fullmetrix:status e guarda la riga Queue. Se cresce, il cron non è in esecuzione o l'invio è bloccato.

  3. Controlla che il cron di Magento sia installato e in esecuzione, poi esegue una volta il gruppo Fullmetrix per provare.

    bin/magento cron:run --group=fullmetrix
  4. Guarda var/log/system.log e var/log/exception.log attorno all'ora del problema.

  5. In Fullmetrix, apri Impostazioni, poi Integrazioni, e leggi la scheda Magento. Un messaggio rosso indica la causa dell'ultimo errore.

La scheda Fullmetrix dice che il negozio è irraggiungibile

Il messaggio L'ultima sincronizzazione non ha potuto raggiungere il tuo negozio. Assicurati che sia online e raggiungibile pubblicamente. Nessun dato è stato aggiornato. significa che Fullmetrix non è riuscito a chiamare il tuo sito. Controlla che il negozio sia online, non in modalità manutenzione, e che nessuna protezione blocchi gli indirizzi /fullmetrix/api/. Se usi Cloudflare, segui Cloudflare e firewall.

Dopo un errore, il pulsante Sincronizza lascia il posto a Riprendi e Reimposta. Una volta risolta la causa, clicca su Riprendi per continuare da dove si era fermata l'importazione. Se Riprendi non è proposto, clicca su Reimposta, che riporta l'avanzamento a zero e riavvia la sincronizzazione senza eliminare gli ordini già importati. Vale anche quando la scheda mostra Sincronizzazione automatica disattivata dopo N errori consecutivi, anche se quel messaggio cita il pulsante Sincronizza. Gli altri stati della scheda sono descritti in Stato della sincronizzazione.

Compaiono errori dopo un aggiornamento del modulo

Su un negozio in modalità produzione, ogni aggiornamento del modulo deve essere seguito da bin/magento setup:upgrade, bin/magento setup:di:compile e bin/magento cache:flush. Se uno di questi comandi è stato dimenticato, possono comparire errori nell'amministrazione o al checkout. Il tuo sviluppatore esegue di nuovo i tre comandi, in quest'ordine.

Il tracciamento dei visitatori non riceve nulla

  • Controlla che il negozio sia connesso, con il badge Connected in Magento.
  • Svuota la cache delle pagine di Magento o la tua cache esterna, perché le pagine servite includano il tracciamento.
  • Fai il tuo test dopo aver accettato i cookie se è presente un banner di consenso.
  • Controlla la ricezione in Script di tracciamento.

Contatta l'assistenza

Se il problema persiste, contattaci con quanto segue.

  • La versione di Magento o Adobe Commerce e la versione di PHP.
  • L'output di bin/magento fullmetrix:status, senza la riga Connection code.
  • La store view connessa e l'indirizzo pubblico del negozio.
  • Il messaggio esatto e l'ora in cui è comparso.
  • Se ci sono un firewall, Cloudflare, la modalità manutenzione o una password sul sito.
  • Le righe rilevanti dei log di Magento, senza dati dei clienti.

Non inviare mai una password né il codice di connessione.

In questa pagina