XML-Befehlsdatei

Die in XML-Befehlsdateien verfügbaren Befehle sind eine Untermenge der Loftware 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:

• Befehlsdatei ausführen

• Benutzerdefinierte Befehle senden

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 an, welche Etikettendatei geöffnet werden soll. 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 Loftware 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.

  • Drucker. 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.

  • Menge. 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.

  • Überspringen. 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 auf 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.

  Hinweis

  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.

  • Menge. 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.

  • Überspringen. 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.

  • Number_of_sets. 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" >Slowenien</variable>
   <variable name="packaging_type" >big box</variable>
   <variable name="Warehouse_no" >3</variable>
  </store_job>
 </label>
</nice_commands>