ZPL-Debugger

Eine ZPL-Datei Zeile für Zeile debuggen

1. Fügen Sie das ZPL genau so ein, wie Ihr System es an den Drucker schickt — Spooldatei, ERP-Export oder ein vom Carrier geliefertes Etikett. Tragen Sie die echte Etikettengröße und Dichte ein: Befunde zu Beschnitt und Feldern außerhalb des Etiketts hängen davon ab.
2. Klicken Sie auf Debuggen. Dieselbe Regel-Engine wie hinter dem Diagnosezentrum läuft einmal, und jeder Befund kommt mit Zeile und Spalte zurück statt als Zusammenfassung.
3. Lesen Sie den annotierten Quelltext. Fehlerzeilen sind rot, Warnzeilen bernsteinfarben getönt, und jede Anmerkung steht direkt unter ihrer Zeile — samt vorgeschlagener Korrektur, wo die Engine eine hat, etwa das Löschen eines unbekannten Befehls.
4. Beheben Sie den ersten strukturellen Fehler, bevor Sie den Rest bewerten. Ein unausgeglichenes ^XA/^XZ oder ein fehlendes ^FS am Dateianfang erzeugt oft eine Befundkaskade, die mit der ersten Korrektur verschwindet.

Wann dieses Werkzeug das richtige ist

Nutzen Sie den Debugger, wenn Sie bereits wissen, dass das Etikett defekt ist, und die genaue Zeile finden müssen — ein Auftrag, der leer druckt, eine Vorlage, die nach einer Änderung ein Feld verlor, eine ERP-Zusammenführung, in der eine von vierzig Zeilen falsch ist. Die Zeilenansicht beantwortet das "Wo" schneller als ein Abschnittsbericht, weil Sie den Befund im Kontext des verursachenden Codes lesen. Wollen Sie das Gegenteil — ein Gesamturteil mit Punktzahl, Abschnitt für Abschnitt —, präsentiert das ZPL-Diagnosezentrum die Befunde derselben Engine genau so.

Häufige Fragen

• Was unterscheidet den Debugger vom Diagnosezentrum? — Dieselbe Engine, andere Darstellung. Das Zentrum gruppiert Befunde in Abschnitte (Syntax, Größe, Barcodes, Schriften…) und berechnet eine ehrliche Punktzahl; der Debugger heftet jeden Befund an die verursachende Quellzeile. "Wie gesund ist das Etikett" gegen "welche Zeile ist falsch".
• Verändert der Debugger mein ZPL? — Nein. Das Werkzeug ist rein lesend: Es meldet Befunde und zeigt die vorgeschlagene Korrektur als Text, aber Ihre Eingabe wird weder verändert noch gespeichert oder protokolliert — die Anfrage ist zustandslos.
• Warum hängen Befunde von der eingegebenen Etikettengröße ab? — Weil mehrere Regeln das Etikett an seiner physischen Größe messen: Ein Feld bei x=5000 ist auf einem breiten Etikett in Ordnung und auf einem 4-Zoll-Etikett außerhalb, und Punkte bedeuten bei 203 und 300 dpi unterschiedliche Abstände. Tragen Sie die echte Größe ein, damit die Befunde zu Ihrem Drucker passen.