Rozwiązywanie problemów
Napraw problemy z modułem Magento, od brakującego menu po błędy połączenia i dane, które przestają się przemieszczać.
Zawsze zaczynaj od kontroli, które niczego nie zmieniają. Nie klikaj Disconnect, ani w Magento, ani w Fullmetrix, żeby „zacząć od nowa”. W Magento odłączenie kasuje powiązanie z Fullmetrix, a kodu nie można użyć ponownie. W Fullmetrix usuwa zaimportowane dane.
Kilka kontroli na tej stronie wykonuje się w wierszu poleceń. Przekaż je swojemu programiście.
Dwa polecenia diagnostyczne
Z folderu projektu Magento programista uruchamia te dwa polecenia.
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusPierwsze potwierdza, że moduł jest włączony. Drugie pokazuje stan połączenia, wiersz po wierszu.
| Wiersz | Co pokazuje |
|---|---|
Version | Zainstalowaną wersję modułu |
Registered | yes, jeśli sklep jest połączony z Fullmetrix, w przeciwnym razie no |
Connection code | Używany kod. Ukryj ten wiersz przed udostępnieniem wyniku. |
Webhooks | enabled, jeśli zmiany są wysyłane |
Queue | Liczbę zmian czekających na wysłanie i wiek najstarszej z nich |
orders, customers, products... | Liczbę elementów, które sklep może wysłać, dla każdego typu |
Wartość Queue pozostająca na poziomie 0 lub blisko niego jest normalna. Kolejka, która rośnie godzina po godzinie, oznacza, że cron nie działa albo wysyłanie do Fullmetrix jest zablokowane.
Menu Fullmetrix nie pojawia się w Magento
- Wyloguj się z panelu administracyjnego Magento i zaloguj ponownie. Menu jest często buforowane w sesji.
- Programista sprawdza, czy moduł jest włączony, poleceniem
bin/magento module:status Fullmetrix_Connector. Jeśli nie jest, uruchamiabin/magento module:enable Fullmetrix_Connector. - Uruchamia
bin/magento setup:upgrade, potembin/magento setup:di:compile, jeśli sklep jest w trybie produkcyjnym, a następniebin/magento cache:flush. - Jeśli używasz niestandardowej roli administratora, sprawdź, czy zasób Fullmetrix jest zaznaczony, jak wyjaśniamy w Zgodności.
Komunikaty o błędach połączenia
Gdy połączenie się nie powiedzie, Magento pokazuje Échec de la connexion (niepowodzenie połączenia), a po nim powód. W wierszu poleceń powód następuje po komunikacie Connexion echouee. Niektóre powody wracają po francusku nawet w panelu po angielsku. Cytujemy je poniżej tak, jak się pojawiają.
| Wyświetlony powód | Co oznacza | Co zrobić |
|---|---|---|
invalid_code_format | Kod nie ma formatu FMTX-XXXX-XXXX-XXXX | Skopiuj go ponownie z Fullmetrix. Nigdy nie zawiera liter O i I ani cyfr 0 i 1. |
invalid_store | Wybrany widok sklepu nie istnieje albo nie jest aktywny | Wybierz aktywny widok. W wierszu poleceń sprawdź numer przekazany w --store-id. |
| Code de connexion introuvable | Ten kod nie istnieje w Fullmetrix | Skopiuj ponownie kod wyświetlony w Twojej organizacji, bez dodatkowych znaków |
| Plateforme incorrecte pour ce code | Kod został utworzony dla innej platformy | W Fullmetrix wróć do wyboru platformy, wybierz Magento, a potem skopiuj wyświetlony kod i spróbuj ponownie |
| Ce code est déjà associé à un autre site | Jakiś sklep już przyjął ten kod | Zobacz następną sekcję |
| Trop de tentatives, réessayez dans quelques minutes. | Zbyt wiele prób w krótkim czasie | Poczekaj dziesięć minut, zanim spróbujesz ponownie |
| Cette boutique est déjà connectée à une autre Organization. | Sklep należy już do innej organizacji Fullmetrix | Użyj tej organizacji albo najpierw usuń z niej sklep |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | Bezpłatny okres próbny został już wykorzystany dla tego sklepu | Wymagana jest subskrypcja, zobacz Rozliczenia |
invalid_response, HTTP z numerem albo komunikat sieciowy | Serwer nie zdołał prawidłowo połączyć się z Fullmetrix | Programista sprawdza, czy serwer może otwierać wychodzące połączenia HTTPS do fullmetrix.com (zapora, proxy, DNS, certyfikaty) |
Kod jest „już powiązany z inną witryną”
Kod działa tylko raz. Komunikat Ce code est déjà associé à un autre site pojawia się, gdy ponawiasz próbę z kodem, który został już przyjęty, na przykład po kliknięciu Disconnect w Magento albo gdy pierwsza użyła go inna instalacja (na przykład witryna testowa).
Jeśli karta sklepu w Fullmetrix nadal działa, nie trzeba nic robić, połączenie jest na miejscu. Jeśli sklep został odłączony w Magento i chcesz go połączyć ponownie, potrzebujesz nowego kodu. Otwórz Ustawienia, potem Integracje, kliknij Odłącz na karcie Magento, potwierdź, a następnie dodaj sklep ponownie, aby otrzymać świeży kod. To kasuje dane zaimportowane do Fullmetrix, które są potem importowane ponownie z Twojego sklepu.
Sklep jest połączony, ale dane przestają się przemieszczać
-
W Magento otwórz Marketing, potem Fullmetrix i sprawdź, czy nadal widać plakietkę Connected.
-
Programista uruchamia
bin/magento fullmetrix:statusi patrzy na wierszQueue. Jeśli rośnie, cron nie działa albo wysyłanie jest zablokowane. -
Sprawdza, czy cron Magento jest zainstalowany i działa, a potem raz uruchamia grupę Fullmetrix, żeby to przetestować.
bin/magento cron:run --group=fullmetrix -
Przegląda
var/log/system.logivar/log/exception.logw okolicach czasu wystąpienia problemu. -
W Fullmetrix otwórz Ustawienia, potem Integracje i przeczytaj kartę Magento. Czerwony komunikat podaje przyczynę ostatniego błędu.
Karta Fullmetrix informuje, że sklep jest nieosiągalny
Komunikat Ostatnia synchronizacja nie mogła dotrzeć do Twojego sklepu. Upewnij się, że jest on-line i publicznie dostępny. Żadne dane nie zostały zaktualizowane. oznacza, że Fullmetrix nie zdołał wywołać Twojej witryny. Sprawdź, czy sklep jest online, nie jest w trybie konserwacji i czy żadna ochrona nie blokuje adresów /fullmetrix/api/. Jeśli korzystasz z Cloudflare, postępuj zgodnie z Cloudflare i zapory.
Po błędzie przycisk Synchronizuj ustępuje miejsca przyciskom Wznów i Resetuj. Gdy przyczyna zostanie usunięta, kliknij Wznów, aby kontynuować od miejsca, w którym import się zatrzymał. Jeśli Wznów nie jest oferowany, kliknij Resetuj, co zeruje postęp i uruchamia synchronizację ponownie bez kasowania zamówień, które już zaimportowano. Dotyczy to także sytuacji, gdy karta pokazuje Automatyczna synchronizacja wyłączona po N kolejnych błędów, choć ten komunikat wspomina o przycisku Synchronizuj. Pozostałe stany karty opisuje Stan synchronizacji.
Błędy pojawiają się po aktualizacji modułu
W sklepie w trybie produkcyjnym po każdej aktualizacji modułu muszą nastąpić bin/magento setup:upgrade, bin/magento setup:di:compile i bin/magento cache:flush. Jeśli któreś z tych poleceń pominięto, w panelu administracyjnym lub w kasie mogą pojawić się błędy. Programista uruchamia te trzy polecenia ponownie, w tej kolejności.
Śledzenie odwiedzających nic nie odbiera
- Sprawdź, czy sklep jest połączony, z plakietką Connected w Magento.
- Wyczyść pamięć podręczną stron Magento albo swoją zewnętrzną pamięć podręczną, aby serwowane strony zawierały śledzenie.
- Wykonaj test po zaakceptowaniu plików cookie, jeśli działa baner zgody.
- Sprawdź dostarczanie w Skrypcie śledzenia.
Skontaktuj się z pomocą techniczną
Jeśli problem nie ustępuje, skontaktuj się z nami i podaj poniższe informacje.
- Wersję Magento lub Adobe Commerce i wersję PHP.
- Wynik
bin/magento fullmetrix:status, z usuniętym wierszemConnection code. - Połączony widok sklepu i publiczny adres sklepu.
- Dokładny komunikat i godzinę, o której się pojawił.
- Informację, czy na witrynie jest zapora, Cloudflare, tryb konserwacji albo hasło.
- Istotne wiersze z logów Magento, bez danych klientów.
Nigdy nie wysyłaj hasła ani kodu połączenia.