Vereisten

Voordat u Dashlink Print installeert, moet u ervoor zorgen dat alle eerdere versies van QZ Tray zijn verwijderd.

Elke client zal QZ Tray eerst handmatig moeten verwijderen. De twee applicaties mogen niet naast elkaar bestaan omdat ze zullen vechten voor hetzelfde poortnummer.

• Voor Windows kan de verwijdering worden uitgevoerd via het Configuratiescherm/Systeemvoorkeuren.
• Voor Mac kan de app naar de prullenbak worden gesleept, of geavanceerde gebruikers willen misschien de app uitvoeren script verwijderen.
• Voor Linux is de script verwijderen is nodig.

1. Bekende problemen

Conflicterende toepassingen

De volgende toepassingen kunnen problemen veroorzaken bij de installatie van Dashlink Print.

• Oudere Java-versies: Dashlink Print werkt het beste met Java 11 of hoger. Oudere versies van Dashlink Print kunnen conflicteren met Dashlink Print, waardoor het programma niet meer opstart.
  • Verwijder indien mogelijk alle versies van Java, JRE, JDK of OpenJDK van het systeem.
  • Als het verwijderen van oude versies van Java niet mogelijk is, installeer dan Dashlink Print 2.2 of hoger, dat wordt geleverd met een eigen Java-versie.
• Antivirus software: Sommige antivirusprogramma's kunnen voorkomen dat Dashlink Print wordt geïnstalleerd of uitgevoerd.
  • Comodo Antivirus dwingt de insluiting van de applicatie door het Dashlink Print-installatieprogramma en voorkomt dat het wordt geïnstalleerd, verwijderd en voorkomt dat het wordt uitgevoerd. Bovendien zal het uitschakelen van Comodo zeer weinig effect hebben, omdat het zichzelf zonder waarschuwing opnieuw zal inschakelen. Dashlink Print wordt niet ondersteund door Comodo Antivirus.
• Ander antivirusprogramma:
  • Toepassingsbeperking: Als de antivirus de insluiting van applicaties afdwingt, schakel dan deze applicatie-insluiting uit voor Dashlink Print en de Java Runtime die deze gebruikt.
  • Webfiltering: Als de antivirus de toegang tot lokale poorten of localhost-certificaten blokkeert, schakel deze dan uit of zet deze op de witte lijst https://localhost:8181, http://localhost:8182.
  • Tijdelijke bestandstoegang: Als de antivirus de toegang tot de tijdelijke map blokkeert, schakel dan het Dashlink Print-installatieprogramma uit of zet het op de witte lijst.
  • Andere problemen: QZ Industries biedt geen ondersteuning voor problemen die worden veroorzaakt door antivirusprogramma's van derden. Ingebouwde functies (zoals Windows Defender) worden ondersteund en kunnen worden geëscaleerd naar de verschillende steun kanalen.

2. Problemen oplossen

Foutopsporing in Dashlink Print

Logboeken

• Logboeken automatisch zippen en op uw bureaublad plaatsen:
  • Dashlink Print-pictogram, Geavanceerd, Probleemoplossing, Zip-logs (naar bureaublad)
• Dashlink Print plaatst logbestanden op de volgende locaties:
  • Ramen: %APPDATA%\qz
  • Mac: ~/Bibliotheek/Applicatieondersteuning/qz
  • Linux: ~/.qz

Consolelogboeken

• De aanbevolen aanpak voor het verkrijgen van uitgebreide uitvoer van Dashlink Print is om de software vanaf de opdrachtregel te starten. Hierdoor wordt de Java Console voorzien van gedetailleerde informatie over foutopsporingsberichten en uitzonderingen, inclusief een volledige backtrace van waar een bepaalde uitzondering heeft plaatsgevonden.
• Dashlink Print wordt gelanceerd met 512 MB van geheugen. Wij moeten specificeren -Xms512M in de opdracht om onverwacht gedrag en crashen te voorkomen. Dit is niet nodig voor Mac, tenzij je de basissyntaxis volgt (java -jar qz-tray.jar). Er kan meer geheugen worden toegewezen, maar dit hoeft niet noodzakelijk te zijn.Basissyntaxis (na het sluiten van alle exemplaren van Dashlink Print)java -Xms512M -jar qz-tray.jarramen (na het sluiten van alle exemplaren van Dashlink Print)java -Xms512M –add-exports java.desktop/sun.swing=ALL-UNNAMED -jar “%PROGRAMFILES%\Dashlink Print\qz-tray.jar”Mac OS X (na het sluiten van alle exemplaren van Dashlink Print)/Applications/QZ\ Tray.app/Contents/MacOS/QZ\ TrayLinux/Anders (na het sluiten van alle exemplaren van Dashlink Print)/opt/qz-tray/qz-tray

PKIX-buildpad mislukt

Soms een bericht java.lang.UnsupportedOperationException: Kan niet parseren (BESTAND) zal verschijnen. Dit is vaak een fout van Java bij het downloaden van de specifieke bron en wordt gevolgd door Veroorzaakt door: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: Het bouwen van PKIX-paden is mislukt

• Voeg toe om gedetailleerde HTTPS/SSL-certificaatinformatie op te halen -verbose -Djava.security.debug=certpad vóór de -Xms512 commando. De uitvoer zal erg groot zijn. U kunt deze omleiden naar een bestand met behulp van > bestand.log 2>&1 aan het einde.
• Zie ook https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf
• Algemene oorzaken
  • Kapotte certificaatketen Oplossing: Controleer de geldigheid van sslshopper.com, repareer de keten volgens CA-instructies.
  • Zelfondertekend certificaat Oplossing: Voeg een uitzondering toe aan Proxy of Firewall voor dit adres — OF — Installeer het certificaat in Java.
  • Nieuw vertrouwde CA Oplossing: Java bijwerken. Dit is vrij gebruikelijk bij LetsEncrypt-certificaten.

Crash tijdens het afdrukken

Kan software niet starten

1. Een corrupte Java-installatie kan ervoor zorgen dat de software niet kan worden geïnstalleerd of geladen. Een corrupte Java-installatie komt vrij vaak voor in Windows en kan worden opgelost door Java opnieuw te installeren met behulp van Java offline installatieprogramma. Er is gemeld dat het offline installatieprogramma veel problemen met corrupte Java-installaties oplost. Kijk eens naar deze gids voor onze aanbevolen stappen voor het opnieuw installeren van Java op alle platforms.
   
   Tekenen van een corrupte Java-installatie:Sleutelarchief maken voor ws://localhost...
- [mislukt] Een CA-sleutelpaar aanmaken...
   
   … of …
   
   java-versie
"Er is een fout opgetreden tijdens het verwerken van het gedeelde archiefbestand. Kan de toewijzing van de gedeelde ruimte niet ongedaan maken. Er is een fout opgetreden tijdens de initialisatie van de VM. Kan het gedeelde archief niet gebruiken."
2. Soms op maat JAVA_HOME omgevingsvariabelen voorkomen dat Dashlink Print wordt geladen. Als de software kan worden gestart via de opdrachtregel Dit is waarschijnlijk het geval. In Windows kunt u dit controleren door naar te gaan Systeem > Geavanceerde systeeminstellingen > Omgevingsvariabelen
3. HTML-afdrukken (JavaFX) kunnen ervoor zorgen dat het afdrukken mislukt als het volgende waar is:
   • Probleem: HTML-paginabreedte is ingesteld op 100%.
     Remedie: Codeer een acceptabele pagina met behulp van CSS, bijv 800px
   • Probleem: De printerresolutie voor HTML-afdrukken is hoog (bijvoorbeeld 600 dpi, 1200 dpi).
     Remedie: Codeer een lagere DPI (bijvoorbeeld 300 dpi) met behulp van { eenheden: 'in', dichtheid: 300 }. We raden ook aan een gezond in te stellen fallbackDensiteit in het geval dat 300 dpi niet wordt ondersteund door bepaalde hardware.
   • Probleem: Problemen met onvoldoende geheugen kunnen optreden als u de 32-bits JVM gebruikt.
     Remedie: Zien 32-bit versus 64-bit: sectie hieronder.
   • Probleem: java.lang.NoClassDefFoundError: javafx/print/PrintColor op qz.printer.PrintOptions$ColorType
     Remedie: JavaFX wordt niet bij alle Java-versies meegeleverd. Installeer JavaFX voor uw platform (bijv openjfx, enz).
4. Afbeeldingen/PDF's zorgen ervoor dat software niet meer werkt: Vaker Kan methode public void qz.ws.PrintSocketClient#onMessage niet aanroepen, is dit over het algemeen een teken dat de JVM een onherstelbare fout heeft aangetroffen. De meest voorkomende oorzaak zijn grote afdrukbewerkingen op een 32-bits JVM. Een tijdelijke oplossing is om dit op te geven { rasteriseren: false } in de configuratie, maar hiermee worden alleen PDF's hersteld. Een permanente oplossing is om over te schakelen naar een 64-bits JVM die een grotere heapruimte toewijst. Als 32-bit vereist is, kan via extra heapruimte worden toegewezen opdrachtregel.
5. 32-bit versus 64-bit: Op sommige 64-bits werkstations zijn zowel de 32-bits als de 64-bits Java-versie geïnstalleerd. Als beide nodig zijn, zorg er dan voor dat beide zijn geüpgraded. Anders wordt geadviseerd om de 32-bits versie te verwijderen om te helpen bij het probleemoplossingsproces.
6. Onvoldoende Java-versie "Er heeft zich een Java-uitzondering voorgedaan" kan verschijnen als u probeert te starten met een verouderde Java-versie. Zie voor een lijst met minimale Java-vereisten Java-versies. Kan ook worden gerapporteerd als Kan de hoofdklasse qz.ws.PrintSocketServer niet vinden. Programma zal stoppen.
7. Schijf beschadigd: Altijd proberen fsck (Linux), Schijfhulpprogramma (MacOS) of chkdsk (Ramen). Fysieke schijven kunnen vreemde symptomen vertonen wanneer ze beginnen te falen, maar harde schijven van SSD's zijn vatbaar voor een aandoening die "versleten bits" of beter gezegd "SSD Endurance" wordt genoemd en die verantwoordelijk is voor het hergebruik van NAND-flashgeheugen. Dit proces zou zelfherstellend moeten zijn, maar kan soms problemen veroorzaken met bepaalde schijffirmwares. Zorg ervoor dat u uw schijf scant op de gezondheid wanneer u opstartproblemen tegenkomt.

Kan printers niet weergeven

1. Mac
   • Vanwege een upstream-bug met Java kunnen de printerlijsten mislukken op de Mac. De huidige oplossing is:
     • Open SysteemvoorkeurenPrinters en scannersKlik met de rechtermuisknop > Reset afdruksysteemVoeg alle printers opnieuw toe
     We realiseren ons dat dit niet ideaal is, maar hebben geen andere oplossing gevonden voor de Mac.
2. ramen
   • Hoewel dit zelden voorkomt, zijn er scenario's waarbij het niet lukt om printers te vermelden, slechts één printer kan vermelden, of het weergeven van printers enkele minuten in beslag neemt. Dit wordt waarschijnlijk veroorzaakt door een driverconflict tussen het overtredende printerstuurprogramma en de printspooler, waardoor het hele afdruksubsysteem vastloopt. De oplossing is het verwijderen van de overtredende printer of het printerstuurprogramma.

Raw-printerwachtrijen

Als uw thermische of labelprinter ongewenste resultaten oplevert, is deze mogelijk onjuist geconfigureerd. Hier zijn onze tutorials voor het instellen van een printer om onbewerkte talen op elk platform te ontvangen:

• ramen
• OS X
• Linux

Opmerking: Sommige Windows-stuurprogramma's, zoals Zebra's ZDesigner-stuurprogramma voor Microsoft Windows, ondersteunen onbewerkt afdrukken naast pixelgebaseerd/PostScript-afdrukken. U kunt deze stuurprogramma's of een onbewerkt-generiek/alleen-tekststuurprogramma gebruiken om onbewerkte opdrachten te verzenden, maar het generieke stuurprogramma kan geen afbeeldingen/PDF/HTML afdrukken.

Foutopsporing in WebSockets

Standaard onderdrukt Dashlink Print uitgebreide websocket-informatie van de console, maar af en toe kan deze informatie nuttig zijn voor het debuggen/oplossen van verbindingsproblemen.

Foutopsporing in WebSockets in 2.0

• Alleen 2.0 - De ... gebruiken qz.api.showDebug(...) API-optie, uitgebreide verbindingsgegevens worden vastgelegd in de console van de browser.qz.api.showDebug(true); // moet worden aangeroepen voordat qz.websocket.connect() wordt aangeroepen

Stekkerdoos losgekoppeld

• Dit is vaak een teken van een incompatibele versie. Zorg ervoor dat u een build gebruikt die geschikt is voor uw systeem (bijvoorbeeld 1.9, 2.0)

Andere fouten

• Consolelogboeken zeggen Proces afgerond met exitcode 2
  • Oorzaak: Dit geeft aan dat er al een ander exemplaar van Dashlink Print actief is op de aangewezen poorten op die machine. Als het niet meer reageert, probeer dan de Dashlink-afdrukken te doden Java proces en probeer het opnieuw te starten.
• Fout: typeerror: _qz.tools.hash is geen functie
  • Oorzaak: Zorg ervoor dat de pagina wordt weergegeven met UTF-8 <meta charset='utf-8'>.
• Fout: WebSocket-verbinding met 'wss://localhost:8181/' mislukt: fout bij het tot stand brengen van de verbinding: net::ERR_CONNECTION_CLOSED
  • Oorzaak: Het is bekend dat Java 9 (bèta) deze fout veroorzaakt. Gelieve te downgraden naar een ondersteund Java-versie.
• Fout: SCRIPT1010: Verwachte identificatie qz-tray.js
  • Oorzaak: IE11 emuleert mogelijk een oudere browser. Gebruik IE10-, IE11- of Edge-browseremulatie. Aanstootgevende code kan er als volgt uitzien <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
• Fout: De server heeft HTTP-antwoordcode geretourneerd: 403 voor URL
  • Oorzaak: Ervan uitgaande dat toestemmingsproblemen zijn uitgesloten, hebben sommige servers een Tekenreeks voor gebruikersagent doorgeven aan de webcontroller. Dashlink Print 2.0 stuurt een blanco bericht Tekenreeks voor gebruikersagent. Dashlink Print 2.1+ biedt een goede Tekenreeks voor gebruikersagent. U kunt ook de Filteren van gebruikersagenten op de webcontroller. Cloudfare noemt dit bijvoorbeeld Browserintegriteitscontrole en kan worden uitgeschakeld.

Ongeldige JSON

• Als de browserconsole zegt Ongeldige JSON, probeer uw HTTP-headers in het sign-message-voorbeeld te wijzigen tekst/gewoon in plaats van toepassing/json. In PHP gebeurt dit via:- header('Content-Type: application/json'); + header('Inhoudstype: tekst/plain');Opmerking: Deze techniek zal variëren afhankelijk van de taal aan de serverzijde die wordt gebruikt.

---

JScript

• Fout: Automatische certificaatinstallatie is niet beschikbaar voor dit platform
  • Oorzaak: meerdere.
    • Opmerking: Dashlink Print 2.1 gebruikt Java voor de installatie van certificaten en kan dit probleem mogelijk verhelpen.
    • Als u Comodo-antivirus gebruikt, gebruik dan Geavanceerde weergave, Automatische insluiting, Uitgeschakeld voordat u installeert.
    • Als u Windows XP gebruikt, volgt u de instructies op het scherm.
    • Dit probleem kan worden veroorzaakt doordat er slechte gegevens worden geretourneerd certutil commando. Contact ondersteuning@qz.io Voor assistentie.
• Fout: Kan scriptengine “VBScript” voor script niet vinden.
  • Opmerking: Dashlink Print heeft de VBScript/JScript afhankelijkheid en kan dit probleem verhelpen.
  • Oorzaak: De Windows-desktopinstallatieprogramma's voor Windows gebruiken JScript motor voor bepaalde taken. Af en toe kunnen antivirusengines proberen deze engine te vervangen. Om te bepalen of dit de oorzaak is, voert u de volgende opdrachten uit vanaf de opdrachtprompt: reg query HKCR\CLSID\{cc5bbec3-db4a-4bed-828d-08d78ee3e1ed}\InprocServer32 /ve reg query HKCR\CLSID\{f414c260-6ac0-11cf-b6d1 -00aa00bbbb58}\InprocServer32 /ve reg-query HKCR\CLSID\{f414c261-6ac0-11cf-b6d1-00aa00bbbb58}\InprocServer32 /ve reg-query HKCR\CLSID\{f414c262-6ac0-11cf-b6d1-00aa00bbbb58}\Inpro cServer32 /ve
  • Als het systeem correct is geconfigureerd, retourneert elke opdracht de volgende waarde:(Standaard) REG_SZ C:\Windows\System32\jscript.dll
  • Als het systeem verkeerd is geconfigureerd, retourneert het een andere waarde. Deze waarde kan handmatig worden gerepareerd met behulp van de Windows Register-editor.

---

3. Ondersteuning

Als u vragen of problemen heeft bij het gebruik van het dashboard, kunt u een ondersteuningsaanvraag indienen door ons te schrijven op: upsplugins@ecommerce.help en vermeld de volgende informatie

1. Foutbeschrijving (idealiter met video/screenshots)
2. Computerbesturingssysteem
3. Printermodel