Resolução de problemas
Resolva problemas do módulo Magento, desde um menu em falta até erros de ligação e dados que deixam de circular.
Comece sempre por verificações que não alteram nada. Não clique em Disconnect nem em Desligar, no Magento ou no Fullmetrix, para "recomeçar do zero". No Magento, desligar apaga a ligação com o Fullmetrix e o código não pode ser reutilizado. No Fullmetrix, elimina os dados importados.
Várias verificações desta página fazem-se na linha de comandos. Passe-as ao seu programador.
Os dois comandos de diagnóstico
A partir da pasta do projeto Magento, o seu programador executa estes dois comandos.
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusO primeiro confirma que o módulo está ativado. O segundo mostra o estado da ligação, linha a linha.
| Linha | O que mostra |
|---|---|
Version | A versão instalada do módulo |
Registered | yes se a loja está ligada ao Fullmetrix, no caso contrário |
Connection code | O código em uso. Oculte esta linha antes de partilhar o resultado. |
Webhooks | enabled se as alterações estão a ser enviadas |
Queue | O número de alterações à espera de serem enviadas e a idade da mais antiga |
orders, customers, products... | O número de itens que a loja pode enviar, por tipo |
Uma Queue que fica em 0 ou perto disso é normal. Uma fila que cresce hora após hora significa que o cron não está a funcionar ou que o envio para o Fullmetrix está bloqueado.
O menu Fullmetrix não aparece no Magento
- Termine a sessão na administração do Magento e inicie-a de novo. O menu fica muitas vezes em cache na sessão.
- O seu programador verifica se o módulo está ativado com
bin/magento module:status Fullmetrix_Connector. Se não estiver, executabin/magento module:enable Fullmetrix_Connector. - Executa
bin/magento setup:upgrade, depoisbin/magento setup:di:compilese a loja estiver em modo de produção, e depoisbin/magento cache:flush. - Se usa uma função de administração personalizada, verifique se o recurso Fullmetrix está assinalado, como explicado em Compatibilidade.
Mensagens de erro de ligação
Quando a ligação falha, o Magento mostra Échec de la connexion (falha da ligação) seguido de um motivo. Na linha de comandos, o motivo segue-se à mensagem Connexion echouee. Alguns motivos voltam em francês mesmo numa administração em inglês. São citados abaixo tal como aparecem.
| Motivo mostrado | O que significa | O que fazer |
|---|---|---|
invalid_code_format | O código não tem o formato FMTX-XXXX-XXXX-XXXX | Copie-o de novo a partir do Fullmetrix. Nunca contém as letras O e I nem os algarismos 0 e 1. |
invalid_store | A vista de loja escolhida não existe ou não está ativa | Escolha uma vista ativa. Na linha de comandos, verifique o número passado a --store-id. |
| Code de connexion introuvable | Este código não existe no Fullmetrix | Copie de novo o código mostrado na sua organização, sem carateres a mais |
| Plateforme incorrecte pour ce code | O código foi criado para outra plataforma | No Fullmetrix, volte à escolha da plataforma, escolha Magento, copie o código mostrado e tente de novo |
| Ce code est déjà associé à un autre site | Uma loja já aceitou este código | Veja a secção seguinte |
| Trop de tentatives, réessayez dans quelques minutes. | Demasiadas tentativas num curto espaço de tempo | Aguarde dez minutos antes de tentar de novo |
| Cette boutique est déjà connectée à une autre Organization. | A loja já pertence a outra organização do Fullmetrix | Use essa organização, ou remova primeiro a loja dela |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | O período de teste gratuito já foi usado para esta loja | É necessária uma subscrição, veja Faturação |
invalid_response, HTTP seguido de um número, ou uma mensagem de rede | O servidor não conseguiu contactar corretamente o Fullmetrix | O seu programador verifica se o servidor consegue abrir ligações HTTPS de saída para fullmetrix.com (firewall, proxy, DNS, certificados) |
O código está "already associated with another site"
Um código só funciona uma vez. Esta mensagem, Ce code est déjà associé à un autre site, aparece quando tenta de novo com um código que já foi aceite, por exemplo depois de clicar em Disconnect no Magento, ou se outra instalação (um site de teste, por exemplo) o usou primeiro.
Se o cartão da loja no Fullmetrix ainda funciona, não há nada a fazer, a ligação está feita. Se desligou a loja no Magento e quer voltar a ligá-la, precisa de um novo código. Abra Definições e depois Integrações, clique em Desligar no cartão do Magento, confirme e adicione depois a loja de novo para obter um código novo. Isto apaga os dados importados no Fullmetrix, que são depois importados de novo a partir da sua loja.
A loja está ligada mas os dados deixam de circular
-
No Magento, abra Marketing e depois Fullmetrix e verifique se o selo Connected continua a aparecer.
-
O seu programador executa
bin/magento fullmetrix:statuse vê a linhaQueue. Se cresce, o cron não está a funcionar ou o envio está bloqueado. -
Verifica se o cron do Magento está instalado e a funcionar e executa uma vez o grupo Fullmetrix para testar.
bin/magento cron:run --group=fullmetrix -
Consulta
var/log/system.logevar/log/exception.logpor volta da hora do problema. -
No Fullmetrix, abra Definições e depois Integrações e leia o cartão do Magento. Uma mensagem vermelha indica a causa do último erro.
O cartão do Fullmetrix diz que a loja está inacessível
A mensagem A última sincronização não conseguiu aceder à sua loja. Certifique-se de que está online e acessível publicamente. Nenhum dado foi atualizado. significa que o Fullmetrix não conseguiu chamar o seu site. Verifique se a loja está online, sem modo de manutenção, e se nenhuma proteção bloqueia os endereços /fullmetrix/api/. Se usa o Cloudflare, siga Cloudflare e firewalls.
Depois de um erro, o botão Sincronizar dá lugar a Retomar e Repor. Depois de corrigida a causa, clique em Retomar para continuar de onde a importação parou. Se Retomar não for proposto, clique em Repor, que volta a pôr o progresso a zero e reinicia a sincronização sem eliminar as encomendas já importadas. Isto aplica-se também quando o cartão mostra Auto-sincronização desativada após vários erros consecutivos, embora essa mensagem mencione o botão Sincronizar. Os outros estados do cartão estão descritos em Estado da sincronização.
Aparecem erros depois de uma atualização do módulo
Numa loja em modo de produção, cada atualização do módulo tem de ser seguida de bin/magento setup:upgrade, bin/magento setup:di:compile e bin/magento cache:flush. Se um destes comandos foi esquecido, podem aparecer erros na administração ou no checkout. O seu programador volta a executar os três comandos, por esta ordem.
O rastreio de visitantes não recebe nada
- Verifique se a loja está ligada, com o selo Connected no Magento.
- Limpe a cache de páginas do Magento ou a sua cache externa, para que as páginas servidas incluam o rastreio.
- Faça o seu teste depois de aceitar os cookies, se existir um banner de consentimento.
- Verifique a receção em Script de rastreio.
Contactar o suporte
Se o problema persistir, contacte-nos com o seguinte.
- A versão do Magento ou do Adobe Commerce e a versão do PHP.
- O resultado de
bin/magento fullmetrix:status, sem a linhaConnection code. - A vista de loja ligada e o endereço público da loja.
- A mensagem exata e a hora a que apareceu.
- Se existe uma firewall, o Cloudflare, o modo de manutenção ou uma palavra-passe no site.
- Linhas relevantes dos registos do Magento, sem dados de clientes.
Nunca envie uma palavra-passe nem o código de ligação.