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:statusIl primo conferma che il modulo è attivato. Il secondo mostra lo stato della connessione, riga per riga.
| Riga | Cosa mostra |
|---|---|
Version | La versione installata del modulo |
Registered | yes se il negozio è connesso a Fullmetrix, no altrimenti |
Connection code | Il codice in uso. Nascondi questa riga prima di condividere l'output. |
Webhooks | enabled se le modifiche vengono inviate |
Queue | Il 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
- Esci dall'amministrazione di Magento e rientra. Il menu spesso resta in cache nella sessione.
- Il tuo sviluppatore controlla che il modulo sia attivato con
bin/magento module:status Fullmetrix_Connector. Se non lo è, eseguebin/magento module:enable Fullmetrix_Connector. - Esegue
bin/magento setup:upgrade, poibin/magento setup:di:compilese il negozio è in modalità produzione, poibin/magento cache:flush. - 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 mostrato | Cosa significa | Cosa fare |
|---|---|---|
invalid_code_format | Il codice non ha la forma FMTX-XXXX-XXXX-XXXX | Copialo di nuovo da Fullmetrix. Non contiene mai le lettere O e I né le cifre 0 e 1. |
invalid_store | La store view scelta non esiste o non è attiva | Scegli una vista attiva. Da riga di comando, controlla il numero passato a --store-id. |
| Code de connexion introuvable | Questo codice non esiste in Fullmetrix | Copia di nuovo il codice mostrato nella tua organizzazione, senza caratteri in più |
| Plateforme incorrecte pour ce code | Il codice è stato creato per un'altra piattaforma | In Fullmetrix, torna alla scelta della piattaforma, scegli Magento, poi copia il codice mostrato e riprova |
| Ce code est déjà associé à un autre site | Un negozio ha già accettato questo codice | Vedi la sezione successiva |
| Trop de tentatives, réessayez dans quelques minutes. | Troppi tentativi in poco tempo | Aspetta dieci minuti prima di riprovare |
| Cette boutique est déjà connectée à une autre Organization. | Il negozio appartiene già a un'altra organizzazione Fullmetrix | Usa 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 negozio | Serve un abbonamento, vedi Fatturazione |
invalid_response, HTTP seguito da un numero, o un messaggio di rete | Il server non è riuscito a raggiungere correttamente Fullmetrix | Il 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
-
In Magento, apri Marketing, poi Fullmetrix, e controlla che il badge Connected sia ancora mostrato.
-
Il tuo sviluppatore esegue
bin/magento fullmetrix:statuse guarda la rigaQueue. Se cresce, il cron non è in esecuzione o l'invio è bloccato. -
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 -
Guarda
var/log/system.logevar/log/exception.logattorno all'ora del problema. -
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 rigaConnection 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.