Requisitos previos

Antes de instalar Dashlink Print, debe asegurarse de tener desinstaladas todas las versiones anteriores de QZ Tray.

Cada cliente deberá desinstalar QZ Tray manualmente primero; las dos aplicaciones no deberían coexistir porque lucharán por el mismo número de puerto.

• Para Windows, la desinstalación se puede realizar a través del Panel de control/Preferencias del sistema.
• Para Mac, la aplicación se puede arrastrar a la papelera de reciclaje, o los usuarios avanzados pueden querer ejecutar la script de desinstalación.
• Para Linux, el script de desinstalación es necesario.

1. Problemas conocidos

Aplicaciones conflictivas

Las siguientes aplicaciones pueden causar problemas con la instalación de Dashlink Print.

• Versiones anteriores de Java: Dashlink Print funciona mejor con Java 11 o superior. Las versiones anteriores de Dashlink Print pueden entrar en conflicto con Dashlink Print y provocar que no se inicie.
  • Si es posible, desinstale todas las versiones de Java, JRE, JDK u OpenJDK del sistema.
  • Si no es posible desinstalar versiones antiguas de Java, instale Dashlink Print 2.2 o superior, que vendrá incluido con su propia versión de Java.
• Software antivirus: Algunas aplicaciones antivirus pueden impedir la instalación o ejecución de Dashlink Print.
  • Comodo Antivirus forzará la contención de la aplicación en el instalador de Dashlink Print y evitará que se instale, desinstale y evitará que se ejecute. Además, desactivar Comodo tendrá muy poco efecto porque se volverá a activar sin previo aviso. Dashlink Print no es compatible con Comodo Antivirus.
• Otros antivirus:
  • Contención de aplicaciones: Si el antivirus fuerza la contención de la aplicación, desactive esta contención de la aplicación para Dashlink Print y el Java Runtime que utiliza.
  • Filtrado web: Si el antivirus bloquea el acceso a los puertos locales o a los certificados de host local, desactívelo o incluyalo en la lista blanca. https://localhost:8181, http://localhost:8182.
  • Acceso a archivos temporales: Si el antivirus bloquea el acceso al directorio temporal, desactive o incluya en la lista blanca el instalador de Dashlink Print.
  • Otros asuntos: QZ Industries no brinda soporte para problemas creados por aplicaciones antivirus de terceros. Las funciones integradas (como Windows Defender) son compatibles y se pueden escalar a los distintos apoyo canales.

2. Solución de problemas

Depuración de impresión de Dashlink

Registros

• Para comprimir registros automáticamente y colocarlos en su escritorio:
  • Ícono de impresión de Dashlink, avanzado, solución de problemas, registros zip (al escritorio)
• Dashlink Print coloca archivos de registro en las siguientes ubicaciones:
  • Ventanas: %APPDATA%\qz
  • Mac: ~/Biblioteca/Soporte de aplicaciones/qz
  • Linux: ~/.qz

Registros de consola

• El enfoque recomendado para obtener resultados detallados de Dashlink Print es iniciar el software desde la línea de comandos. Esto expondrá la consola Java con información detallada sobre mensajes de depuración y excepciones, incluido un seguimiento completo de dónde ocurrió una excepción en particular.
• Dashlink Print se lanza con 512MB de la memoria. Debemos especificar -Xms512M en el comando para evitar comportamientos inesperados y fallas. Esto no es necesario para Mac a menos que se siga la sintaxis básica (java -jar qz-bandeja.jar). Se puede asignar más memoria, pero no debería ser necesaria.Sintaxis básica (después de cerrar todas las instancias de Dashlink Print)java -Xms512M -jar qz-tray.jarventanas (después de cerrar todas las instancias de Dashlink Print)java -Xms512M –add-exports java.desktop/sun.swing=ALL-UNNAMED -jar “%PROGRAMFILES%\Dashlink Print\qz-tray.jar”Mac OS X (después de cerrar todas las instancias de Dashlink Print)/Applications/QZ\ Tray.app/Contents/MacOS/QZ\ TrayLinux/Otro (después de cerrar todas las instancias de Dashlink Print)/opt/qz-tray/qz-tray

Error en la ruta de compilación de PKIX

A veces un mensaje java.lang.UnsupportedOperationException: no se puede analizar (ARCHIVO) aparecerá. Esto suele deberse a que Java no descarga el recurso específico y será seguido por Causado por: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: error al crear la ruta PKIX

• Para obtener información detallada del certificado HTTPS/SSL, agregue -detallado -Djava.security.debug=certpath antes de -Xms512 dominio. El resultado será muy grande, puede redirigirlo al archivo usando > archivo.log 2>&1 al final.
• Ver también https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf
• Causas comunes
  • Cadena de certificados rota Remedio: Verifique la validez en sslshopper.com, corrija la cadena según las instrucciones de CA.
  • Certificado autofirmado Remedio: agregue una excepción al Proxy o Firewall para esta dirección, O BIEN, instale el certificado en Java.
  • CA recientemente confiable Remedio: actualice Java. Esto es bastante común para los certificados LetsEncrypt.

Fallo durante la impresión

No se puede iniciar el software

1. Una instalación de Java corrupta puede impedir que el software se instale o cargue. Una instalación corrupta de Java es bastante común en Windows y se puede resolver reinstalando Java usando Java instalador fuera de línea. Se ha informado que el instalador fuera de línea soluciona muchos problemas con instalaciones corruptas de Java. Echa un vistazo a esta guía para conocer nuestros pasos recomendados para reinstalar Java en todas las plataformas.
   
   Signos de una instalación de Java corrupta:Creando almacén de claves para ws://localhost...
- [falló] Creando un par de claves CA...
   
   … o …
   
   versión java
"Se produjo un error al procesar el archivo compartido. No se puede desasignar el espacio compartido. Se produjo un error durante la inicialización de la máquina virtual. No se puede usar el archivo compartido".
2. A veces personalizado JAVA_INICIO Las variables ambientales impedirán que Dashlink Print se cargue. Si el software se puede iniciar a través de la línea de comando este es probablemente el caso. En Windows esto se puede comprobar yendo a Sistema > Configuración avanzada del sistema > Variables de entorno
3. La impresión HTML (JavaFX) puede provocar que la impresión falle si se cumple lo siguiente:
   • Asunto: El ancho de la página HTML está establecido en 100%.
     Recurso: Codifique una página aceptable usando CSS, por ejemplo 800px
   • Asunto: La resolución de la impresora para impresión HTML es alta (por ejemplo, 600 ppp, 1200 ppp).
     Recurso: Codifique un DPI más bajo (por ejemplo, 300 ppp) usando { unidades: 'en', densidad: 300 }. También recomendamos establecer un sano respaldoDensidad en caso de que cierto hardware no admita 300 ppp.
   • Asunto: Pueden ocurrir problemas de falta de memoria si se ejecuta la JVM de 32 bits.
     Recurso: Ver 32 bits frente a 64 bits: sección siguiente.
   • Asunto: java.lang.NoClassDefFoundError: javafx/print/PrintColor en qz.printer.PrintOptions$ColorType
     Recurso: JavaFX no se distribuye con todas las versiones de Java. Instale JavaFX para su plataforma (p. ej. abrirjfx, etc).
4. Las imágenes/PDF hacen que el software deje de funcionar: Mas comunmente No se puede llamar al método public void qz.ws.PrintSocketClient#onMessage, esto generalmente es una señal de que la JVM ha encontrado un error irrecuperable. La causa más común son las operaciones de impresión grandes en una JVM de 32 bits. Una solución temporal es especificar { rasterizar: falso } en la configuración, pero esto sólo arreglará archivos PDF. Una solución permanente es cambiar a una JVM de 64 bits que asigna un espacio de almacenamiento dinámico mayor. Si se requieren 32 bits, se puede asignar espacio de almacenamiento dinámico adicional mediante línea de comando.
5. 32 bits frente a 64 bits: Algunas estaciones de trabajo de 64 bits tienen instaladas versiones Java de 32 y 64 bits. Si ambos son necesarios, asegúrese de que ambos estén actualizados; de lo contrario, se recomienda eliminar la versión de 32 bits para ayudar con el proceso de solución de problemas.
6. Versión de Java insuficiente "Se ha producido una excepción de Java" Puede aparecer si se intenta iniciar con una versión de Java desactualizada. Para obtener una lista de los requisitos mínimos de Java, consulte Versiones de Java. También puede reportarse como No se pudo encontrar la clase principal qz.ws.PrintSocketServer. Programa saldrá.
7. Disco dañado: Siempre intenta fsck (Linux), Utilidad de Discos (Mac OS) o chkdsk (Ventanas). Los discos físicos pueden mostrar síntomas extraños cuando comienzan a fallar, sin embargo, los discos duros SSD son susceptibles a una condición llamada "bits desgastados" o más propiamente "SSD Endurance", que es responsable de reutilizar la memoria flash NAND. Este proceso debería repararse solo, pero en ocasiones puede causar problemas con ciertos firmwares de unidades. Asegúrese de escanear el estado de su disco cuando tenga problemas de inicio.

No se pueden enumerar las impresoras

1. Mac
   • Debido a un error en Java, los listados de impresoras pueden fallar en Mac. La solución actual es:
     • Abra Preferencias del sistemaImpresoras y escáneresClic derecho> Restablecer sistema de impresiónVolver a agregar todas las impresoras
     Sabemos que esto no es lo ideal, pero no hemos encontrado otra solución en Mac.
2. ventanas
   • Aunque es poco común, existen situaciones en las que no se pueden enumerar las impresoras, solo se puede enumerar una impresora o la lista de impresoras tarda varios minutos en completarse. Es probable que esto se deba a un conflicto de controladores entre el controlador de impresora infractor y la cola de impresión, lo que provoca que todo el subsistema de impresión se cuelgue. La solución alternativa es eliminar la impresora o el controlador de impresora infractores.

Colas de impresión sin procesar

Si su impresora térmica o de etiquetas tiene resultados no deseados, es posible que esté configurada incorrectamente. Aquí están nuestros tutoriales para configurar una impresora para recibir lenguajes sin formato en cada plataforma:

• ventanas
• OSX
• linux

Nota: Algunos controladores de Windows, como el controlador ZDesigner de Zebra para Microsoft Windows, admitirán la impresión sin formato junto con la impresión PostScript o basada en píxeles. Puede utilizar esos controladores o un controlador genérico sin formato/solo texto para enviar comandos sin formato, pero el controlador genérico no podrá imprimir imágenes/PDF/HTML.

Depuración de WebSockets

De forma predeterminada, Dashlink Print suprime la información detallada de websocket de la consola; sin embargo, ocasionalmente esta información puede ser útil para depurar o solucionar problemas de conectividad.

Depuración de WebSockets en 2.0

• 2.0 solamente - Utilizando el qz.api.showDebug(...) Opción API, los detalles detallados de la conexión se registrarán en la consola del navegador.qz.api.showDebug(true); // debe llamarse antes de llamar a qz.websocket.connect()

Enchufe desconectado

• Esto suele ser un signo de una versión incompatible. Asegúrese de estar utilizando una compilación correcta para su sistema (por ejemplo, 1.9, 2.0)

Otros errores

• Los registros de la consola dicen Proceso finalizado con código de salida 2
  • Causa: Esto indica que ya se está ejecutando otra instancia de Dashlink Print en los puertos designados en esa máquina. Si no responde, intente eliminar Dashlink Prints Java proceso e intente ejecutarlo nuevamente.
• Error: error de tipo: _qz.tools.hash no es una función
  • Causa: asegúrese de que la página se esté procesando con UTF-8 <meta charset='utf-8'>.
• Error: Error en la conexión de WebSocket a 'wss://localhost:8181/': Error al establecer la conexión: net::ERR_CONNECTION_CLOSED
  • Causa: Se sabe que Java 9 (Beta) causa este error. Baje de categoría a un soporte versión java.
• Error: SCRIPT1010: Identificador esperado qz-tray.js
  • Causa: Es posible que IE11 esté emulando un navegador más antiguo. Utilice la emulación del navegador IE10, IE11 o Edge. El código ofensivo puede verse así <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
• Error: El servidor devolvió el código de respuesta HTTP: 403 para URL
  • Causa: Suponiendo que se hayan descartado problemas de permisos, algunos servidores requieren una Cadena de agente de usuario para pasar al controlador web. Dashlink Print 2.0 envía un espacio en blanco Cadena de agente de usuario. Dashlink Print 2.1+ proporciona una adecuada Cadena de agente de usuario. Alternativamente, deshabilite el Filtrado de agentes de usuario en el controlador web. Por ejemplo, Cloudfare llama a esto Comprobación de integridad del navegador y se puede desactivar.

JSON no válido

• Si la consola del navegador dice JSON no válido, intente cambiar sus encabezados HTTP en el ejemplo del mensaje de firma para usar Texto sin formato en lugar de aplicación/json. En PHP, esto se hace mediante:- header('Tipo de contenido: aplicación/json'); + encabezado('Tipo de contenido: texto/sin formato');Nota: Esta técnica variará según el lenguaje del lado del servidor que se utilice.

---

jscript

• Error: La instalación automática de certificados no está disponible para esta plataforma
  • Causa: Varias.
    • Nota: Dashlink Print 2.1 usa Java para la instalación de certificados y puede corregir este problema.
    • Si utiliza el antivirus Comodo, utilice Vista avanzada, Contención automática, Desactivado antes de la instalación.
    • Si utiliza Windows XP, siga las instrucciones que aparecen en pantalla.
    • Este problema puede deberse a que se devuelven datos incorrectos desde certificado dominio. Contacto soporte@qz.io para asistencia.
• Error: No puedo encontrar el motor de secuencias de comandos “VBScript” para la secuencia de comandos.
  • Nota: Dashlink Print ha eliminado el VBScript/JScript dependencia y puede corregir este problema.
  • Causa: Los instaladores de escritorio de Windows para uso de Windows jscript motor para determinadas tareas. En ocasiones, los motores antivirus pueden intentar reemplazar este motor. Para determinar si esta es la causa, ejecute los siguientes comandos desde el símbolo del sistema: reg query HKCR\CLSID\{cc5bbec3-db4a-4bed-828d-08d78ee3e1ed}\InprocServer32 /ve reg query HKCR\CLSID\{f414c260-6ac0-11cf-b6d1 -00aa00bbbb58}\InprocServer32 /ve consulta de registro HKCR\CLSID\{f414c261-6ac0-11cf-b6d1-00aa00bbbb58}\InprocServer32 /ve consulta de registro HKCR\CLSID\{f414c262-6ac0-11cf-b6d1-00aa00bbbb58}\In procServer32 /ve
  • Si el sistema está configurado correctamente, cada comando devolverá el siguiente valor:(Predeterminado) REG_SZ C:\Windows\System32\jscript.dll
  • Si el sistema está mal configurado, devolverá algún otro valor. Este valor se puede reparar manualmente utilizando el Editor del Registro de Windows.

---

3. Apoyo

Si tiene alguna pregunta o problema al usar el Panel, abra un caso de soporte escribiéndonos a: upsplugins@ecommerce.help e incluir la siguiente información

1. Descripción del error (idealmente con vídeo/capturas de pantalla)
2. Sistema operativo de computadora
3. Modelo de impresora