Typen von Befehlsdateien

Befehlsdateien sind einfache Textdateien, die Anweisungen für den Druckvorgang enthalten – diese Anweisungen werden anhand von NiceLabel Befehlen ausgedrückt. Befehle werden hintereinander ausgeführt, vom Anfang bin zum Ende der Datei.

unterstützt die folgenden Arten von Befehlsdateien:

JOB-Befehlsdateien
XML-Befehlsdateien
CSV-Befehlsdateien
PAS-Befehlsdateien

Anmerkung

Die Dateien unterstützen Unicode-Formatierung Daher können Sie mehrsprachigen Inhalt in sie aufnehmen.

JOB-Befehlsdatei

JOB-Befehlsdateien sind Textdateien mit nativen NiceLabel-Befehlen. Die Befehle werden der Reihe nach von oben nach unten ausgeführt. Die Abfolge der Befehle beginnt normalerweise mit LABEL (Etikett öffnen). Der LABEL-Befehl wird von SET (um de Variablenwert festzulegen) und daraufhin von PRINT (Etikett drucken) gefolgt.

JOB-Befehlsdateien können anhand der folgenden Aktionen ausgeführt werden:

Definition der JOB-Befehlsdatei

NiceLabel-Befehle werden in Befehlsdateien verwendet, um den Etikettendruck zu steuern. Desktop Designer führt die Befehle in Befehlsdateien der Reihenfolge nach von oben nach unten aus.

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 auf ein Semikolon folgt, wird als Kommentar behandelt und nicht verarbeitet.

CLEARVARIABLEVALUES

CLEARVARIABLEVALUES

Dieser Befehl setzt Variablenwerte auf ihre Standardwerte zurück.

CREATEFILE

CREATEFILE <file name> [, <contents>]

Dieser Befehl erstellt eine Textdatei. Sie können ihn verwenden, 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 im NiceLabel Automation Benutzerhandbuch.

DELETEFILE

DELETEFILE <file name>

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 im NiceLabel Automation Benutzerhandbuch.

EXPORTLABEL

EXPORTLABEL ExportFileName [, ExportVariant]

Dieser Befehl wird implementiert, um den Befehl „An Drucker exportieren“ zu automatisieren, der im Etikettendesigner zur Verfügung steht. Das Etikett wird direkt an den Drucker exportiert und zwecks Offline-Druck im Speicher abgelegt. Benutzer können das Etikett per Tastenbefehl am Drucker oder durch Senden einer Befehlsdatei an den Drucker aufrufen. Dieselbe Funktionalität ist auch anhand der Aktion Etikett im Drucker speichern verfügbar.

Anmerkung

Um das zu exportierende Etikett anzugeben, verwenden Sie zuerst den Befehl LABEL.

ExportFileName. Dieser Parameter ist obligatorisch und definiert den Dateinamen von erzeugten Druckerbefehlen.
ExportVariant. Einige Drucker unterstützen mehrere Exportvarianten. Beim manuellen Export können Benutzer die gewünschte Exportvariante im Dialogfeld auswählen. Bei Nutzung des EXPORTLABEL-Befehls müssen Sie angeben, welche Exportvariante Sie verwenden möchten. Die Varianten sind im Etikettendesigner verfügbar, nachdem Sie den Speichern/Abrufen-Druckmodus aktiviert haben.

Die erste Variante in der Liste hat den Wert 0. Die zweite Variante hat den Wert 1 usw.

Falls Sie keine Variante angeben, wird standardmäßig der Wert 0 verwendet.

Weitere Informationen zum Offlinedruck finden Sie unter Speichern/Abrufen-Druckmodus verwenden.

IGNOREERROR

IGNOREERROR <on> [,<off>]

Gibt an, dass die folgenden Fehler in einer JOB-Datei den Druckprozess nicht beenden:

Falscher Variablenname verwendet.
Falscher Wert an Variable gesendet.
Etikett ist nicht vorhanden / Zugriff nicht möglich.
Drucker ist nicht vorhanden / Zugriff nicht möglich.

LABEL

LABEL <label name> [,<printer_name>]

Dieser Befehl öffnet ein zu druckendes Etikett. Ist das Etikett bereits geladen, 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 Thema „Zugriff auf freigegebene Ressourcen im Netzwerk“ im NiceLabel Automation Benutzerhandbuch.

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

MESSAGEBOX <message> [,<caption>]

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.

PORT

PORT <file name> [, APPEND]

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 Thema „Zugriff auf freigegebene Ressourcen im Netzwerk“ im NiceLabel Automation Benutzerhandbuch.

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 einen 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

PRINT <quantity> [,<skip> [,<identical label copies> [,number of label sets]]]

Dieser Befehl startet den Druckprozess.

Quantity. Gibt die Anzahl von zu druckenden Etiketten an.
- <number>. Die angegebene Anzahl von Etiketten wird gedruckt.
- Variable. Gibt an, dass eine Etikettenvariable als variable Menge definiert ist und die Anzahl zu druckender Etiketten enthalten wird. Der Variablenwert bestimmt, wie viele Etiketten gedruckt werden.
- UNLIMITED. Falls Sie eine Datenbank verwenden, um Werte für Objekte zu beziehen, werden bei unbegrenztem Druck so viele Etiketten gedruckt, wie Datensätze in der Datenbank vorhanden sind. Falls Sie keine Datenbank verwenden, wird die maximale vom Thermodrucker unterstützte Anzahl von Etiketten gedruckt.
Skip. Gibt die Anzahl von Etiketten an, die auf der ersten Druckseite übersprungen werden sollen. Dieser Parameter wird beim Etikettendruck auf Papierbögen verwendet. Wenn ein Teil der Seite bereits bedruckt ist, können Sie denselben Bogen erneut verwenden, indem Sie die Startposition des ersten Etiketts verschieben.
Identische Etikettenkopien. Gibt vor, wie viele Kopien desselben Etiketts gedruckt werden sollen.
Anzahl von Etikettensätzen. Gibt an, wie viele Male der gesamte Druckprozess wiederholt werden soll.

Anmerkung

Geben Sie die Mengenwerte als numerische Werte an, nicht als Zeichenfolgen-Werte. Stellen Sie den Wert nicht in Anführungszeichen.

PRINTER

PRINTER <printer name>

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 in der Etikettendesign-Anwendung angezeigt wird. Druckernamen sind normalerweise identisch mit den Druckernamen 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

PRINTJOBNAME

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

SESSIONEND

SESSIONEND

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

Anmerkung

SESSIONEND muss als einziges Element der Aktion „Benutzerdefinierte Befehle senden“ gesendet werden. Wenn Sie zusätzliche Befehle senden möchten, verwenden Sie separate „Benutzerdefinierte Befehle senden“-Aktionen.

SESSIONPRINT

SESSIONPRINT <quantity> [,<skip>]

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 NiceLabel Befehl PRINT. Siehe auch SESSIONSTART.

Quantity. Gibt die Anzahl von zu druckenden Etiketten an.
Skip. Gibt die Anzahl von Etiketten an, die auf der ersten Druckseite übersprungen werden sollen. Dieser Parameter wird beim Etikettendruck auf Papierbögen verwendet. Wenn ein Teil der Seite bereits bedruckt ist, können Sie denselben Bogen erneut verwenden, indem Sie die Startposition des ersten Etiketts verschieben.

SESSIONSTART

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 einzelne Etiketten in separaten Druckaufträgen an den Drucker gesendet. Wenn Sie Etikettendaten für mehrere Etiketten in den Druckdatenstrom integrieren möchten, sollten Sie die Befehle für Sitzungsdruck verwenden. Beginnen Sie mit dem SESSIONSTART-Befehl, gefolgt von einer beliebigen Anzahl von SESSIONPRINT-Befehlen, und verwenden Sie am Ende den SESSIONEND-Befehl.

Nutzen Sie diese Befehle, um den Etikettendruckprozess zu optimieren. Das Drucken von Etiketten über einen einzelnen Druckauftrag geht viel schneller als das Drucken von Etiketten aus mehreren Druckaufträgen.

Sie müssen einige Regeln beachten, damit der Sitzungsdruck nicht fehlschlägt.

Sie können das Etikett innerhalb einer Sitzung nicht ändern.
Sie können den Drucker innerhalb einer Sitzung nicht ändern.
Sie müssen innerhalb einer Sitzung Werte für alle Variablen auf dem Etikett festlegen, selbst wenn einige der Variablen leere Werte haben.

SET

SET <name>=<value> [,<step> [,<number or repetitions>]]

Dieser Befehl weist der Name-Variablen einen 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öhungsschritt für den Zähler sowie die Anzahl von Etiketten vor Änderung des Zählerwerts an.

Falls der 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.

Beispiel 143. Beispiel

Wenn Sie einer Variablen beispielsweise den Wert "c:\My Pictures\raw.jpg" zuweisen, wird "\r" durch das CR-Zeichen ersetzt.

SETPRINTPARAM

SETPRINTPARAM <paramname> = <value>

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

PAPERBIN. Gibt das Fach an, das die Etikettenmedien enthält. Falls der Drucker mit mehr als einem Papier-/Etikettenfach ausgestattet ist, können Sie festlegen, welches für den Druck verwendet werden soll. Der Name des Fachs sollte vom Druckertreiber bezogen werden.
PRINTSPEED. Gibt die Druckgeschwindigkeit an. Die gültigen Werte variieren von Drucker zu Drucker. Im Druckerhandbuch finden Sie den exakten Wertebereich.
PRINTDARKNESS. Legt die Drucktemperatur/den Druckkontrast fest. Die gültigen Werte variieren von Drucker zu Drucker. Im Druckerhandbuch finden Sie den exakten Wertebereich.
PRINTOFFSETX. Legt den linken Versatz für alle Druckobjekte fest. Der Wert für diesen Parameter muss numerisch sein, positiv oder negativ, und die Anzahl von Punkten vorgeben.
PRINTOFFSETY. Legt den oberen Versatz für alle Druckobjekte fest. Der Wert für diesen Parameter muss numerisch sein, positiv oder negativ, und die Anzahl von Punkten vorgeben.
PRINTERSETTINGS: Gibt die benutzerdefinierten Druckereinstellungen an, die auf den Druckauftrag angewandt werden sollen. Der Parameter erfordert die gesamte DEVMODE-Struktur für den Zieldrucker; sie muss in Form einer Base64-codierten Zeichenfolge angegeben werden. Die DEVMODE enthält alle Parameter auf dem Druckertreiber (Geschwindigkeit, Temperatur, Versätze und andere). Weitere Informationen finden Sie im Abschnitt „Informationen zu Druckereinstellungen und DEVMODE“ im NiceLabel Automation Benutzerhandbuch.

Anmerkung

Die Base64-codierte Zeichenfolge muss in Anführungszeichen (") stehen.

TEXTQUALIFIER

TEXTQUALIFIER <character>

Ein Textbegrenzer ist ein Zeichen, das einen Datenwert einschließt, welcher einer Variablen zugewiesen ist. Falls der 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 144. Beispiel

TEXTQUALIFIER % SET Variable = %EPAK 12"X10 7/32"%

Beispiel für eine JOB-Befehlsdatei

Diese JOB-Datei öffnet das Etikett label2.nlbl, legt Variablenwerte fest und druckt ein einzelnes Etikett aus. Da kein PRINTER-Befehl verwendet wird, um den Druck umzuleiten, wird das Etikett auf dem im Etikett angegebenen Drucker gedruckt.

LABEL "label2.nlbl"
SET code="12345"
SET article="FUSILLI"
SET ean="383860026501"
SET weight="1,0 kg"
PRINT 1

XML-Befehlsdatei

Die in XML-Befehlsdateien verfügbaren Befehle sind eine Untermenge der NiceLabel Befehle. Sie können die folgenden Befehle verwenden:

LOGIN
LABEL
SET
PORT
PRINTER
SESSIONSTART
SESSIONEND
SESSIONPRINT

Bei Nutzung in einer XML-Datei ist eine geringfügige Anpassung der Syntax erforderlich.

XML-Befehlsdateien können anhand der folgenden Aktionen ausgeführt werden:

Das Stammelement in einer XML-Datei ist <Nice_Commands>. Als nächstes Element muss <Label> folgen – es gibt an, welches Etikett verwendet werden soll.

Es gibt zwei Methoden, den Etikettendruck zu starten:

Normales Drucken der Etiketten anhand des <Print_Job>-Elements.
Drucken der Etiketten in einer Sitzung anhand des <Session_Print_Job>-Elements.

Sie können außerdem den Drucker ändern, auf dem die Etiketten gedruckt werden, und Sie können den Variablenwert festlegen.

Definition der XML-Befehlsdatei

Dieser Abschnitt definiert die Struktur von XML-Befehlsdateien. Es gibt verschiedene Elemente, die Attribute enthalten. Einige Attribute sind erforderlich, andere sind optional. Einige Attribute können nur vordefinierte Werte enthalten. Für andere können Sie eigene Werte angeben.

<Nice_Commands>. Dies ist ein Stammelement.
<Label>. Gibt die zu öffnende Etikettendatei an. Ist das Etikett bereits geöffnet, wird es nicht erneut geöffnet. Der Zugriff auf die Etikettendatei muss vom verwendeten Computer aus möglich sein. Weitere Informationen finden Sie im Thema „Zugriff auf freigegebene Ressourcen im Netzwerk“ im NiceLabel Automation Benutzerhandbuch. Dieses Element kann innerhalb der Befehlsdatei mehrmals vorhanden sein.
- Name. Dieses Attribut enthält den Etikettennamen. Sie können auch den Pfad zu der Etikettendatei angeben. Obligatorisches Element.
<Print_Job>. Dieses Element enthält Daten für einen Etikettenauftrag. Dieses Element kann innerhalb der Befehlsdatei mehrmals vorhanden sein.
- PRINTER. Verwenden Sie dieses Attribut, um den im Etikett definierten Drucker zu umgehen. Der Zugriff auf den Drucker muss vom verwendeten Computer aus möglich sein. Weitere Informationen finden Sie im Abschnitt „Zugriff auf freigegebene Ressourcen im Netzwerk“. Optionales Element.
- Quantity. Verwenden Sie dieses Attribut, um die Anzahl zu druckender Etiketten festzulegen. Mögliche Werte: numerischer Wert, VARIABLE oder UNLIMITED. Weitere Informationen zu Parametern finden Sie im Abschnitt Etikett drucken. Obligatorisches Element.
- Skip. Verwenden Sie dieses Attribut, um die Anzahl von Etiketten festzulegen, die zu Beginn übersprungen werden sollen. Diese Funktion ist nützlich, wenn Sie Etiketten mit einem Laserdrucker auf Papierbögen drucken, die bereits teilweise bedruckt sind. Weitere Informationen finden Sie im Abschnitt Etikett drucken. Optionales Element.
- Job_name. Verwenden Sie dieses Attribut, um den Namen Ihrer Auftragsdatei festzulegen. Der angegebene Name wird im Druck-Spooler angezeigt. Weitere Informationen finden Sie im Abschnitt Druckauftragsnamen festlegen. Optionales Element.
- Print_to_file. Verwenden Sie dieses Attribut, um den Namen der Datei anzugeben, in der Sie die Druckerbefehle speichern möchten. Weitere Informationen finden Sie im Abschnitt Druck an Datei umleiten. Optionales Element.
- Identical_copies: Verwenden Sie dieses Attribut, um die Anzahl von Kopien festzulegen, die Sie für jedes Etikett benötigen. Weitere Informationen finden Sie im Abschnitt Etikett drucken. Optionales Element.
<Session_Print_Job>. Dieses Element enthält Befehle und Daten für eine oder mehrere Sitzungen. Das Element kann ein oder mehrere <Session>-Elemente enthalten. Es befolgt Regeln für den Sitzungsdruck. Sie können dieses Element mehrmals innerhalb der Befehlsdatei verwenden. Für verfügbare Attribute, siehe Attribute für das Element <Print_Job>. Alle davon sind gültig; Sie können lediglich das Quantity-Attribut nicht verwenden. In der Beschreibung für das Element <Session> erfahren Sie, wie Sie die Etikettenmenge für den Sitzungsdruck angeben können.
Store_job. Verwenden Sie dieses Attribut, um Ihr Etikett auf dem Drucker zu speichern. Weitere Informationen finden Sie im Abschnitt Etikett im Drucker speichern.
- Store_name. Mit diesem Wert speichern Sie Ihr Etikett auf dem Drucker. Optionales Element.
- Store_variant. Speichereinheit, auf der Sie Ihr Etikett speichern (USB-Speicher, SD-Karte, DRAM). Die genauen Namen finden Sie in den Einstellungen Ihres Druckertreibers. Optionales Element.
- Job_name. Verwenden Sie dieses Attribut, um den Namen Ihrer Auftragsdatei festzulegen. Der angegebene Name wird im Druck-Spooler angezeigt. Weitere Informationen finden Sie im Abschnitt Druckauftragsnamen festlegen. Optionales Element.
Anmerkung

Um Etiketten von Ihrem Drucker abzurufen, verwenden Sie die gleichen Elemente wie beim Drucken.

Falls das Element job_name leer ist, wird der Wert des Elements label name verwendet, um das richtige Etikett aus dem Speicher des Druckers abzurufen.
<Session>. Dieses Element enthält Daten für eine einzelne Sitzung. Bei Verwendung des Sitzungsdrucks werden alle Etiketten zu einem einzelnen Druckauftrag codiert und in dieser Form an den Drucker gesendet.
- Quantity. Verwenden Sie dieses Attribut, um die Anzahl zu druckender Etiketten festzulegen. Mögliche Werte: numerischer Wert, Zeichenfolge „VARIABLE“ oder Zeichenfolge „UNLIMITED“. Weitere Informationen zu Parametern finden Sie im Abschnitt Etikett drucken. Erforderlich.
- Skip. Legt die Anzahl von Etiketten fest, die auf der ersten Seite mit Etiketten übersprungen werden sollen. Möglicherweise wurden bereits Etiketten auf den Bogen gedruckt, aber er ist noch nicht vollständig bedruckt. Sie können denselben Bogen erneut verwenden, indem Sie den Versatz für die Startposition angeben. Diese Option ist nützlich, wenn Sie auf Bögen anstelle von Rollen drucken; sie eignet sich also für Bürodrucker, nicht für Etikettendrucker. Mögliche Werte: numerischer Wert oder Zeichenfolge „VARIABLE“. Weitere Informationen zu Parametern finden Sie im Abschnitt Etikett drucken. Optional.
- Identical_copies. Gibt die Anzahl von Kopien an, die für das jeweilige Etikett gedruckt werden. Bei festen Etiketten führt diese Option zum selben Ergebnis wie die Hauptoption Etikettenanzahl. Bei variablen Etiketten, etwa solchen mit Zählern, erhalten Sie echte Etikettenkopien. Mögliche Werte: numerischer Wert oder Zeichenfolge „VARIABLE“. Weitere Informationen zu Parametern finden Sie im Abschnitt Etikett drucken. Optional.
- Etikettensätze. Gibt vor, wie oft der gesamte Etikettendruckvorgang wiederholt werden soll. Mögliche Werte: numerischer Wert oder Zeichenfolge „VARIABLE“. Weitere Informationen zu Parametern finden Sie im Abschnitt Etikett drucken. Optional.
<Variable>. Dieses Element definiert die Werte der Variablen auf dem Etikett. Dieses Element kann innerhalb der Befehlsdatei mehrmals vorhanden sein.
- Name. Dieses Attribut enthält den Namen der Variablen. Erforderlich.

Definition des XML-Schemas (XSD) für XML-Befehlsdateien

<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://tempuri.org/XMLSchema.xsd" elementFormDefault="qualified" xmlns="http://tempuri.org/XMLSchema.xsd" xmlns:mstns="http://tempuri.org/XMLSchema.xsd" xmlns:xs="http://www.w3.org/2001/X
MLSchema">
 <xs:element name="nice_commands">
  <xs:complexType>
   <xs:sequence>
    <xs:element name="label" maxOccurs="unbounded" minOccurs="1">
     <xs:complexType>
      <xs:sequence>
       <xs:element name="print_job" maxOccurs="unbounded" minOccurs="0">
        <xs:complexType>
         <xs:sequence>
          <xs:element name="database" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="table" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="variable" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
         </xs:sequence>
         <xs:attribute name="quantity" type="xs:string" use="required" />
         <xs:attribute name="printer" type="xs:string" use="optional" />
         <xs:attribute name="skip" type="xs:integer" use="optional" />
         <xs:attribute name="identical_copies" type="xs:integer" use="optional" />
         <xs:attribute name="number_of_sets" type="xs:integer" use="optional" />
         <xs:attribute name="job_name" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file_append" type="xs:boolean" use="optional" />
         <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
        </xs:complexType>
       </xs:element>
       <xs:element name="session_print_job" maxOccurs="unbounded" minOccurs="0">
        <xs:complexType>
         <xs:sequence>
          <xs:element name="database" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="table" maxOccurs="unbounded" minOccurs="0">
           <xs:complexType>
            <xs:simpleContent>
             <xs:extension base="xs:string">
              <xs:attribute name="name" type="xs:string" use="required" />
             </xs:extension>
            </xs:simpleContent>
           </xs:complexType>
          </xs:element>
          <xs:element name="session" minOccurs="1" maxOccurs="unbounded">
           <xs:complexType>
            <xs:sequence>
             <xs:element name="variable" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
               <xs:simpleContent>
                <xs:extension base="xs:string">
                 <xs:attribute name="name" type="xs:string" use="required" />
                </xs:extension>
               </xs:simpleContent>
              </xs:complexType>
             </xs:element>
            </xs:sequence>
            <xs:attribute name="quantity" type="xs:string" use="required" />
            <xs:attribute name="skip" type="xs:string" use="optional" />
            <xs:attribute name="identical_copies" type="xs:string" use="optional" />
            <xs:attribute name="number_of_sets" type="xs:string" use="optional" />
           </xs:complexType>
          </xs:element>
         </xs:sequence>
         <xs:attribute name="printer" type="xs:string" use="optional" />
         <xs:attribute name="skip" type="xs:integer" use="optional" />
         <xs:attribute name="job_name" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file" type="xs:string" use="optional" />
         <xs:attribute name="print_to_file_append" type="xs:boolean" use="optional" />
         <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
        </xs:complexType>
       </xs:element>
      </xs:sequence>
      <xs:attribute name="name" type="xs:string" use="required" />
      <xs:attribute name="close" type="xs:boolean" use="optional" />
      <xs:attribute name="clear_variable_values" type="xs:boolean" use="optional" />
     </xs:complexType>
    </xs:element>
   </xs:sequence>
   <xs:attribute name="quit" type="xs:boolean" use="required" />
  </xs:complexType>
 </xs:element>
</xs:schema>

Beispiel für eine XML-Befehlsdatei

Das folgende Beispiel zeigt eine strukturelle Ansicht der Elemente und ihrer Attribute, die Sie in einer XML-Befehlsdatei verwenden können.

<nice_commands>
 <label name="label1.nlbl">
  <session_print_job printer="CAB A3 203DPI" skip=0 job_name="job name 1" print_to_file="filename 1">
   <session quantity="10" skip="2" identical_copies="1" number_of_sets="4">
    <variable name="variable name 1" >variable value 1</variable>
   </session>
  </session_print_job>
  <print_job printer="Zebra R-402" quantity="10" skip=0 identical_copies=1 number_of_sets=1 job_name="job name 2" print_to_file="filename 2">
   <variable name="variable1" >1</variable>
   <variable name="variable2" >2</variable>
   <variable name="variable3" >3</variable>
  </print_job>
 </label>
</nice_commands>

In diesem Beispiel wird ein Etikett auf dem Drucker gespeichert.

<nice_commands>
 <label name="label1.nlbl" close="false">
  <store_job store_name="label011" store_variant= "DRAM" printer="Zebra R-402" job_name="recall011">
   <variable name="country" >Slovenia</variable>
   <variable name="packaging_type" >big box</variable>
   <variable name="Warehouse_no" >3</variable>
  </store_job>
 </label>
</nice_commands>

CSV-Befehlsdatei

Die in CSV-Befehlsdateien verfügbaren Befehle sind eine Untermenge der NiceLabel Befehle. Sie können die folgenden Befehle verwenden: LABEL, SET, PORT, PRINTER und PRINT.

CSV-Befehlsdateien können anhand der folgenden Aktionen ausgeführt werden:

CSV-Befehlsdateien sind Textdateien, deren Werte durch Kommas (,) getrennt werden. Die Textdateien können Unicode-Werte enthalten (wichtig für mehrsprachige Daten). Jede Zeile in der CSV-Befehlsdatei enthält Befehle für eine einzelne Etikettendruckaktion.

Die erste Zeile muss Befehle und Variablennamen enthalten. Die Reihenfolge der Befehle und Namen ist nicht wichtig, aber alle Datensätze im selben Datenstrom müssen dieselbe Struktur aufweisen. Variable Name-Wert-Paare werden automatisch extrahiert und an das Etikett gesendet, das sie referenziert.

Anmerkung

Kein Fehler wird gemeldet, wenn die Variable, deren Name in der CSV-Datei enthalten ist, nicht auf dem Etikett vorhanden ist.

Definition der CSV-Befehlsdatei

Die Befehle in der ersten Datenzeile müssen mit dem at-Zeichen (@) ausgedrückt werden. Die Felder ohne vorangestelltes @ sind Namen von Variablen; sie werden gemeinsam mit ihren Werten als Name-Wert-Paare extrahiert.

@Label. Gibt den zu verwendenden Etikettennamen an. Es empfiehlt sich, den Pfad und Dateinamen des Etiketts anzugeben. Stellen Sie sicher, dass der Dienstbenutzer auf die jeweilige Datei zugreifen kann. Weitere Informationen finden Sie im Thema „Zugriff auf freigegebene Ressourcen im Netzwerk“ im NiceLabel Automation Benutzerhandbuch. Obligatorisches Feld.
@Printer. Gibt den zu verwendenden Drucker an. Der Befehl übergeht den in der Etikettenvorlage definierten Drucker. Stellen Sie sicher, dass der Dienstbenutzer auf den jeweiligen Drucker zugreifen kann. Weitere Informationen finden Sie im Thema „Zugriff auf freigegebene Ressourcen im Netzwerk“ im NiceLabel Automation Benutzerhandbuch. Optionales Feld.
@Quantity. Gibt die Anzahl von zu druckenden Etiketten an. Mögliche Werte: numerischer Wert, VARIABLE oder UNLIMITED. Weitere Informationen finden Sie im entsprechenden Abschnitt des NiceLabel Automation Benutzerhandbuchs. Obligatorisches Feld.
@Skip. Gibt die Anzahl von Etiketten an, die auf der ersten gedruckten Seite übersprungen werden sollen. Diese Funktion ist nützlich, wenn Sie eine teilweise bedruckte Seite erneut verwenden möchten. Optionales Feld.
@IdenticalCopies. Gibt die Anzahl von Kopien an, die für das jeweilige Etikett gedruckt werden sollen. Diese Funktion ist nützlich, wenn Sie Etiketten mit Daten aus einer Datenbank drucken oder wenn Sie Zähler verwenden und Kopien von Etiketten benötigen. Optionales Feld.
@NumberOfSets: Gibt an, wie viele Male der Druckprozess wiederholt werden soll. Der Druckprozess umfasst jeweils ein Etiketten-Set. Optionales Feld.
@Port. Gibt den Namen der Schnittstelle für den Drucker an. So können Sie die im Druckertreiber festgelegte Schnittstelle umgehen. Sie können den Befehl auch nutzen, um den Druck an eine Datei umzuleiten. Optionales Feld.
Andere Feldnamen. Alle anderen Felder definieren die Namen von Variablen auf dem Etikett. Die Inhalte der Felder werden in der Variablen gespeichert, die denselben Namen hat wie ihr Wert.

Beispiel für eine CSV-Befehlsdatei

Das Beispiel zeigt eine strukturelle Übersicht über die Felder an, die Sie in einer CSV-Datei verwenden können.

@Label,@Printer,@Quantity,@Skip,@IdenticalCopies,NumberOfSets,@Port,Product_ID, Product_Name
label1.nlbl, CAB A3 203 DPI, 100, , , , , 100A, Product 1
label2.nlbl, Zebra R-402, 20, , , , , 200A, Product 2

PAS-Befehlsdatei

Die PAS-Befehlsdatei ist eine Textdatei, die Loftware LPS-Druckbefehle enthält. Die Befehle werden der Reihe nach von oben nach unten ausgeführt. Jede PAS-Datei muss mit dem Befehl *FORMAT (open label) beginnen und mit dem Befehl *PRINTLABEL enden.

Die PAS-Befehlsdatei kann mit der Aktion Befehlsdatei ausführen ausgeführt werden.

Anmerkung

Wenn Sie von Loftware zu NiceLabel migriert haben, können Sie Ihre bestehenden PAS Befehlsdateien mit NiceLabel Etikettenvorlagen (.nlbl) verwenden. Der *FORMAT Befehl prüft, ob die .nlbl Datei mit dem gleichen Namen wie .lwl existiert.

Beispiel für eine PAS-Befehlsdatei

*FORMAT,\\127.0.0.1\labelcomputer$\labels\ML2193.lwl
*JOBNAME,PastaPallet002
*QUANTITY,1
*PRINTERNUMBER,1
Text0000,New Data
Text0001,New Data
*PRINTLABEL

Anmerkung

Wenn Sie den Befehl *PRINTERNUMBER verwenden möchten, müssen Sie die Datei printr32.ini von LPS nach c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\Configuration.

Weitere Einzelheiten zu den PAS-Befehlen finden Sie im Loftware LPS-Benutzerhandbuch.