UPS Shipping Dashboard Support

2. Dashlink Print: Bekannte Probleme & Fehlersuche

3 min read

Fehlersuche für Dashlink Print. Behandelt häufige Druckfehler, Browserprobleme, QZ Tray-Probleme und deren Lösungen.

Schritt-für-Schritt-Anleitung

Leitfaden zu Dashlink Print-Problemen & Lösungen

Dieser Artikel bietet einen umfassenden Leitfaden zu bekannten Problemen und Fehlersuchschritten für Dashlink Print-Nutzer. Er ist für Nutzer gedacht, die Probleme mit der Installation, dem Betrieb oder Softwarekonflikten haben.

Voraussetzungen

Bevor Sie Dashlink Print installieren, müssen Sie sicherstellen, dass alle vorherigen Versionen von QZ Tray deinstalliert sind. Jeder Client muss QZ Tray zuerst manuell deinstallieren, da die beiden Anwendungen nicht gleichzeitig existieren sollten, da sie um dieselbe Portnummer konkurrieren. Für Windows kann die Deinstallation über die Systemsteuerung/Systemeinstellungen durchgeführt werden. Für Mac kann die App in den Papierkorb gezogen werden, oder erfahrene Nutzer möchten möglicherweise das Deinstallationsskript ausführen. Für Linux wird das Deinstallationsskript benötigt.

2.1

For Windows, the uninstall can be performed through the Control Panel/System Preferences.

2.2

For Mac, the app can be dragged to the recycling bin, or advanced users may wish to run the uninstal

For Mac, the app can be dragged to the recycling bin, or advanced users may wish to run the uninstall script.

2.3

For Linux, the uninstall script is needed.

Bekannte Probleme: Konfliktierende Anwendungen

Das gleichzeitige Vorhandensein von zwei Versionen von Dashlink Print und/oder QZ Tray kann zu Konflikten führen. Stellen Sie sicher, dass nur eine Version installiert ist. Antivirensoftware kann die Kommunikation von Dashlink Print blockieren. Fügen Sie in Ihren Antivireneinstellungen eine Ausnahme für die Dashlink Print-Anwendung hinzu. Die Firewall-Einstellungen können WebSocket-Verbindungen blockieren. Stellen Sie sicher, dass Port 8181 (oder der konfigurierte Port) durch Ihre Firewall erlaubt ist.

3.1

Resolve Java Conflicts

Older Java versions can cause conflicts. If uninstalling is not possible, Dashlink Print 2.2+ includes its own Java version.

3.2

Antivirus Software Adjustments

Disable application containment and web filtering for Dashlink Print and its Java Runtime. Whitelist necessary local ports and directories.

→ https://qz.io/support/

Fehlersuche: Protokollierung

Um Protokolle automatisch zu zippen und auf Ihrem Desktop abzulegen: Klicken Sie mit der rechten Maustaste auf das Dashlink Print-Symbol, wählen Sie Erweitert und dann Fehlersuche. Klicken Sie auf "Protokolle zippen", um ein Protokollarchiv zu erstellen. Diese Protokolle sind für unser Support-Team entscheidend, um Probleme zu diagnostizieren.

4.1

Access Logs

Use Dashlink Print's advanced troubleshooting options to zip logs and place them on your desktop. Logs are stored in specific directories on Windows, Mac, and Linux.

→ https://qz.io/wiki/faq#logs

4.2

Console Logs for Debugging

Launch Dashlink Print from the command line with specific memory settings to view detailed debug messages. Adjust memory allocation as needed.

→ https://qz.io/wiki/faq#console-logs

4.3

Resolve PKIX Path Errors

Append specific commands to fetch detailed SSL certificate information. Check for broken certificate chains or self-signed certificates and update Java if necessary.

→ https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf

4.4

Fix Software Launch Issues

A corrupt Java installation can prevent software from launching. Reinstall Java using the offline installer and check for custom JAVA_HOME variables.

→ https://qz.io/wiki/upgrading-java

4.5

Troubleshoot Printer Listing

On Mac, reset the printing system and re-add printers. On Windows, remove conflicting printer drivers to resolve listing issues.

→ https://qz.io/wiki/faq#cannot-list-printers

4.6

Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or

Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or whitelist the Dashlink Print installer.

4.7

Other issues: QZ Industries does not provide support for issues created by third party antivirus app

Other issues: QZ Industries does not provide support for issues created by third party antivirus applications. Built-in features (such as Windows Defender) are supported and may be escalated to the various support channels.

Fehlersuche: Rohdruckprobleme

Rohdruck sendet Daten direkt an den Drucker, ohne sie zu verarbeiten. Stellen Sie sicher, dass der Drucker für den Rohmodus konfiguriert ist. Überprüfen Sie, ob der richtige Druckername im Druckbefehl verwendet wird. Stellen Sie sicher, dass das Rohdatenformat dem entspricht, was der Drucker erwartet (ZPL, EPL, ESC/POS usw.).

Fehlersuche: HTML-Druckprobleme

HTML-Druck (JavaFX) kann zu Druckfehlern führen, wenn: die Breite der HTML-Seite die Breite der Druckerseite überschreitet, die Druckauflösung für den HTML-Druck hoch ist (z. B. 600dpi, 1200dpi) – versuchen Sie, eine niedrigere DPI hart zu codieren, oder es treten Speicherprobleme auf, wenn die 32-Bit-JVM verwendet wird. Wenn JavaFX nicht verfügbar ist, stellen Sie sicher, dass die richtige Java-Version installiert ist.

Fehlersuche: Konfiguration von Thermodruckern/Etikettendruckern

Wenn Ihr Thermo- oder Etikettendrucker unerwünschte Ergebnisse liefert, könnte er falsch konfiguriert sein. Überprüfen Sie die Druckertreibereinstellungen für Papiergröße, Ausrichtung und Druckqualität. Stellen Sie sicher, dass die Etikettendimensionen der konfigurierten Mediengröße entsprechen. Überprüfen Sie, ob der Drucker die richtige Drucksprache verwendet (ZPL, EPL). Testen Sie mit einem einfachen Rohdruckbefehl, um das Problem zu isolieren.

7.1

Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)

Support

Für zusätzliche Unterstützung öffnen Sie bitte ein Ticket, in dem Sie Ihr Problem detailliert beschreiben. Fügen Sie die gezippten Protokolldateien aus dem obigen Fehlersuchschritt, Ihre Betriebssystemversion, Browserversion und Druckermodell hinzu.