Probleemoplossing
Los problemen met de Magento-module op, van een ontbrekend menu tot verbindingsfouten en gegevens die niet meer bewegen.
Begin altijd met controles die niets veranderen. Klik niet op Disconnect in Magento of op Ontkoppelen in Fullmetrix om "opnieuw te beginnen". In Magento wist ontkoppelen de link met Fullmetrix en kan de code niet opnieuw worden gebruikt. In Fullmetrix verwijdert het de geïmporteerde gegevens.
Verschillende controles op deze pagina worden op de opdrachtregel uitgevoerd. Geef ze door aan je ontwikkelaar.
De twee diagnosecommando's
Je ontwikkelaar voert vanuit de map van het Magento-project deze twee commando's uit.
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusHet eerste bevestigt dat de module is ingeschakeld. Het tweede toont de verbindingsstatus, regel voor regel.
| Regel | Wat hij toont |
|---|---|
Version | De geïnstalleerde moduleversie |
Registered | yes als de winkel met Fullmetrix is verbonden, anders no |
Connection code | De code die in gebruik is. Verberg deze regel voordat je de uitvoer deelt. |
Webhooks | enabled als wijzigingen worden verstuurd |
Queue | Het aantal wijzigingen dat op verzending wacht en de leeftijd van de oudste |
orders, customers, products... | Het aantal items dat de winkel kan sturen, per type |
Een Queue die op of vlak bij 0 blijft, is normaal. Een wachtrij die uur na uur groeit, betekent dat de cron niet draait of dat het verzenden naar Fullmetrix is geblokkeerd.
Het Fullmetrix-menu verschijnt niet in Magento
- Log uit het Magento-beheer en weer in. Het menu wordt vaak in de sessie gecachet.
- Je ontwikkelaar controleert met
bin/magento module:status Fullmetrix_Connectorof de module is ingeschakeld. Zo niet, dan voert hij of zijbin/magento module:enable Fullmetrix_Connectoruit. - Daarna voert hij of zij
bin/magento setup:upgradeuit, vervolgensbin/magento setup:di:compileals de winkel in productiemodus draait, en tot slotbin/magento cache:flush. - Gebruik je een aangepaste beheerdersrol, controleer dan of de resource Fullmetrix is aangevinkt, zoals uitgelegd in Compatibiliteit.
Foutmeldingen bij het verbinden
Mislukt de verbinding, dan toont Magento Échec de la connexion (verbinding mislukt) gevolgd door een reden. Op de opdrachtregel volgt de reden op de melding Connexion echouee. Sommige redenen komen in het Frans terug, ook in een Engelstalig beheer. Ze worden hieronder geciteerd zoals ze verschijnen.
| Getoonde reden | Wat het betekent | Wat je doet |
|---|---|---|
invalid_code_format | De code heeft niet de vorm FMTX-XXXX-XXXX-XXXX | Kopieer hem opnieuw uit Fullmetrix. Hij bevat nooit de letters O en I of de cijfers 0 en 1. |
invalid_store | De gekozen storeview bestaat niet of is niet actief | Kies een actieve view. Controleer op de opdrachtregel het nummer dat aan --store-id is meegegeven. |
| Code de connexion introuvable | Deze code bestaat niet in Fullmetrix | Kopieer de code die in je organisatie wordt getoond opnieuw, zonder extra tekens |
| Plateforme incorrecte pour ce code | De code is aangemaakt voor een ander platform | Ga in Fullmetrix terug naar de platformkeuze, kies Magento, kopieer de getoonde code en probeer opnieuw |
| Ce code est déjà associé à un autre site | Een winkel heeft deze code al geaccepteerd | Zie de volgende sectie |
| Trop de tentatives, réessayez dans quelques minutes. | Te veel pogingen in korte tijd | Wacht tien minuten voordat je het opnieuw probeert |
| Cette boutique est déjà connectée à une autre Organization. | De winkel hoort al bij een andere Fullmetrix-organisatie | Gebruik die organisatie, of verwijder de winkel er eerst uit |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | De gratis proefperiode is voor deze winkel al gebruikt | Een abonnement is nodig, zie Facturering |
invalid_response, HTTP gevolgd door een getal, of een netwerkmelding | De server kon Fullmetrix niet goed bereiken | Je ontwikkelaar controleert of de server uitgaande HTTPS-verbindingen naar fullmetrix.com kan openen (firewall, proxy, DNS, certificaten) |
De code is "already associated with another site"
Een code werkt maar één keer. Deze melding, Ce code est déjà associé à un autre site, verschijnt wanneer je het opnieuw probeert met een code die al is geaccepteerd, bijvoorbeeld nadat je in Magento op Disconnect hebt geklikt, of als een andere installatie (bijvoorbeeld een stagingsite) hem eerst heeft gebruikt.
Werkt de winkelkaart in Fullmetrix nog, dan hoef je niets te doen, de verbinding is er. Heb je de winkel in Magento losgekoppeld en wil je hem opnieuw verbinden, dan heb je een nieuwe code nodig. Open Instellingen en daarna Integraties, klik op de Magento-kaart op Ontkoppelen, bevestig en voeg de winkel opnieuw toe om een verse code te krijgen. Hiermee worden de gegevens gewist die in Fullmetrix zijn geïmporteerd, die daarna opnieuw uit je winkel worden geïmporteerd.
De winkel is verbonden maar de gegevens bewegen niet meer
-
Open in Magento Marketing en daarna Fullmetrix en controleer of de badge Connected nog wordt getoond.
-
Je ontwikkelaar voert
bin/magento fullmetrix:statusuit en kijkt naar de regelQueue. Groeit die, dan draait de cron niet of is het verzenden geblokkeerd. -
Hij of zij controleert of de Magento-cron is geïnstalleerd en draait en voert de Fullmetrix-groep daarna eenmalig uit om te testen.
bin/magento cron:run --group=fullmetrix -
Hij of zij bekijkt
var/log/system.logenvar/log/exception.logrond het tijdstip van het probleem. -
Open in Fullmetrix Instellingen en daarna Integraties en lees de Magento-kaart. Een rode melding geeft de oorzaak van de laatste fout.
De Fullmetrix-kaart zegt dat de winkel onbereikbaar is
De melding De laatste synchronisatie kon uw winkel niet bereiken. Zorg ervoor dat deze online en openbaar bereikbaar is. Er zijn geen gegevens bijgewerkt. betekent dat Fullmetrix je site niet kon aanroepen. Controleer of de winkel online is, niet in onderhoudsmodus staat en geen enkele bescherming de adressen /fullmetrix/api/ blokkeert. Gebruik je Cloudflare, volg dan Cloudflare en firewalls.
Na een fout maakt de knop Synchroniseren plaats voor Hervatten en Resetten. Klik na het oplossen van de oorzaak op Hervatten om verder te gaan waar de import stopte. Wordt Hervatten niet aangeboden, klik dan op Resetten. Die zet de voortgang terug naar nul en start de synchronisatie opnieuw, zonder bestellingen die al zijn geïmporteerd te wissen. Dit geldt ook wanneer de kaart Automatische synchronisatie uitgeschakeld na N opeenvolgende fouten toont, ook al noemt die melding de knop Synchroniseren. De andere statussen van de kaart worden beschreven in Synchronisatiestatus.
Na een module-update verschijnen er fouten
Bij een winkel in productiemodus moet elke module-update worden gevolgd door bin/magento setup:upgrade, bin/magento setup:di:compile en bin/magento cache:flush. Is een van deze commando's vergeten, dan kunnen er fouten verschijnen in het beheer of bij het afrekenen. Je ontwikkelaar voert de drie commando's opnieuw uit, in deze volgorde.
De bezoekerstracking ontvangt niets
- Controleer of de winkel is verbonden, met de badge Connected in Magento.
- Leeg de paginacache van Magento of je externe cache, zodat de geserveerde pagina's de tracking bevatten.
- Voer je test uit nadat je cookies hebt geaccepteerd als er een toestemmingsbanner is.
- Controleer de aflevering in Trackingscript.
Contact opnemen met support
Blijft het probleem, neem dan contact met ons op met het volgende.
- De versie van Magento of Adobe Commerce en de PHP-versie.
- De uitvoer van
bin/magento fullmetrix:status, met de regelConnection codeverwijderd. - De verbonden storeview en het openbare adres van de winkel.
- De exacte melding en het tijdstip waarop die verscheen.
- Of er een firewall, Cloudflare, onderhoudsmodus of een wachtwoord op de site zit.
- Relevante regels uit de Magento-logs, zonder klantgegevens.
Stuur nooit een wachtwoord of de verbindingscode.