2. Dashlink Print: Bekende Problemen & Probleemoplossing
Probleemoplossingsgids voor Dashlink Print. Behandelt veelvoorkomende afdrukfouten, browserproblemen, QZ Tray-problemen en hun oplossingen.
Stapsgewijze handleiding
Gids voor Dashlink Print Problemen & Oplossingen
Dit artikel biedt een uitgebreide gids voor bekende problemen en probleemoplossingsstappen voor Dashlink Print-gebruikers. Het is ontworpen voor gebruikers die problemen ondervinden met installatie, werking of softwareconflicten.
Vereisten
Voordat u Dashlink Print installeert, moet u ervoor zorgen dat alle eerdere versies van QZ Tray zijn verwijderd. Elke client moet QZ Tray handmatig verwijderen, de twee applicaties mogen niet naast elkaar bestaan omdat ze om hetzelfde poortnummer strijden. Voor Windows kan de verwijdering worden uitgevoerd via het Configuratiescherm/Systeemvoorkeuren. Voor Mac kan de app naar de prullenbak worden gesleept, of gevorderde gebruikers kunnen de verwijderingsscript uitvoeren. Voor Linux is het verwijderingsscript nodig.
For Windows, the uninstall can be performed through the Control Panel/System Preferences.
For Windows, the uninstall can be performed through the Control Panel/System Preferences.
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.
For Linux, the uninstall script is needed.
For Linux, the uninstall script is needed.
Bekende Problemen: Conflicterende Applicaties
Het gelijktijdig hebben van twee versies van Dashlink Print en/of QZ Tray kan conflicten veroorzaken. Zorg ervoor dat er slechts één versie is geïnstalleerd. Antivirussoftware kan de communicatie van Dashlink Print blokkeren. Voeg een uitzondering toe voor de Dashlink Print-applicatie in uw antivirusinstellingen. Firewallinstellingen kunnen WebSocket-verbindingen blokkeren. Zorg ervoor dat poort 8181 (of geconfigureerde poort) is toegestaan via uw firewall.
Resolve Java Conflicts
Older Java versions can cause conflicts. If uninstalling is not possible, Dashlink Print 2.2+ includes its own Java version.
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/Probleemoplossing: Logboeken
Om logboeken automatisch te zippen en op uw bureaublad te plaatsen: Klik met de rechtermuisknop op het Dashlink Print-pictogram, selecteer Geavanceerd en vervolgens Probleemoplossing. Klik op "Zip Logboeken" om een logarchief te maken. Deze logboeken zijn essentieel voor ons ondersteuningsteam om problemen te diagnosticeren.
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#logsConsole 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-logsResolve 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.pdfFix 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-javaTroubleshoot 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-printersTemporary 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.
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.
Probleemoplossing: Raw Printing Problemen
Raw printing verzendt gegevens rechtstreeks naar de printer zonder verwerking. Zorg ervoor dat de printer is geconfigureerd voor raw-modus. Controleer of de juiste printernaam wordt gebruikt in de afdrukopdracht. Controleer of het raw gegevenstype overeenkomt met wat de printer verwacht (ZPL, EPL, ESC/POS, enz.).
Probleemoplossing: HTML Printing Problemen
HTML-printen (JavaFX) kan leiden tot mislukte afdrukken als: de breedte van de HTML-pagina de breedte van de printerpagina overschrijdt, de printerresolutie voor HTML-afdruk hoog is (bijv. 600dpi, 1200dpi) — probeer een lagere DPI hard-coded in te stellen, of er geheugenproblemen optreden als de 32-bits JVM wordt uitgevoerd. Als JavaFX niet beschikbaar is, zorg er dan voor dat de juiste Java-versie is geïnstalleerd.
Probleemoplossing: Thermische/Label Printer Configuratie
Als uw thermische of labelprinter ongewenste resultaten oplevert, kan deze onjuist zijn geconfigureerd. Controleer de printerdriverinstellingen voor papierformaat, oriëntatie en afdrukkwaliteit. Zorg ervoor dat de labelafmetingen overeenkomen met de geconfigureerde media-afmetingen. Controleer of de printer de juiste afdruktaal gebruikt (ZPL, EPL). Test met een eenvoudige raw afdrukopdracht om het probleem te isoleren.
Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)
Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)
Ondersteuning
Voor aanvullende ondersteuning, opent u een ticket waarin u uw probleem in detail beschrijft. Voeg de gecomprimeerde logbestanden van de probleemoplossingsstap hierboven toe, evenals uw besturingssysteemversie, browserversie en printermodel.