Voraussetzungen

Bevor Sie Dashlink Print installieren, müssen Sie sicherstellen, dass alle früheren Versionen von QZ Tray deinstalliert sind.

Jeder Client muss QZ Tray zuerst manuell deinstallieren. Die beiden Anwendungen sollten nicht nebeneinander existieren, da sie um die gleiche Portnummer kämpfen.

• Unter Windows kann die Deinstallation über die Systemsteuerung/Systemeinstellungen durchgeführt werden.
• Für Mac kann die App in den Papierkorb gezogen werden, oder fortgeschrittene Benutzer möchten sie möglicherweise ausführen Deinstallationsskript.
• Für Linux ist die Deinstallationsskript wird gebraucht.

1. Bekannte Probleme

Widersprüchliche Anwendungen

Die folgenden Anwendungen können Probleme bei der Installation von Dashlink Print verursachen.

• Ältere Java-Versionen: Dashlink Print funktioniert am besten mit Java 11 oder höher. Ältere Versionen von Dashlink Print können zu Konflikten mit Dashlink Print führen und dazu führen, dass der Start fehlschlägt.
  • Deinstallieren Sie nach Möglichkeit alle Versionen von Java, JRE, JDK oder OpenJDK vom System.
  • Wenn die Deinstallation alter Java-Versionen nicht möglich ist, installieren Sie Dashlink Print 2.2 oder höher, das mit einer eigenen Java-Version geliefert wird.
• Antiviren Software: Einige Antivirenanwendungen verhindern möglicherweise die Installation oder Ausführung von Dashlink Print.
  • Comodo Antivirus erzwingt die Anwendungseindämmung des Dashlink Print-Installationsprogramms und verhindert, dass es installiert, deinstalliert und ausgeführt wird. Darüber hinaus wird die Deaktivierung von Comodo nur sehr geringe Auswirkungen haben, da es sich ohne Vorwarnung selbst wieder aktiviert. Dashlink Print wird von Comodo Antivirus nicht unterstützt.
• Andere Antivirenprogramme:
  • Anwendungsbeschränkung: Wenn das Antivirenprogramm die Anwendungseindämmung erzwingt, deaktivieren Sie bitte diese Anwendungseindämmung für Dashlink Print und die von ihm verwendete Java Runtime.
  • Webfilterung: Wenn das Antivirenprogramm den Zugriff auf lokale Ports oder Localhost-Zertifikate blockiert, deaktivieren Sie es bitte oder setzen Sie es auf die Whitelist https://localhost:8181, http://localhost:8182.
  • Temporärer Dateizugriff: Wenn das Antivirenprogramm den Zugriff auf das temporäre Verzeichnis blockiert, deaktivieren Sie bitte das Dashlink Print-Installationsprogramm oder setzen Sie es auf die Whitelist.
  • Andere Probleme: QZ Industries bietet keinen Support für Probleme, die durch Antivirenanwendungen von Drittanbietern verursacht werden. Integrierte Funktionen (z. B. Windows Defender) werden unterstützt und können auf die verschiedenen erweitert werden Unterstützung Kanäle.

2. Fehlerbehebung

Debuggen von Dashlink Print

Protokolle

• So komprimieren Sie Protokolle automatisch und platzieren sie auf Ihrem Desktop:
  • Dashlink-Drucksymbol, Erweitert, Fehlerbehebung, Zip-Protokolle (auf den Desktop)
• Dashlink Print platziert Protokolldateien an den folgenden Orten:
  • Windows: %APPDATA%\qz
  • Mac: ~/Library/Application Support/qz
  • Linux: ~/.qz

Konsolenprotokolle

• Der empfohlene Ansatz für eine ausführliche Ausgabe von Dashlink Print besteht darin, die Software über die Befehlszeile zu starten. Dadurch werden der Java-Konsole detaillierte Informationen zu Debug-Meldungen und Ausnahmen angezeigt, einschließlich einer vollständigen Rückverfolgung, wo eine bestimmte Ausnahme aufgetreten ist.
• Dashlink Print startet mit 512 MB der Erinnerung. Wir müssen spezifizieren -Xms512M im Befehl, um unerwartetes Verhalten und Abstürze zu verhindern. Dies ist für Mac nicht erforderlich, es sei denn, Sie befolgen die grundlegende Syntax (java -jar qz-tray.jar). Mehr Speicher kann zugewiesen werden, sollte aber nicht notwendig sein.Grundlegende Syntax (nach dem Schließen aller Instanzen von Dashlink Print)java -Xms512M -jar qz-tray.jarWindows (nach dem Schließen aller Instanzen von Dashlink Print)java -Xms512M –add-exports java.desktop/sun.swing=ALL-UNNAMED -jar „%PROGRAMFILES%\Dashlink Print\qz-tray.jar“Mac OS X (nachdem alle Instanzen von Dashlink Print geschlossen wurden)/Applications/QZ\Tray.app/Contents/MacOS/QZ\TrayLinux/Andere (nachdem alle Instanzen von Dashlink Print geschlossen wurden)/opt/qz-tray/qz-tray

PKIX-Erstellungspfad fehlgeschlagen

Manchmal eine Nachricht java.lang.UnsupportedOperationException: Kann nicht analysiert werden (DATEI) wird auftauchen. Hierbei handelt es sich häufig um einen Fehler von Java beim Herunterladen der spezifischen Ressource, und es kommt zu einem Fehler Verursacht durch: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX-Pfaderstellung fehlgeschlagen

• Um detaillierte Informationen zum HTTPS/SSL-Zertifikat abzurufen, hängen Sie an -verbose -Djava.security.debug=certpath Vor dem -Xms512 Befehl. Die Ausgabe wird sehr groß sein, Sie können sie mit in eine Datei umleiten > file.log 2>&1 Am Ende.
• Siehe auch https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf
• Häufige Ursachen
  • Defekte Zertifikatskette Abhilfe: Gültigkeit von sslshopper.com prüfen, Kette gemäß CA-Anweisungen reparieren.
  • Selbstsigniertes Zertifikat Abhilfe: Fügen Sie für diese Adresse eine Ausnahme zum Proxy oder zur Firewall hinzu – ODER – Installieren Sie das Zertifikat in Java.
  • Neu vertrauenswürdige Zertifizierungsstelle Abhilfe: Java aktualisieren. Dies ist bei LetsEncrypt-Zertifikaten ziemlich häufig der Fall.

Absturz beim Drucken

Die Software kann nicht gestartet werden

1. Eine beschädigte Java-Installation kann die Installation oder das Laden der Software verhindern. Eine beschädigte Java-Installation kommt unter Windows recht häufig vor und kann durch eine Neuinstallation von Java mithilfe von Java behoben werden Offline-Installationsprogramm. Es wurde berichtet, dass das Offline-Installationsprogramm viele Probleme mit beschädigten Java-Installationen behebt. Schauen Sie mal rein diesen Leitfaden für unsere empfohlenen Schritte zur Neuinstallation von Java auf allen Plattformen.
   
   Anzeichen einer beschädigten Java-Installation:Keystore für ws://localhost erstellen...
- [fehlgeschlagen] Erstellen eines CA-Schlüsselpaars ...
   
   … oder …
   
   Java-Version
„Beim Verarbeiten der freigegebenen Archivdatei ist ein Fehler aufgetreten. Die Zuordnung des freigegebenen Speicherplatzes konnte nicht aufgehoben werden. Bei der Initialisierung der VM ist ein Fehler aufgetreten. Das freigegebene Archiv kann nicht verwendet werden.“
2. Manchmal individuell JAVA_HOME Umgebungsvariablen verhindern, dass Dashlink Print geladen wird. Wenn die Software gestartet werden kann über die Kommandozeile das ist wahrscheinlich der Fall. In Windows kann dies überprüft werden, indem Sie auf gehen System > Erweiterte Systemeinstellungen > Umgebungsvariablen
3. HTML-Druck (JavaFX) kann dazu führen, dass der Druck fehlschlägt, wenn Folgendes zutrifft:
   • Ausgabe: Die HTML-Seitenbreite ist auf 100% eingestellt.
     Abhilfe: Codieren Sie eine akzeptable Seite mithilfe von CSS fest, z. B 800px
   • Ausgabe: Die Druckerauflösung für den HTML-Druck ist hoch (z. B. 600 dpi, 1200 dpi).
     Abhilfe: Codieren Sie einen niedrigeren DPI-Wert (z. B. 300 dpi) fest mit { Einheiten: 'in', Dichte: 300 }. Wir empfehlen außerdem, eine vernünftige Einstellung vorzunehmen FallbackDensity Falls 300 dpi von bestimmter Hardware nicht unterstützt wird.
   • Ausgabe: Beim Ausführen der 32-Bit-JVM kann es zu Problemen mit nicht genügend Arbeitsspeicher kommen.
     Abhilfe: Sehen 32-Bit vs. 64-Bit: Abschnitt unten.
   • Ausgabe: java.lang.NoClassDefFoundError: javafx/print/PrintColor bei qz.printer.PrintOptions$ColorType
     Abhilfe: JavaFX wird nicht mit allen Java-Versionen verteilt. Bitte installieren Sie JavaFX für Ihre Plattform (z. B openjfx, usw).
4. Bilder/PDFs führen dazu, dass die Software nicht mehr funktioniert: Häufiger Die Methode public void qz.ws.PrintSocketClient#onMessage kann nicht aufgerufen werdenDies ist im Allgemeinen ein Zeichen dafür, dass in der JVM ein nicht behebbarer Fehler aufgetreten ist. Die häufigste Ursache sind große Druckvorgänge auf einer 32-Bit-JVM. Eine vorübergehende Problemumgehung ist anzugeben { rastern: false } in der Konfiguration, aber dadurch werden nur PDFs repariert. Eine dauerhafte Lösung besteht darin, auf eine 64-Bit-JVM umzusteigen, die einen größeren Heap-Speicherplatz zuweist. Wenn 32-Bit erforderlich ist, kann zusätzlicher Heap-Speicherplatz über zugewiesen werden Befehlszeile.
5. 32-Bit vs. 64-Bit: Auf einigen 64-Bit-Workstations sind sowohl 32-Bit- als auch 64-Bit-Java-Versionen installiert. Wenn beide benötigt werden, stellen Sie sicher, dass beide aktualisiert sind. Andernfalls wird empfohlen, die 32-Bit-Version zu entfernen, um die Fehlerbehebung zu erleichtern.
6. Unzureichende Java-Version „Eine Java-Ausnahme ist aufgetreten“ kann erscheinen, wenn Sie versuchen, mit einer veralteten Java-Version zu starten. Eine Liste der Mindestanforderungen für Java finden Sie unter Java-Versionen. Kann auch als gemeldet werden Die Hauptklasse qz.ws.PrintSocketServer konnte nicht gefunden werden. Anwendung wird beendet.
7. Festplatte beschädigt: Immer versuchen fsck (Linux), Festplattendienstprogramm (MacOS) bzw chkdsk (Windows). Physische Laufwerke können seltsame Symptome zeigen, wenn sie anfangen auszufallen. SSD-Festplatten sind jedoch anfällig für einen Zustand, der „abgenutzte Bits“ oder besser gesagt „SSD-Ausdauer“ genannt wird und für die Wiederverwendung von NAND-Flash-Speicher verantwortlich ist. Dieser Prozess sollte selbstheilend sein, kann jedoch gelegentlich Probleme mit bestimmten Laufwerks-Firmwares verursachen. Stellen Sie sicher, dass Sie Ihre Festplatte auf ihren Zustand überprüfen, wenn Startprobleme auftreten.

Drucker können nicht aufgelistet werden

1. Mac
   • Aufgrund eines Upstream-Fehlers mit Java können Druckerlisten auf dem Mac fehlschlagen. Die aktuelle Problemumgehung besteht darin:
     • Öffnen Sie die Systemeinstellungen „Drucker und Scanner“. Rechtsklick > „Drucksystem zurücksetzen“ – fügen Sie alle Drucker erneut hinzu
     Wir sind uns bewusst, dass dies nicht ideal ist, haben aber keine andere Lösung auf dem Mac gefunden.
2. Windows
   • Obwohl selten, kommt es vor, dass keine Drucker aufgelistet werden können, nur ein Drucker aufgelistet werden kann oder die Auflistung von Druckern mehrere Minuten in Anspruch nimmt. Dies wird wahrscheinlich durch einen Treiberkonflikt zwischen dem fehlerhaften Druckertreiber und dem Druckspooler verursacht, was dazu führt, dass das gesamte Drucksubsystem hängen bleibt. Die Problemumgehung besteht darin, den fehlerhaften Drucker oder Druckertreiber zu entfernen.

Rohdruckerwarteschlangen

Wenn Ihr Thermo- oder Etikettendrucker unerwünschte Ergebnisse liefert, ist er möglicherweise falsch konfiguriert. Hier sind unsere Tutorials zum Einrichten eines Druckers für den Empfang von Rohsprachen auf jeder Plattform:

• Windows
• OS X
• Linux

Notiz: Einige Windows-Treiber, wie z. B. der ZDesigner-Treiber von Zebra für Microsoft Windows, unterstützen neben dem pixelbasierten/PostScript-Druck auch Raw-Druck. Sie können diese Treiber oder einen generischen Roh-/Nur-Text-Treiber verwenden, um Rohbefehle zu senden, aber der generische Treiber ist nicht in der Lage, Bilder/PDF/HTML zu drucken.

Debuggen von WebSockets

Standardmäßig unterdrückt Dashlink Print ausführliche Websocket-Informationen aus der Konsole. Gelegentlich können diese Informationen jedoch zum Debuggen/Beheben von Verbindungsproblemen nützlich sein.

Debuggen von WebSockets in 2.0

• Nur 2.0 - Verwendung der qz.api.showDebug(...) API-Option, ausführliche Verbindungsdetails werden in der Konsole des Browsers protokolliert.qz.api.showDebug(true); // muss vor dem Aufruf von qz.websocket.connect() aufgerufen werden

Steckdose nicht angeschlossen

• Dies ist oft ein Zeichen für eine inkompatible Version. Bitte stellen Sie sicher, dass Sie einen für Ihr System korrekten Build verwenden (z. B. 1.9, 2.0).

Andere Fehler

• Konsolenprotokolle sagen Der Vorgang wurde mit Exit-Code 2 abgeschlossen
  • Ursache: Dies weist darauf hin, dass bereits eine andere Instanz von Dashlink Print auf den angegebenen Ports auf diesem Computer ausgeführt wird. Wenn es nicht mehr reagiert, versuchen Sie, die Dashlink-Drucke zu deaktivieren Java Führen Sie den Vorgang aus und versuchen Sie erneut, ihn zu starten.
• Fehler: Typfehler: _qz.tools.hash ist keine Funktion
  • Ursache: Stellen Sie sicher, dass die Seite mit UTF-8 gerendert wird <meta charset='utf-8'>.
• Fehler: WebSocket-Verbindung zu „wss://localhost:8181/“ fehlgeschlagen: Fehler beim Verbindungsaufbau: net::ERR_CONNECTION_CLOSED
  • Ursache: Es ist bekannt, dass Java 9 (Beta) diesen Fehler verursacht. Bitte auf eine unterstützte Version herunterstufen Java-Version.
• Fehler: SCRIPT1010: Erwarteter Bezeichner qz-tray.js
  • Ursache: IE11 emuliert möglicherweise einen älteren Browser. Bitte verwenden Sie die Browseremulation IE10, IE11 oder Edge. Beleidigender Code könnte so aussehen <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
• Fehler: Der Server hat den HTTP-Antwortcode 403 für die URL zurückgegeben
  • Ursache: Vorausgesetzt, dass Berechtigungsprobleme ausgeschlossen wurden, erfordern einige Server eine Benutzer-Agent-Zeichenfolge an den Web-Controller übergeben werden. Dashlink Print 2.0 sendet ein Leerzeichen Benutzer-Agent-Zeichenfolge. Dashlink Print 2.1+ bietet eine ordnungsgemäße Funktion Benutzer-Agent-Zeichenfolge. Alternativ können Sie die deaktivieren Filterung von Benutzeragenten auf dem Webcontroller. Cloudfare nennt dies beispielsweise Browser-Integritätsprüfung und kann deaktiviert werden.

Ungültiger JSON

• Wenn die Browserkonsole sagt Ungültiger JSONVersuchen Sie, Ihre HTTP-Header im zu verwendenden Sign-Message-Beispiel zu ändern Text/einfach anstatt application/json. In PHP geschieht dies über:- header('Content-Type: application/json'); + header('Content-Type: text/plain');Notiz: Diese Technik variiert je nach verwendeter serverseitiger Sprache.

---

JScript

• Fehler: Für diese Plattform ist keine automatische Zertifikatinstallation verfügbar
  • Ursache: Mehrere.
    • Notiz: Dashlink Print 2.1 verwendet Java für die Zertifikatsinstallation und kann dieses Problem möglicherweise beheben.
    • Wenn Sie Comodo Antivirus verwenden, verwenden Sie vor der Installation die Option „Erweiterte Ansicht“, „Automatische Eindämmung“ und „Deaktiviert“.
    • Wenn Sie Windows XP verwenden, befolgen Sie die Anweisungen auf dem Bildschirm.
    • Dieses Problem kann durch fehlerhafte Daten verursacht werden, die von zurückgegeben werden certutil Befehl. Kontakt support@qz.io zur Hilfe.
• Fehler: Die Skript-Engine „VBScript“ für das Skript kann nicht gefunden werden.
  • Notiz: Dashlink Print hat das entfernt VBScript/JScript Abhängigkeit und kann dieses Problem beheben.
  • Ursache: Die Windows-Desktop-Installationsprogramme werden von Windows verwendet JScript Motor für bestimmte Aufgaben. Gelegentlich versuchen Antiviren-Engines möglicherweise, diese Engine zu ersetzen. Um festzustellen, ob dies die Ursache ist, führen Sie die folgenden Befehle über die Eingabeaufforderung aus: reg query HKCR\CLSID\{cc5bbec3-db4a-4bed-828d-08d78ee3e1ed}\InprocServer32 /ve reg query HKCR\CLSID\{f414c260-6ac0-11cf-b6d1 -00aa00bbbb58}\InprocServer32 /ve reg query HKCR\CLSID\{f414c261-6ac0-11cf-b6d1-00aa00bbbb58}\InprocServer32 /ve reg query HKCR\CLSID\{f414c262-6ac0-11cf-b6d1-00aa00bbbb58}\Inproc Server32 /ve
  • Wenn das System richtig konfiguriert ist, gibt jeder Befehl den folgenden Wert zurück:(Standard) REG_SZ C:\Windows\System32\jscript.dll
  • Wenn das System falsch konfiguriert ist, wird ein anderer Wert zurückgegeben. Dieser Wert kann manuell mit dem Windows-Registrierungseditor repariert werden.

---

3. Unterstützung

Wenn Sie Fragen oder Probleme bei der Verwendung des Dashboards haben, eröffnen Sie bitte einen Support-Fall, indem Sie uns schreiben an: upsplugins@ecommerce.help und geben Sie die folgenden Informationen an

1. Fehlerbeschreibung (idealerweise mit Video/Screenshots)
2. Computer-Betriebssystem
3. Druckermodell