Definition der Variablen-Exportdatei

In diesem Abschnitt finden Sie eine strukturelle Übersicht über die Elemente in einer .NLVR-Variablen-Exportdatei und ihre Eigenschaften. Die Funktion der einzelnen Elemente entnehmen Sie den folgenden Definitionen.

.NLVR-Dateidefinition

<Variables> und <Variable>: Liste aller Abfragevariablen auf dem Etikett, wobei jede einzelne in einem separaten Variable-Element definiert ist. Abfragevariablen sind in der Dateneingabetabelle der Druckmaske aufgelistet. Gibt es keine Abfragevariablen auf dem Etikett, ist das Element Variables leer.

Name: Variablenname.
Beschreibung: Beschreibung der Variablen.
Datentyp legt fest, welche Arten von Daten in einer Variablen gespeichert werden.
Anfänglicher Wert: Startwert, der einer Variablen bei Erstellung zugewiesen wird.
Anfänglicher Wert: Startwert, der einer Variablen bei Erstellung zugewiesen wird.
Vorläufiger Wert legt beim Gestalten von Etiketten oder Masken einen benutzerdefinierten Platzhalter-Variablenwert in einem Objekt fest.
IsProvisionalValueAutoGenerated: vorläufiger Wert wird automatisch von der Anwendung erzeugt.
IncrementType: Angabe, ob die Variable als Zähler definiert ist, und falls ja, welche Art von Zähler sie ist.
IncrementStep: Informationen über den Zählerschritt. Der Zählerwert nimmt gemäß diesem Wert beim nächsten Etikett zu/ab.
IncrementCount: Informationen dazu, wann der Zählerwert erhöht/verringert werden soll. Für gewöhnlich ändert sich der Zählerwert bei jedem Etikett, aber dies kann geändert werden.
Format: Art von Inhalt (Zeichen), der von der Variable akzeptiert wird.
IsPrompted: legt fest, ob die Variable zu einem Druckzeitpunkt abgefragt wird oder nicht.
PromptText: Text, der dem Druckanwender zum Druckzeitpunkt angezeigt wird.
IsValueRequired: legt fest, ob der Variablenwert festgelegt werden soll oder nicht.
IsDynamicValue: Angabe, ob der Wert dynamisch festgelegt wird.
PrinterCounterType: legt fest, ob der Zählertyp aktiviert wird.
AllowedCharactersForCustomFormat: legt fest, ob es ein bestimmtes erlaubtes Zeichenformat für die Variable gibt.
Length: maximale Anzahl von Zeichen, die eine Variable enthalten kann.
MinLength: Mindestanzahl von Zeichen, die eine Variable enthalten kann.
IsFixedLength: Die Variable muss exakt die vorgegebene Anzahl von Zeichen enthalten.
HasMinimumValue: legt fest, ob für die Variable ein minimaler Wert eingestellt ist.
MinimumValue: Mindest-Variablenwert.
HasMaximumValue: legt fest, ob für die Variable ein maximaler Wert eingestellt ist.
MaximumValue: Maximaler Variablenwert.
InputFormat: erlaubtes Format für den Eingabewert.
OutputFormat: erlaubtes Format für den Ausgabewert.
OutputLanguage: Sprachauswahl und regionale Formatierung des Variablenwerts.
InputFormatDecimalDelimiter: Dateneingabeformat des Zeichens, das in der Dezimalschreibweise den Ganzzahlbereich einer Zahl von ihrem Bruchteil trennt.
InputFormatDecimalPlaces: Dateneingabedefinition für eine Anzahl von Dezimalstellen, die in den Variablenwert aufgenommen werden sollen.
InputFormatDecimalSeparator: Dateneingabeformat des Trennzeichens, das die Tausender in Gruppen unterteilt.
InputFormatCurrencySymbol: Dateneingabesymbol, das die ausgewählte Währung anzeigt.
InputFormatCurrencySymbolPosition: legt die Eingabeposition des Währungssymbols fest.
OutputFormatDecimalDelimiter: Anzahl von Dezimalstellen, die auf dem gedruckten Etikett in den Variablenwert aufgenommen werden sollen.
OutputFormatDecimalPlaces: Anzahl von Dezimalstellen, die auf dem gedruckten Etikett in den Variablenwert aufgenommen werden sollen.
OutputFormatDecimalSeparator: Trennzeichen, das die Tausender auf dem gedruckten Etikett in Gruppen unterteilt.
OutputFormatCurrencySymbol: ein Symbol, das die ausgewählte Währung auf dem gedruckten Etikett anzeigt.
OutputFormatCurrencySymbolPosition: gibt die Position des Währungssymbols auf dem gedruckten Etikett an.
HasPickList: legt fest, ob die Auswahlliste aktiviert ist oder nicht.
PickListValues: die Reihe von Auswahllisten-Werten.
HasRolloverOnMinimumMaximumValue: legt fest, ob der Zähler nach Erreichen des Minimal- oder Maximalwerts zurückgesetzt wird.
Prefix: Präfixwert, der der Variablen hinzugefügt wird.
Suffix: Suffixwert, der der Variablen hinzugefügt wird.
PaddingType: legt fest, ob der Variablen Textabstandszeichen hinzugefügt werden oder nicht.
PaddingValue: Textabstandszeichen.
HasMultilineEnabled: teilt Text in mehrere Zeilen auf.
MultilineNumberOfLines: maximale Anzahl von Zeilen für einen Variablenwert.
MultilineLineLength: maximale Anzahl von Zeichen in einer einzigen Zeile.
HasMultilineWordWrap: bricht den Text bei Leerzeichen in mehrere Zeilen um.

Anmerkung

Alle Abmessungswerte sind als 1/1000 mm angegeben.

XML-Schema (XSD) für Etikettenspezifikationen im XML-Format

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Variables">
    <xs:complexType>
      <xs:sequence minOccurs="0" maxOccurs="unbounded">
        <xs:element name="Variable" minOccurs="0">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"></xs:element>
              <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element name="Description" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="DataType" minOccurs="0">
                  <xs:simpleType>
                    <xs:restriction base="xs:integer">
                      <!--0 -Text variable type.-->
                      <xs:enumeration value="0"/>
                      <!--1 -Date variable type.-->
                      <xs:enumeration value="1"/>
                      <!--2 -Time variable type.-->
                      <xs:enumeration value="2"/>
                      <!--3 -Floating point variable type.-->
                      <xs:enumeration value="3"/>
                      <!--4 -Currency variable type.-->
                      <xs:enumeration value="4"/>
                      <!--1 -Current date variable type.-->
                      <xs:enumeration value="5"/>
                      <!--2 -Current time variable type.-->
                      <xs:enumeration value="6"/>
                    </xs:restriction>
                  </xs:simpleType>
                </xs:element>
                <xs:element name="InitialValue" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="ProvisionalValue" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="IsProvisionalValueAutoGenerated" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="IncrementType" minOccurs="0">
                  <xs:simpleType>
                    <xs:restriction base="xs:integer">
                      <!--0 -None of the types used.-->
                      <xs:enumeration value="0"/>
                      <!--1 -Incremental type.-->
                      <xs:enumeration value="1"/>
                      <!--2 -Decremental type.-->
                      <xs:enumeration value="2"/>
                    </xs:restriction>
                  </xs:simpleType>
                </xs:element>
                <xs:element name="IncrementStep" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="IncrementCount" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="Format" minOccurs="0">
                  <xs:simpleType>
                    <xs:restriction base="xs:integer">
                      <!--0 -All characters are allowed.-->
                      <xs:enumeration value="0"/>
                      <!--1 -Numeric characters are allowed.-->
                      <xs:enumeration value="1"/>
                      <!--2 -Alphanumeric characters are allowed.-->
                      <xs:enumeration value="2"/>
                      <!--3 -Letters characters are allowed.-->
                      <xs:enumeration value="3"/>
                      <!--4 -7 bit ASCI characters are allowed.-->
                      <xs:enumeration value="4"/>
                      <!--5 -Hex characters are allowed.-->
                      <xs:enumeration value="5"/>
                      <!--7 -Digits & capitals characters are allowed.-->
                      <xs:enumeration value="7"/>
                      <!--8 -Custom characters are allowed.-->
                      <xs:enumeration value="8"/>
                      <!--9 -Code 39 characters are allowed.-->
                      <xs:enumeration value="9"/>
                      <!--10 -Code 128A characters are allowed.-->
                      <xs:enumeration value="10"/>
                      <!--11 -Code 128B characters are allowed.-->
                      <xs:enumeration value="11"/>
                      <!--12 -Code 128C characters are allowed.-->
                      <xs:enumeration value="12"/>
                      <!--13 -Code 128 characters are allowed.-->
                      <xs:enumeration value="13"/>
                      <!--14 -Codabar characters are allowed.-->
                      <xs:enumeration value="14"/>
                    </xs:restriction>
                  </xs:simpleType>
                </xs:element>
                <xs:element name="IsPrompted" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="PromptText" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="IsValueRequired" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="IsDynamicValue" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="PrinterCounterType" minOccurs="0">
                  <xs:simpleType>
                    <xs:restriction base="xs:integer">
                      <!--0 -Printer counter unknown.-->
                      <xs:enumeration value="0"/>
                      <!--1 -Do not use printer counter.-->
                      <xs:enumeration value="1"/>
                      <!--2 -Always use printer count.-->
                      <xs:enumeration value="2"/>
                      <!--3 -Use printer counter if possible.-->
                      <xs:enumeration value="3"/>
                    </xs:restriction>
                  </xs:simpleType>
                </xs:element>
                <xs:element name="AllowedCharactersForCustomFormat" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="Length" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="MinLength" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="IsFixedLength" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="HasMinimumValue" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="MinimumValue" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="HasMaximumValue" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="MaximumValue" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="InputFormat" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="OutputFormat" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="OutputLanguage" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="InputFormatDecimalDelimiter" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="InputFormatDecimalPlaces" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="InputFormatDecimalSeparator" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="InputFormatCurrencySymbol" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="InputFormatCurrencySymbolPosition" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="OutputFormatDecimalDelimiter" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="OutputFormatDecimalPlaces" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="OutputFormatDecimalSeparator" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="OutputFormatCurrencySymbol" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="OutputFormatCurrencySymbolPosition" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="HasPickList" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="PickListValues" minOccurs="0">
                  <xs:complexType>
                    <xs:sequence minOccurs="0" maxOccurs="unbounded">
                      <xs:element name="Value" type="xs:string" minOccurs="0"></xs:element>
                    </xs:sequence>
                  </xs:complexType>
                </xs:element>
                <xs:element name="HasRolloverOnMinimumMaximumValue" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="Prefix" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="Suffix" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="PaddingType" minOccurs="0">
                  <xs:simpleType>
                    <xs:restriction base="xs:integer">
                      <!--0 -Padding not used.-->
                      <xs:enumeration value="0"/>
                      <!--1 -Padding on left.-->
                      <xs:enumeration value="1"/>
                      <!--2 -Padding on right.-->
                      <xs:enumeration value="2"/>
                      <!--3 -Padding surrounding-->
                      <xs:enumeration value="3"/>
                    </xs:restriction>
                  </xs:simpleType>
                </xs:element>
                <xs:element name="PaddingValue" type="xs:string" minOccurs="0"></xs:element>
                <xs:element name="HasMultilineEnabled" type="xs:boolean" minOccurs="0"></xs:element>
                <xs:element name="MultilineNumberOfLines" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="MultilineLineLength" type="xs:integer" minOccurs="0"></xs:element>
                <xs:element name="HasMultilineWordWrap" type="xs:boolean" minOccurs="0"></xs:element>
              </xs:choice>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Anmerkung

Das XML-Schema (XSD) für Etikettenspezifikationen im XML-Format ist standardmäßig verfügbar unter: c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\Configuration\Variables.xsd.

.NLVR Beispieldatei

Variables>
  <Variable>
    <Name>Sample variable</Name>
    <Description>Describes the variable</Description>
    <DataType>0</DataType>
    <InitialValue>1</InitialValue>
    <ProvisionalValue>1</ProvisionalValue>
    <IsProvisionalValueAutoGenerated>1</IsProvisionalValueAutoGenerated>
    <IncrementType>0</IncrementType>
    <IncrementStep>1</IncrementStep>
    <IncrementCount>1</IncrementCount>
    <Format>0</Format>
    <IsPrompted>1</IsPrompted>
    <PromptText>Enter the required value.</PromptText>
    <IsValueRequired>1</IsValueRequired>
    <IsDynamicValue>0</IsDynamicValue>
    <PrinterCounterType>3</PrinterCounterType>
    <AllowedCharactersForCustomFormat />
    <Length>20</Length>
    <MinLength>0</MinLength>
    <IsFixedLength>0</IsFixedLength>
    <HasMinimumValue>0</HasMinimumValue>
    <MinimumValue />
    <HasMaximumValue>0</HasMaximumValue>
    <MaximumValue />
    <HasPickList>1</HasPickList>
    <PickListValues>
      <Value>1</Value>
      <Value>2</Value>
      <Value>3</Value>
    </PickListValues>
    <HasRolloverOnMinimumMaximumValue>0</HasRolloverOnMinimumMaximumValue>
    <Prefix>pre</Prefix>
    <Suffix>post</Suffix>
    <PaddingType>1</PaddingType>
    <PaddingValue>_</PaddingValue>
  </Variable>
</Variables>