Benutzerdefinierte Befehle

COMMENT

Beim Erstellen einer Befehlsdatei empfiehlt es sich, Ihre Befehle zu dokumentieren. Auf diese Weise können Sie leicht erkennen, welchen Zweck ein bestimmtes Skript erfüllt, wenn Sie sich den Code nach einiger Zeit erneut ansehen. Verwenden Sie zu Beginn der Zeile ein Semikolon (;). Alles, was darauf folgt, wird als Kommentar behandelt und nicht verarbeitet.

CLEARVARIABLEVALUES

Dieser Befehl setzt Variablenwerte auf ihre Standardwerte zurück.

CREATEFILE

Dieser Befehl erstellt eine Textdatei. Verwenden Sie sie, um einer Drittanwendung zu signalisieren, dass der Druckprozess begonnen hat oder abgeschlossen wurde, je nachdem, an welcher Stelle Sie den Befehl einsetzen. Verwenden Sie für Netzwerkressourcen die UNC-Syntax. Weitere Informationen finden Sie im Abschnitt Zugriff auf freigegebene Ressourcen im Netzwerk.

DELETEFILE

Löscht die angegebene Datei. Verwenden Sie für Netzwerkressourcen die UNC-Syntax. Weitere Informationen finden Sie im Abschnitt Zugriff auf freigegebene Ressourcen im Netzwerk.

EXPORTLABEL

Dieser Befehl automatisiert den Befehl „An Drucker exportieren“, der im Etikettendesigner zur Verfügung steht. Das Etikett wird direkt an den Drucker exportiert und zwecks Offline-Druck im Druckerspeicher abgelegt. Benutzer rufen das Etikett per Drucker-Tastenbefehl oder durch Senden einer Befehlsdatei an den Drucker auf. Dieselbe Funktionalität ist auch anhand der Aktion Etikett im Drucker speichern verfügbar.

Weitere Informationen finden Sie im Abschnitt Speichern/Abrufen-Druckmodus verwenden im Benutzerhandbuch.

IGNOREERROR

Dieser Befehl gibt an, dass der Druckprozess beim Auftreten eines der folgenden Fehler in der JOB-Datei nicht beendet wird:

LABEL

Dieser Befehl öffnet das zu druckende Etikett. Wenn das Etikett bereits geladen ist, wird es nicht erneut geöffnet. Sie können auch den Pfad angeben. Schließen Sie den Etikettennamen in Anführungszeichen ein, falls er Leerzeichen enthält. Verwenden Sie für Netzwerkressourcen die UNC-Syntax. Weitere Informationen finden Sie im Abschnitt Zugriff auf freigegebene Ressourcen im Netzwerk.

Der optionale Parameter Druckername gibt den Drucker an, für den das Etikett geöffnet wird. Verwenden Sie diese Einstellung, wenn Sie den Drucker umgehen wollen, der in der Etikettenvorlage gespeichert ist. Falls der Treiber für den angegebenen Druckernamen nicht installiert wurde oder nicht verfügbar ist, gibt der Befehl einen Fehler aus.

MESSAGEBOX

Dieser Befehl speichert eine benutzerdefinierte Meldung im Trigger-Protokoll. Falls die Meldung Leerzeichen oder Kommas enthält, müssen Sie den Text in Anführungszeichen (") einschließen.

Anschluss

Dieser Befehl übergeht die im Druckertreiber definierte Schnittstelle und leitet den Druck an eine Datei um. Falls der Pfad oder der Dateiname Leerzeichen enthält, schließen Sie den Wert in Anführungszeichen (") ein. Verwenden Sie für Netzwerkressourcen die UNC-Syntax. Weitere Informationen finden Sie im Abschnitt Zugriff auf freigegebene Ressourcen im Netzwerk.

Der Parameter APPEND ist optional. Standardmäßig wird die Datei überschrieben. Verwenden Sie diesen Parameter, um die Daten an den Inhalt der vorhandenen Datei anzuhängen.

Wenn Sie den PORT-Befehl in der JOB-Datei verwenden, bleibt dieser bis zum nächsten PORT-Befehl oder bis zum Ende der Datei gültig (je nachdem, was vorher auftritt). Wenn Sie den PRINTER-Befehl nach Ausführung des PORT-Befehls verwenden, wird der für den ausgewählten Drucker festgelegte Port übergangen. Wenn Sie den tatsächlichen, für den ausgewählten Drucker definierten Port verwenden möchten, müssen Sie einen weiteren PORT-Befehl mit leerem Wert hinzufügen (PORT = "").

PRINT

Dieser Befehl startet den Druckprozess.

PRINTER

Dieser Befehl übergeht den in der Etikettenvorlage definierten Drucker. Falls der Druckername Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Verwenden Sie den Druckernamen, wie er in der Statuszeile der Etikettendesign-Anwendung angezeigt wird. Druckernamen entsprechen normalerweise den Namen unter „Drucker und Faxgeräte“ in der Systemsteuerung; dies ist aber nicht immer der Fall. Wenn Sie Netzwerkdrucker verwenden, wird der Name eventuell anhand der Syntax \\server\share angezeigt.

PRINTJOBNAME

Dieser Befehl gibt den Namen des Druckauftrags an, der im Windows Spooler angezeigt wird. Falls der Name Leerzeichen oder Kommas enthält, müssen Sie den Wert in Anführungszeichen (") einschließen.

SESSIONEND

Dieser Befehl schließt den Druckdatenstrom. Siehe auch SESSIONSTART.

SESSIONPRINT

Dieser Befehl druckt das aktuell referenzierte Etikett und fügt es dem momentan geöffneten Sitzungs-Druckdatenstrom hinzu. Sie können mehrere SESSIONPRINT-Befehle hintereinander verwenden und die referenzierten Etiketten in einem einzigen Druckdatenstrom vereinen. Der Datenstrom wird erst geschlossen, wenn Sie ihn anhand des SESSIONEND-Befehls schließen. Die Bedeutung der Parameter „Menge“ und „überspringen“ ist dieselbe wie im NiceCommand PRINT. Siehe auch den SESSIONSTART-Befehl.

SESSIONSTART

Dieser Befehl leitet den Sitzungsdruck ein.

Die drei Sitzungsdruck-bezogenen Befehle (SESSIONSTART, SESSIONPRINT, SESSIONEND) werden gemeinsam verwendet. Wenn Sie den Befehl PRINT verwenden, werden Daten für jedes Etikett in einem separaten Druckauftrag an den Drucker gesendet. Wenn Sie Etikettendaten für mehrere Etiketten in einen Druckdatenstrom integrieren möchten, sollten Sie die Befehle für Sitzungsdruck verwenden. Beginnen Sie zu diesem Zweck mit dem SESSIONSTART-Befehl, gefolgt von einer beliebigen Anzahl von SESSIONPRINT-Befehlen. Die Abfolge endet mit dem SESSIONEND-Befehl.

Nutzen Sie diese Befehle, um den Etikettendruckprozess zu optimieren. Das Drucken von Etiketten, die zu einem einzelnen Druckauftrag gehören, geht deutlich schneller als das Drucken von Etiketten anhand mehrerer Druckaufträge.

Verwenden Sie die folgenden Regeln, um sicherzustellen, dass der Sitzungsdruck nicht fehlschlägt:

SET

Dieser Befehl weist der Variablen Name den Wert zu. Die Variable muss auf dem Etikett definiert sein; andernfalls wird ein Fehler ausgegeben. Befindet sich die Variable nicht auf dem Etikett, wird ein Fehler ausgegeben. Schritt und Anzahl der Wiederholungen sind Parameter für Zähler-Variablen. Diese Parameter geben den Erhöhungswert für den Zähler sowie die Anzahl von gedruckten Etiketten vor Änderung des Zählerwerts an.

Falls ein Wert Leerzeichen oder Kommas enthält, müssen Sie den Text in Anführungszeichen (") setzen. Siehe auch TEXTQUALIFIER.

Falls Sie einen mehrzeiligen Wert zuweisen möchten, verwenden Sie \r\n, um einen Zeilenumbruch zu kodieren. \r wird durch CR (Schlittenrücklauf) und \n durch LF (Zeilenvorschub) ersetzt.

Seien Sie vorsichtig beim Festlegen von Variablen, welche Daten für Bilder auf dem Etikett angeben, da Backslash-Zeichen durch andere Zeichen ersetzt werden könnten.

SETPRINTPARAM

Mit diesem Befehl können Sie vor dem Drucken eine Feinabstimmung der Druckereinstellungen vornehmen. Die unterstützten Parameter für die Druckereinstellungen (paramname) sind:

TEXTQUALIFIER

Ein Textbegrenzer ist ein Zeichen, das einen Datenwert einschließt, welcher einer Variablen zugewiesen ist. Falls ein Datenwert Leerzeichen enthält, muss er in den Textbegrenzer eingeschlossen werden. Der Standard-Textbegrenzer ist das Anführungszeichen ("). Da das Anführungszeichen auch als Maßeinheit für Zoll verwendet wird, ist es in manchen Fällen schwierig, Daten mit Zollangaben in JOB-Dateien zu integrieren. Sie können zwei Anführungszeichen verwenden, um ein Anführungszeichen zu codieren, oder den Befehl TEXTQUALIFIER verwenden.

Beispiel