2. Dashlink Print: Znane problemy i rozwiązywanie problemów
Podręcznik rozwiązywania problemów dla Dashlink Print. Obejmuje powszechne błędy drukowania, problemy z przeglądarką, problemy z QZ Tray oraz ich rozwiązania.
Przewodnik krok po kroku
Przewodnik po problemach i rozwiązaniach Dashlink Print
Ten artykuł zawiera kompleksowy przewodnik po znanych problemach i krokach rozwiązywania problemów dla użytkowników Dashlink Print. Jest przeznaczony dla użytkowników, którzy doświadczają problemów z instalacją, działaniem lub konfliktami oprogramowania.
Wymagania wstępne
Przed zainstalowaniem Dashlink Print musisz upewnić się, że wszystkie wcześniejsze wersje QZ Tray zostały odinstalowane. Każdy klient będzie musiał ręcznie odinstalować QZ Tray najpierw, ponieważ te dwie aplikacje nie powinny współistnieć, ponieważ będą walczyć o ten sam numer portu. Dla systemu Windows odinstalowanie można przeprowadzić przez Panel sterowania/Ustawienia systemowe. Dla systemu Mac aplikację można przeciągnąć do kosza, lub zaawansowani użytkownicy mogą chcieć uruchomić skrypt odinstalowujący. Dla systemu Linux potrzebny jest skrypt odinstalowujący.
Odinstaluj QZ Tray na Windows przez Panel sterowania/Ustawienia systemowe, na Macu przeciągając aplikację do kosza lub używając skryptu odinstalowującego, a na Linuxie używając skryptu odinstalowującego. Te kroki zapobiegają konfliktom, ponieważ obie aplikacje używają tego samego numeru portu.
Dla systemu Windows odinstalowanie można przeprowadzić przez Panel sterowania/Ustawienia systemowe.
Dla systemu Windows odinstalowanie można przeprowadzić przez Panel sterowania/Ustawienia systemowe.
Dla systemu Mac aplikację można przeciągnąć do kosza, lub zaawansowani użytkownicy mogą chcieć uruchomić skrypt odinstalowujący.
Dla systemu Mac aplikację można przeciągnąć do kosza, lub zaawansowani użytkownicy mogą chcieć uruchomić skrypt odinstalowujący.
Dla systemu Linux potrzebny jest skrypt odinstalowujący.
Dla systemu Linux potrzebny jest skrypt odinstalowujący.
Znane problemy: Konfliktujące aplikacje
Posiadanie dwóch wersji Dashlink Print i/lub QZ Tray zainstalowanych jednocześnie może powodować konflikty. Upewnij się, że zainstalowana jest tylko jedna wersja. Oprogramowanie antywirusowe może blokować komunikację Dashlink Print. Dodaj wyjątek dla aplikacji Dashlink Print w ustawieniach swojego oprogramowania antywirusowego. Ustawienia zapory mogą blokować połączenia WebSocket. Upewnij się, że port 8181 (lub skonfigurowany port) jest dozwolony przez zaporę.
Aplikacje konfliktowe, takie jak starsze wersje Javy i niektóre oprogramowania antywirusowe, mogą uniemożliwić prawidłowe działanie Dashlink Print. Upewnij się, że zainstalowana jest Java 11 lub wyższa i rozważ odinstalowanie konfliktowego oprogramowania antywirusowego, takiego jak Comodo.
Rozwiązywanie konfliktów Java
Starsze wersje Java mogą powodować konflikty. Jeśli odinstalowanie nie jest możliwe, Dashlink Print 2.2+ zawiera własną wersję Java.
Starsze wersje Javy mogą powodować konflikty. Jeśli odinstalowanie nie jest możliwe, Dashlink Print 2.2+ zawiera własną wersję Javy.
Dostosowania oprogramowania antywirusowego
Wyłącz izolację aplikacji i filtrowanie sieciowe dla Dashlink Print i jego Java Runtime. Dodaj do białej listy niezbędne lokalne porty i katalogi.
Wyłącz izolację aplikacji i filtrowanie sieciowe dla Dashlink Print i jego Java Runtime. Dodaj do białej listy niezbędne lokalne porty i katalogi.
→ https://qz.io/support/Rozwiązywanie problemów: Logi
Aby automatycznie spakować logi i umieścić je na pulpicie: Kliknij prawym przyciskiem myszy ikonę Dashlink Print, wybierz Zaawansowane, a następnie Rozwiązywanie problemów. Kliknij "Zip Logs", aby utworzyć archiwum logów. Te logi są niezbędne dla naszego zespołu wsparcia do diagnozowania problemów.
Ta sekcja obejmuje techniki debugowania, dostęp do logów i konkretne rozwiązania błędów. Zawiera kroki dotyczące obsługi awarii, problemów z uruchamianiem i problemów z listą drukarek.
Dostęp do logów
Użyj zaawansowanych opcji rozwiązywania problemów Dashlink Print, aby spakować logi i umieścić je na pulpicie. Logi są przechowywane w określonych katalogach w systemach Windows, Mac i Linux.
Użyj zaawansowanych opcji rozwiązywania problemów Dashlink Print, aby spakować logi i umieścić je na pulpicie. Logi są przechowywane w określonych katalogach na Windows, Mac i Linux.
→ https://qz.io/wiki/faq#logsLogi konsoli do debugowania
Uruchom Dashlink Print z wiersza poleceń z określonymi ustawieniami pamięci, aby wyświetlić szczegółowe komunikaty debugowania. Dostosuj przydział pamięci w razie potrzeby.
Uruchom Dashlink Print z wiersza poleceń z określonymi ustawieniami pamięci, aby zobaczyć szczegółowe komunikaty debugowania. Dostosuj alokację pamięci w razie potrzeby.
→ https://qz.io/wiki/faq#console-logsRozwiązywanie błędów ścieżki PKIX
Dodaj określone polecenia, aby uzyskać szczegółowe informacje o certyfikacie SSL. Sprawdź, czy nie ma uszkodzonych łańcuchów certyfikatów lub certyfikatów samopodpisanych i zaktualizuj Java w razie potrzeby.
Dodaj określone polecenia, aby uzyskać szczegółowe informacje o certyfikacie SSL. Sprawdź, czy nie ma uszkodzonych łańcuchów certyfikatów lub certyfikatów samopodpisanych i zaktualizuj Javę, jeśli to konieczne.
→ https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdfNapraw problemy z uruchamianiem oprogramowania
Uszkodzona instalacja Java może uniemożliwić uruchomienie oprogramowania. Zainstaluj ponownie Java za pomocą instalatora offline i sprawdź, czy nie ma niestandardowych zmiennych JAVA_HOME.
Uszkodzona instalacja Javy może uniemożliwić uruchomienie oprogramowania. Zainstaluj Javę ponownie, używając instalatora offline, i sprawdź, czy są niestandardowe zmienne JAVA_HOME.
→ https://qz.io/wiki/upgrading-javaRozwiązywanie problemów z listą drukarek
Na Macu zresetuj system drukowania i ponownie dodaj drukarki. W systemie Windows usuń konfliktujące sterowniki drukarek, aby rozwiązać problemy z listą.
Na Macu zresetuj system drukowania i ponownie dodaj drukarki. Na Windows usuń konfliktowe sterowniki drukarek, aby rozwiązać problemy z listą.
→ https://qz.io/wiki/faq#cannot-list-printersDostęp do plików tymczasowych: Jeśli oprogramowanie antywirusowe blokuje dostęp do katalogu tymczasowego, proszę wyłączyć lub
Dostęp do plików tymczasowych: Jeśli oprogramowanie antywirusowe blokuje dostęp do katalogu tymczasowego, proszę wyłączyć lub dodać do białej listy instalator Dashlink Print.
Inne problemy: QZ Industries nie zapewnia wsparcia dla problemów stworzonych przez aplikacje antywirusowe innych firm
Inne problemy: QZ Industries nie zapewnia wsparcia dla problemów stworzonych przez aplikacje antywirusowe innych firm. Wbudowane funkcje (takie jak Windows Defender) są wspierane i mogą być eskalowane do różnych kanałów wsparcia.
Rozwiązywanie problemów: Problemy z drukowaniem RAW
Drukowanie RAW wysyła dane bezpośrednio do drukarki bez przetwarzania. Upewnij się, że drukarka jest skonfigurowana do trybu RAW. Sprawdź, czy w poleceniu drukowania używana jest poprawna nazwa drukarki. Zweryfikuj, czy format danych RAW odpowiada temu, czego oczekuje drukarka (ZPL, EPL, ESC/POS itp.).
Użyj opcji API qz.api.showDebug, aby zarejestrować szczegóły połączenia w konsoli przeglądarki. Jest to przydatne do diagnozowania problemów z łącznością w Dashlink Print 2.0.
Rozwiązywanie problemów: Problemy z drukowaniem HTML
Drukowanie HTML (JavaFX) może powodować niepowodzenia w drukowaniu, jeśli: szerokość strony HTML przekracza szerokość strony drukarki, rozdzielczość drukarki dla druku HTML jest wysoka (np. 600dpi, 1200dpi) — spróbuj wymusić niższe DPI, lub występują problemy z pamięcią, jeśli używasz 32-bitowego JVM. Jeśli JavaFX nie jest dostępne, upewnij się, że zainstalowana jest poprawna wersja Java.
Obejmuje to naprawę błędów takich jak 'Proces zakończony kodem wyjścia 2', awarie połączenia WebSocket oraz problemy z silnikami JavaScript. Upewnij się, że konfiguracja jest prawidłowa i zgodna z wersją Javy.
Rozwiązywanie problemów: Konfiguracja drukarki termicznej/etykietowej
Jeśli Twoja drukarka termiczna lub etykietowa daje niepożądane wyniki, może być niewłaściwie skonfigurowana. Sprawdź ustawienia sterownika drukarki dotyczące rozmiaru papieru, orientacji i jakości druku. Upewnij się, że wymiary etykiety odpowiadają skonfigurowanemu rozmiarowi nośnika. Zweryfikuj, czy drukarka używa poprawnego języka druku (ZPL, EPL). Przetestuj za pomocą prostego polecenia drukowania RAW, aby zlokalizować problem.
Jeśli kroki rozwiązywania problemów nie rozwiążą Twojego problemu, skontaktuj się z pomocą techniczną, podając szczegółowe opisy błędów, informacje o systemie operacyjnym oraz szczegóły dotyczące modelu drukarki.
Ikona Dashlink Print, Zaawansowane, Rozwiązywanie problemów, Zip Logs (Na pulpit)
Ikona Dashlink Print, Zaawansowane, Rozwiązywanie problemów, Zip Logs (Na pulpit)
Wsparcie
Aby uzyskać dodatkowe wsparcie, proszę otworzyć zgłoszenie opisujące swój problem szczegółowo. Dołącz spakowane pliki logów z powyższego kroku rozwiązywania problemów, wersję swojego systemu operacyjnego, wersję przeglądarki oraz model drukarki.