2. Dashlink Print : Problèmes connus et dépannage
Guide de dépannage pour Dashlink Print. Couvre les erreurs d'impression courantes, les problèmes de navigateur, les problèmes de QZ Tray et leurs solutions.
Guide étape par étape
Guide des problèmes et solutions de Dashlink Print
Cet article fournit un guide complet sur les problèmes connus et les étapes de dépannage pour les utilisateurs de Dashlink Print. Il est conçu pour les utilisateurs rencontrant des problèmes d'installation, de fonctionnement ou de conflits logiciels.
Prérequis
Avant d'installer Dashlink Print, vous devez vous assurer que toutes les versions précédentes de QZ Tray sont désinstallées. Chaque client devra désinstaller manuellement QZ Tray en premier, les deux applications ne doivent pas coexister car elles se disputent le même numéro de port. Pour Windows, la désinstallation peut être effectuée via le Panneau de configuration / Préférences système. Pour Mac, l'application peut être glissée dans la corbeille, ou les utilisateurs avancés peuvent souhaiter exécuter le script de désinstallation. Pour Linux, le script de désinstallation est nécessaire.
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.
Problèmes connus : Applications conflictuelles
Avoir deux versions de Dashlink Print et/ou QZ Tray installées simultanément peut causer des conflits. Assurez-vous qu'une seule version est installée. Les logiciels antivirus peuvent bloquer la communication de Dashlink Print. Ajoutez une exception pour l'application Dashlink Print dans vos paramètres antivirus. Les paramètres de pare-feu peuvent bloquer les connexions WebSocket. Assurez-vous que le port 8181 (ou le port configuré) est autorisé à travers votre pare-feu.
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/Dépannage : Journalisation
Pour compresser automatiquement les journaux et les placer sur votre bureau : Cliquez avec le bouton droit sur l'icône Dashlink Print, sélectionnez Avancé, puis Dépannage. Cliquez sur "Compresser les journaux" pour créer une archive de journaux. Ces journaux sont essentiels pour notre équipe de support afin de diagnostiquer les problèmes.
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.
Dépannage : Problèmes d'impression brute
L'impression brute envoie des données directement à l'imprimante sans traitement. Assurez-vous que l'imprimante est configurée en mode brut. Vérifiez que le nom de l'imprimante utilisé dans la commande d'impression est correct. Vérifiez que le format de données brutes correspond à ce que l'imprimante attend (ZPL, EPL, ESC/POS, etc.).
Dépannage : Problèmes d'impression HTML
L'impression HTML (JavaFX) peut entraîner un échec de l'impression si : la largeur de la page HTML dépasse la largeur de la page de l'imprimante, la résolution de l'imprimante pour l'impression HTML est élevée (par exemple, 600dpi, 1200dpi) — essayez de coder en dur une DPI inférieure, ou des problèmes de mémoire surviennent si vous exécutez la JVM 32 bits. Si JavaFX n'est pas disponible, assurez-vous que la bonne version de Java est installée.
Dépannage : Configuration de l'imprimante thermique/étiquette
Si votre imprimante thermique ou d'étiquettes donne des résultats indésirables, elle peut être mal configurée. Vérifiez les paramètres du pilote d'imprimante pour la taille du papier, l'orientation et la qualité d'impression. Assurez-vous que les dimensions de l'étiquette correspondent à la taille de média configurée. Vérifiez que l'imprimante utilise le bon langage d'impression (ZPL, EPL). Testez avec une simple commande d'impression brute pour isoler le problème.
Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)
Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)
Support
Pour un support supplémentaire, veuillez ouvrir un ticket décrivant votre problème en détail. Incluez les fichiers journaux compressés de l'étape de dépannage ci-dessus, votre version du système d'exploitation, votre version de navigateur et le modèle de votre imprimante.