fullmetrixDocs

Fehlerbehebung

Beheben Sie Probleme mit dem Sylius-Plugin, von einer fehlgeschlagenen Installation bis zu einem Import, der nicht abgeschlossen wird.

Beginnen Sie immer mit Prüfungen, die nichts verändern. Klicken Sie weder in Sylius noch in Fullmetrix auf Disconnect bzw. Trennen, um "von vorn anzufangen". In Sylius kappt das Trennen die Verbindung, und der Code lässt sich nicht wiederverwenden. In Fullmetrix löscht es die importierten Daten.

Mehrere Prüfungen auf dieser Seite betreffen den Projektcode. Geben Sie sie an Ihren Entwickler weiter, mit der Uhrzeit und der genauen Meldung des Problems.

Composer weigert sich, das Plugin zu installieren

Ihr Entwickler führt diesen Befehl aus, um herauszufinden, was die Installation blockiert.

composer why-not fullmetrix/sylius-plugin '*'

Die üblichen Ursachen sind eine PHP-Version unter 8.1, eine fehlende cURL- oder JSON-Erweiterung oder eine Version von Sylius, Symfony oder Doctrine außerhalb der Liste unter Kompatibilität. Er löst die Abhängigkeiten auf seinem Rechner auf und deployt dann die entstandene Datei composer.lock. Den Ordner vendor/ von einem Rechner auf einen anderen zu kopieren, ist keine gute Idee, wenn die PHP-Versionen abweichen.

Symfony lädt das Plugin nicht

Wenn bin/console cache:clear fehlschlägt oder keine Fullmetrix-Route existiert, prüfen Sie, dass config/bundles.php diese Zeile enthält.

Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],

Ihr Entwickler führt dann composer dump-autoload aus und leert den Cache mit derselben Umgebung wie die Live-Website. Bei mehreren Servern prüft er jeden einzelnen.

Die Fullmetrix-Seite erscheint nicht im Admin

  1. Öffnen Sie die Adresse /admin/fullmetrix Ihres Shops direkt mit einem Admin-Konto. Wenn die Seite erscheint, fehlt nur das Menü, oft wegen eines angepassten Admin-Menüs oder Themes.
  2. Wenn die Adresse einen Fehler 404 zurückgibt, sind die Routen nicht importiert. Ihr Entwickler prüft die Datei config/routes/fullmetrix.yaml und führt dann bin/console debug:router fullmetrix_admin_connection aus, was die Route anzeigen muss.
  3. Er leert den Cache, danach laden Sie die Seite neu.

Die Migration schlägt fehl

  • Sichern Sie die Datenbank, bevor Sie es erneut versuchen.
  • Ihr Entwickler prüft bin/console doctrine:migrations:status und den ersten angezeigten Fehler.
  • Er prüft, dass der Datenbankbenutzer Tabellen anlegen darf.
  • Er legt die Tabellen nicht von Hand an und markiert die Migration nicht als ausgeführt, ohne den Fehler zu verstehen.

Fehlermeldungen bei der Verbindung

Wenn die Verbindung fehlschlägt, zeigt die Seite Connection failed gefolgt von einem Grund. Einige Gründe erscheinen auf Französisch. Sie sind unten so zitiert, wie sie angezeigt werden.

Angezeigter GrundWas er bedeutetWas zu tun ist
invalid_code_formatDer Code hat nicht die Form FMTX-XXXX-XXXX-XXXXKopieren Sie ihn erneut aus Fullmetrix. Er enthält nie die Buchstaben O und I oder die Ziffern 0 und 1.
storage_failedDas Plugin konnte seine Einstellungen nicht speichernWahrscheinlich wurde die Migration nicht ausgeführt. Ihr Entwickler führt bin/console doctrine:migrations:migrate aus.
Code de connexion introuvableDieser Code existiert in Fullmetrix nichtKopieren Sie den in Ihrer Organisation angezeigten Code erneut, ohne zusätzliche Zeichen
Plateforme incorrecte pour ce codeDer Code wurde für eine andere Plattform erstelltGehen Sie in Fullmetrix zurück zur Plattformauswahl, wählen Sie Sylius, kopieren Sie dann den angezeigten Code und versuchen Sie es erneut
Ce code est déjà associé à un autre siteEin Shop hat diesen Code bereits akzeptiertSiehe den nächsten Abschnitt
Trop de tentatives, réessayez dans quelques minutes.Zu viele Versuche in kurzer ZeitWarten Sie zehn Minuten, bevor Sie es erneut versuchen
Cette boutique est déjà connectée à une autre Organization.Der Shop gehört bereits zu einer anderen Fullmetrix-OrganisationVerwenden Sie diese Organisation oder entfernen Sie den Shop zuerst daraus
Cette boutique a déjà bénéficié d'un essai Fullmetrix...Die kostenlose Testphase wurde für diesen Shop bereits genutztEin Abonnement ist erforderlich, siehe Abrechnung
invalid_response, register_failed oder eine NetzwerkmeldungDer Server konnte Fullmetrix nicht richtig erreichenIhr Entwickler prüft, dass PHP ausgehende HTTPS-Verbindungen zu fullmetrix.com öffnen kann (Firewall, Proxy, DNS, Zertifikate)

Teilen Sie keinen aktiven Code

Der Code ist ein Geheimnis. Wenn Sie einen Screenshot der Fullmetrix-Seite in Sylius senden, verdecken Sie das Feld Connection code vollständig.

Der Code ist "bereits mit einer anderen Website verknüpft"

Ein Code funktioniert nur einmal. Diese Meldung, Ce code est déjà associé à un autre site, erscheint, wenn Sie es mit einem Code erneut versuchen, der bereits akzeptiert wurde, zum Beispiel nach einem Klick auf Disconnect in Sylius oder wenn eine andere Installation (etwa eine Staging-Website) ihn zuerst verwendet hat.

Wenn die Shop-Karte in Fullmetrix weiterhin funktioniert, ist nichts zu tun. Wenn Sie den Shop in Sylius getrennt haben und ihn erneut verbinden möchten, brauchen Sie einen neuen Code. Öffnen Sie Einstellungen und dann Integrationen, klicken Sie auf der Sylius-Karte auf Trennen, bestätigen Sie und fügen Sie den Shop dann erneut hinzu, um einen frischen Code zu erhalten. Dadurch werden die in Fullmetrix importierten Daten gelöscht und anschließend erneut aus Ihrem Shop importiert.

Verbunden, aber der Import wird nicht abgeschlossen

  1. Öffnen Sie in Sylius Marketing und dann Fullmetrix und sehen Sie sich das Feld Sync activity an. Notieren Sie, ob es Waiting for sync, Sync in progress oder Sync complete anzeigt.
  2. Lesen Sie das Feld Recent activity. Eine Zeile sync_error enthält die Ursache des Fehlers. Notieren Sie sie, bevor Sie auf Clear logs klicken.
  3. Lesen Sie in Fullmetrix die Sylius-Karte unter Einstellungen und dann Integrationen. Die Meldung Die letzte Synchronisierung konnte Ihren Shop nicht erreichen bedeutet, dass Fullmetrix Ihre Website nicht aufrufen konnte.
  4. Ihr Entwickler prüft, dass die Adressen unter /fullmetrix/api/ durch den Proxy, den Cache und die Firewall gelangen. Wenn Sie Cloudflare nutzen, folgen Sie Cloudflare und Firewalls.
  5. Er prüft die PHP- und Webserver-Logs zum Zeitpunkt des Problems und dass jeder Server dieselbe Plugin-Version ausführt.

Nach einem Fehler weichen die Schaltflächen Synchronisieren den Schaltflächen Fortsetzen und Zurücksetzen. Sobald die Ursache behoben ist, klicken Sie auf Fortsetzen, um dort weiterzumachen, wo der Import stehen geblieben ist. Wird Fortsetzen nicht angeboten, klicken Sie auf Zurücksetzen. Das setzt den Fortschritt auf null zurück und startet die Synchronisierung neu, ohne bereits importierte Bestellungen zu löschen. Die übrigen Zustände der Karte werden unter Sync-Status beschrieben.

Die Shop-Adresse ist in Fullmetrix falsch

Die Karte zeigt die Adresse, die das Plugin bei der Verbindung gesendet hat. Ist es eine interne Adresse, eine HTTP-Adresse oder eine andere Domain, wurde der Admin mit dieser Adresse geöffnet, oder Symfony vertraut dem Proxy vor der Website nicht. Ihr Entwickler korrigiert die Proxy-Konfiguration. Damit die richtige Adresse gespeichert wird, muss der Shop danach mit einem neuen Code erneut verbunden werden, wie oben erklärt.

Das Besucher-Tracking empfängt nichts

  • Prüfen Sie, dass die Fullmetrix-Seite in Sylius weiterhin Connected anzeigt.
  • Testen Sie auf einer öffentlichen Seite des Shops, nicht im Admin.
  • Leeren Sie jeden Seiten-Cache vor der Website.
  • Führen Sie Ihren Test nach dem Akzeptieren der Cookies durch, falls ein Einwilligungsbanner aktiv ist.
  • Prüfen Sie die Zustellung unter Tracking-Skript.

Den Support kontaktieren

Wenn das Problem bestehen bleibt, kontaktieren Sie uns mit den folgenden Angaben.

  • Die öffentliche Adresse des Shops und der Name Ihrer Fullmetrix-Organisation.
  • Die Versionen von Sylius, Plugin, PHP, Symfony und Doctrine.
  • Die genaue Meldung, die Uhrzeit ihres Erscheinens und die Zeitzone.
  • Die Ausgabe von bin/console debug:router fullmetrix_admin_connection.
  • Ein Screenshot der Felder Sync activity und Recent activity, mit verdecktem Code.

Senden Sie niemals ein Passwort, einen Verbindungscode oder einen Auszug Ihrer Produktionsdatenbank.

Auf dieser Seite