Conditions préalables

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'abord désinstaller manuellement QZ Tray, les deux applications ne doivent pas coexister car elles se battront pour 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 vers la corbeille de recyclage, ou les utilisateurs avancés peuvent souhaiter exécuter le script de désinstallation.
• Pour Linux, le script de désinstallation est nécessaire.

1. Problèmes connus

Applications conflictuelles

Les applications suivantes peuvent entraîner des problèmes lors de l'installation de Dashlink Print.

• Anciennes versions de Java : Dashlink Print fonctionne mieux avec Java 11 ou version ultérieure. Les anciennes versions de Dashlink Print peuvent entrer en conflit avec Dashlink Print et empêcher son démarrage.
  • Si possible, désinstallez toutes les versions de Java, JRE, JDK ou OpenJDK du système.
  • S'il n'est pas possible de désinstaller les anciennes versions de Java, installez Dashlink Print 2.2 ou supérieur, qui sera fourni avec sa propre version Java.
• Logiciel antivirus: Certaines applications antivirus peuvent empêcher l'installation ou l'exécution de Dashlink Print.
  • Comodo Antivirus forcera le confinement de l'application du programme d'installation de Dashlink Print et empêchera son installation, sa désinstallation et son exécution. De plus, désactiver Comodo aura très peu d’effet car il se réactivera sans avertissement. Dashlink Print n'est pas pris en charge avec Comodo Antivirus.
• Autre antivirus :
  • Confinement des applications : Si l'antivirus force le confinement des applications, veuillez désactiver ce confinement d'application pour Dashlink Print et le Java Runtime qu'il utilise.
  • Filtrage Web : Si l'antivirus bloque l'accès aux ports locaux ou aux certificats localhost, veuillez le désactiver ou le mettre sur liste blanche https://localhost:8181, http://localhost:8182.
  • Accès aux fichiers temporaires : Si l'antivirus bloque l'accès au répertoire temporaire, veuillez désactiver ou mettre sur liste blanche le programme d'installation de Dashlink Print.
  • Autres issues: QZ Industries ne fournit pas de support pour les problèmes créés par des applications antivirus tierces. Les fonctionnalités intégrées (telles que Windows Defender) sont prises en charge et peuvent être transmises aux différents soutien chaînes.

2. Dépannage

Débogage de l'impression Dashlink

Journaux

• Pour compresser automatiquement les journaux et les placer sur votre bureau :
  • Icône d'impression Dashlink, Avancé, Dépannage, Journaux Zip (vers le bureau)
• Dashlink Print place les fichiers journaux aux emplacements suivants :
  • Les fenêtres: %APPDATA%\qz
  • Mac: ~/Bibliothèque/Application Support/qz
  • Linux : ~/.qz

Journaux de la console

• L'approche recommandée pour obtenir une sortie détaillée de Dashlink Print consiste à lancer le logiciel à partir de la ligne de commande. Cela exposera la console Java avec des informations détaillées sur les messages de débogage et les exceptions, y compris une trace complète de l'endroit où une exception particulière s'est produite.
• Dashlink Print est lancé avec 512 Mo de mémoire. Il faut préciser -Xms512M dans la commande afin d'éviter tout comportement inattendu et tout plantage. Ceci n'est pas nécessaire pour Mac à moins de suivre la syntaxe de base (java -jar qz-tray.jar) . Plus de mémoire peut être allouée mais ne devrait pas être nécessaire.Syntaxe de base (après avoir fermé toutes les instances de Dashlink Print)java -Xms512M -jar qz-tray.jarles fenêtres (après avoir fermé toutes les instances de Dashlink Print) java -Xms512M –add-exports java.desktop/sun.swing=ALL-UNNAMED -jar « %PROGRAMFILES%\Dashlink Print\qz-tray.jar »Mac OS X (après avoir fermé toutes les instances de Dashlink Print)/Applications/QZ\ Tray.app/Contents/MacOS/QZ\ TrayLinux/Autre (après avoir fermé toutes les instances de Dashlink Print)/opt/qz-tray/qz-tray

Échec du chemin de construction PKIX

Parfois un message java.lang.UnsupportedOperationException : impossible d'analyser (FILE) apparaîtra. Il s'agit souvent d'un échec de Java dans le téléchargement de la ressource spécifique, suivi d'un Causé par : javax.net.ssl.SSLHandshakeException : sun.security.validator.ValidatorException : échec de la création du chemin PKIX

• Pour récupérer des informations détaillées sur le certificat HTTPS/SSL, ajoutez -verbose -Djava.security.debug=certpath avant le -Xms512 commande. La sortie sera très volumineuse, vous pouvez la rediriger vers un fichier en utilisant > fichier.log 2>&1 à la fin.
• Voir également https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf
• Causes courantes
  • Chaîne de certificat brisée Remède : Vérifiez la validité de sslshopper.com, corrigez la chaîne selon les instructions de l'autorité de certification.
  • Certificat auto-signé Remède : Ajoutez une exception au proxy ou au pare-feu pour cette adresse — OU — Installez le certificat dans Java.
  • Autorité de certification nouvellement approuvée Remède : Mettre à jour Java. Ceci est assez courant pour les certificats LetsEncrypt.

Crash pendant l'impression

Impossible de lancer le logiciel

1. Une installation Java corrompue peut empêcher l'installation ou le chargement du logiciel. Une installation Java corrompue est assez courante sous Windows et peut être résolue en réinstallant Java à l'aide de Java programme d'installation hors ligne. Il a été signalé que le programme d'installation hors ligne résout de nombreux problèmes liés aux installations Java corrompues. Jeter un coup d'œil à ce guide pour nos étapes recommandées pour la réinstallation de Java sur toutes les plates-formes.
   
   Signes d'une installation Java corrompue :Création d'un magasin de clés pour ws://localhost...
- [échec] Création d'une paire de clés CA...
   
   … ou …
   
   version java
"Une erreur s'est produite lors du traitement du fichier d'archive partagé. Impossible de démapper l'espace partagé. Une erreur s'est produite lors de l'initialisation de la VM. Impossible d'utiliser l'archive partagée."
2. Parfois personnalisé JAVA_HOME les variables environnementales empêcheront le chargement de Dashlink Print. Si le logiciel peut être lancé via la ligne de commande c'est probablement le cas. Sous Windows, cela peut être vérifié en allant sur Système > Paramètres système avancés > Variables d'environnement
3. L'impression HTML (JavaFX) peut entraîner l'échec de l'impression si les conditions suivantes sont remplies :
   • Problème: La largeur de la page HTML est définie sur 100%.
     Remède: Codez en dur une page acceptable en utilisant CSS, par exemple 800px
   • Problème: La résolution de l'imprimante pour l'impression HTML est élevée (par exemple 600 dpi, 1 200 dpi).
     Remède: Codez en dur un DPI inférieur (par exemple 300 dpi) en utilisant { unités : 'in', densité : 300 }. Nous vous recommandons également de définir un environnement sain densité de secours au cas où 300 dpi ne seraient pas pris en charge par certains matériels.
   • Problème: Des problèmes de mémoire insuffisante peuvent survenir lors de l'exécution de la JVM 32 bits.
     Remède: Voir 32 bits contre 64 bits : section ci-dessous.
   • Problème: java.lang.NoClassDefFoundError : javafx/print/PrintColor sur qz.printer.PrintOptions$ColorType
     Remède: JavaFX n'est pas distribué avec toutes les versions de Java. Veuillez installer JavaFX pour votre plateforme (par exemple openjfx, etc).
4. Les images/PDF empêchent le logiciel de fonctionner: Plus communément Impossible d'appeler la méthode public void qz.ws.PrintSocketClient#onMessage, c'est généralement le signe que la JVM a rencontré une erreur irrécupérable. La cause la plus courante concerne les opérations d'impression volumineuses sur une JVM 32 bits. Une solution temporaire consiste à spécifier { rastériser : faux } dans la configuration, mais cela ne corrigera que les PDF. Une solution permanente consiste à passer à une JVM 64 bits qui alloue un espace de tas plus grand. Si 32 bits sont requis, un espace de tas supplémentaire peut être alloué via ligne de commande.
5. 32 bits contre 64 bits : Certaines stations de travail 64 bits sont équipées de versions Java 32 bits et 64 bits. Si les deux sont nécessaires, assurez-vous que les deux sont mis à niveau, sinon il est conseillé de supprimer la version 32 bits pour faciliter le processus de dépannage.
6. Version Java insuffisante "Une exception Java s'est produite" peut apparaître si vous tentez de lancer une version Java obsolète. Pour une liste des exigences minimales de Java, voir Versions Java. Peut également être signalé comme Impossible de trouver la classe principale qz.ws.PrintSocketServer. Le programme se terminera.
7. Disque corrompu : Toujours essayer fsck (Linux), Utilitaire de disque (MacOS) ou chkdsk (Les fenêtres). Les disques physiques peuvent présenter des symptômes étranges lorsqu'ils commencent à tomber en panne, mais les disques durs SSD sont sensibles à une condition appelée « bits usés » ou plus exactement « endurance SSD » qui est responsable de la réutilisation de la mémoire flash NAND. Ce processus devrait s'auto-réparer, mais peut parfois entraîner des problèmes avec certains micrologiciels de lecteur. Assurez-vous d'analyser l'état de votre disque lorsque vous rencontrez des problèmes de lancement.

Impossible de lister les imprimantes

1. Mac
   • En raison d'un bug en amont avec Java, les listes d'imprimantes peuvent échouer sur Mac. La solution actuelle consiste à :
     • Ouvrir les Préférences SystèmeImprimantes et scannersClic droit> Réinitialiser le système d'impressionRéajouter toutes les imprimantes
     Nous sommes conscients que ce n’est pas idéal, mais nous n’avons trouvé aucune autre solution sur Mac.
2. les fenêtres
   • Bien que cela soit rare, il existe des scénarios dans lesquels il n'est pas possible de répertorier les imprimantes, on ne peut répertorier qu'une seule imprimante ou la liste des imprimantes prend plusieurs minutes. Cela est probablement dû à un conflit de pilote entre le pilote d'imprimante incriminé et le spouleur d'impression, entraînant le blocage de l'ensemble du sous-système d'impression. La solution de contournement consiste à supprimer l'imprimante ou le pilote d'imprimante incriminé.

Files d'attente d'imprimante brutes

Si votre imprimante thermique ou d'étiquettes donne des résultats indésirables, il se peut qu'elle soit mal configurée. Voici nos tutoriels pour configurer une imprimante pour recevoir les langages bruts sur chaque plateforme :

• les fenêtres
• OS X
• Linux

Noter: Certains pilotes Windows, tels que le pilote ZDesigner de Zebra pour Microsoft Windows, prendront en charge l'impression brute ainsi que l'impression basée sur les pixels/PostScript. Vous pouvez utiliser ces pilotes ou un pilote brut-générique/texte uniquement pour envoyer des commandes brutes, mais le pilote générique ne pourra pas imprimer d'images/PDF/HTML.

Débogage des WebSockets

Par défaut, Dashlink Print supprime les informations détaillées sur les websockets de la console. Cependant, ces informations peuvent parfois être utiles pour le débogage/dépannage des problèmes de connectivité.

Débogage des WebSockets dans la version 2.0

• 2.0 uniquement - En utilisant le qz.api.showDebug(...) Option API, les détails de connexion détaillés seront enregistrés dans la console.qz.api.showDebug(true) du navigateur ; // doit être appelé avant d'appeler qz.websocket.connect()

Prise déconnectée

• C'est souvent le signe d'une version incompatible. Veuillez vous assurer que vous utilisez une version correcte pour votre système (par exemple 1.9, 2.0)

Autres erreurs

• Les journaux de la console disent Processus terminé avec le code de sortie 2
  • Cause : Cela indique qu'une autre instance de Dashlink Print est déjà en cours d'exécution sur les ports désignés sur cette machine. S'il ne répond plus, essayez de supprimer les impressions Dashlink. Java processus et essayez de le relancer.
• Erreur: erreur de type : _qz.tools.hash n'est pas une fonction
  • Cause : Assurez-vous que la page est rendue avec UTF-8 <meta charset='utf-8'>.
• Erreur: La connexion WebSocket à 'wss://localhost:8181/' a échoué : erreur lors de l'établissement de la connexion : net::ERR_CONNECTION_CLOSED
  • Cause : Java 9 (bêta) est connu pour provoquer cette erreur. Veuillez rétrograder vers un support pris en charge Version Java.
• Erreur: SCRIPT1010 : Identifiant attendu qz-tray.js
  • Cause : IE11 émule peut-être un ancien navigateur. Veuillez utiliser l'émulation de navigateur IE10, IE11 ou Edge. Le code incriminé peut ressembler à ceci <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
• Erreur: Le serveur a renvoyé le code de réponse HTTP : 403 pour l'URL
  • Cause : En supposant que les problèmes d'autorisation aient été exclus, certains serveurs nécessitent un Chaîne de l'agent utilisateur à transmettre au contrôleur Web. Dashlink Print 2.0 envoie un blanc Chaîne de l'agent utilisateur. Dashlink Print 2.1+ fournit un bon Chaîne de l'agent utilisateur. Vous pouvez également désactiver le Filtrage des agents utilisateurs sur le contrôleur Web. Par exemple, Cloudfare appelle cela Vérification de l'intégrité du navigateur et peut être désactivé.

JSON invalide

• Si la console du navigateur indique JSON invalide, essayez de modifier vos en-têtes HTTP dans l'exemple de message de signature pour utiliser texte simple au lieu de application/json. En PHP, cela se fait via :- header('Content-Type: application/json'); + header('Content-Type : texte/plain');Noter: Cette technique varie en fonction du langage côté serveur utilisé.

---

JScript

• Erreur: L'installation automatique du certificat n'est pas disponible pour cette plateforme
  • Cause : Plusieurs.
    • Noter: Dashlink Print 2.1 utilise Java pour l'installation des certificats et peut corriger ce problème.
    • Si vous utilisez l'antivirus Comodo, utilisez Advanced View, Auto-confinement, Disabled avant l'installation.
    • Si vous utilisez Windows XP, suivez les instructions à l'écran.
    • Ce problème peut être dû à des données incorrectes renvoyées par certutil commande. Contact support@qz.io à l'aide.
• Erreur: Impossible de trouver le moteur de script « VBScript » pour le script.
  • Noter: Dashlink Print a supprimé le VBScript/JScript dépendance et peut corriger ce problème.
  • Cause : Les programmes d'installation du bureau Windows pour Windows utilisent JScript moteur pour certaines tâches. Parfois, les moteurs antivirus peuvent tenter de remplacer ce moteur. Pour déterminer si c'est la cause, exécutez les commandes suivantes à partir de l'invite de commande :reg query HKCR\CLSID\{cc5bbec3-db4a-4bed-828d-08d78ee3e1ed}\InprocServer32 /ve reg query HKCR\CLSID\{f414c260-6ac0-11cf-b6d1 -00aa00bbbb58}\InprocServer32 /ve reg requête HKCR\CLSID\{f414c261-6ac0-11cf-b6d1-00aa00bbbb58}\InprocServer32 /ve reg requête HKCR\CLSID\{f414c262-6ac0-11cf-b6d1-00aa00bbbb58}\In procServer32 /ve
  • Si le système est correctement configuré, chaque commande renverra la valeur suivante :(Par défaut) REG_SZ C:\Windows\System32\jscript.dll
  • Si le système est mal configuré, il renverra une autre valeur. Cette valeur peut être réparée manuellement à l'aide de l'éditeur de registre Windows.

---

3. Assistance

Si vous avez des questions ou des problèmes lors de l'utilisation du tableau de bord, veuillez ouvrir un dossier d'assistance en nous écrivant à : upsplugins@ecommerce.help et inclure les informations suivantes

1. Description de l'erreur (idéalement avec vidéo/captures d'écran)
2. Système d'exploitation informatique
3. Modèle d'imprimante