Définition du fichier d'exportation des variables

Cette section présente la structure des éléments et leurs caractéristiques dans le fichier en .NLVR d'exportation des variables. Pour comprendre le rôle de chaque élément, voir leur définition ci-dessous.

Définition du fichier .NLVR

<Variables> et <Variable> : L'élément Variables contient la liste des variables saisies de l'étiquettes, chacune étant définie dans un élément Variable distinct. Les variables saisies sont listées dans la table des saisies de données du formulaire d'impression. S'il n'y a pas de variable saisie dans l'étiquette, l'élément Variables est vide.

Nom: Contient le nom de la variable.
Description: Contient la description de la variable.
Le Type de données définit le type de données enregistré dans la variable.
Valeur initiale: Valeur de départ assignée à la variable lors de sa création.
Valeur initiale: Valeur de départ assignée à la variable lors de sa création.
Valeur provisoire définit une valeur variable dans un espace personnalisé d'un objet lors de la création des étiquettes ou formulaires.
IsProvisionalValueAutoGenerated: L'application génère automatiquement la valeur provisoire.
IncrementType: Dit si la variable est définie comme un compteur et, si oui, son type.
IncrementStep: Contient des informations concernant l'incrément du compteur. La valeur du compteur s'incrémente/décrémente de cette valeur sur l'étiquette suivante.
IncrementCount: Contient des informations sur le point de la valeur du compteur qui s'incrémente/décrémente. Généralement, le compteur change de valeur à chaque étiquette, mais cela peut être modifié.
Format: Type de contenu (caractères) qui peuvent être acceptés par la variable.
IsPrompted : Indique si la variable est appelée au moment de l'impression ou non.
PromptText: Texte affiché pour l'opérateur d'impression au moment de l'impression.
IsValueRequired: Définit si la valeur de la variable doit être définie ou non.
IsDynamicValue: Contient des informations sur la valeur définie dynamiquement.
PrinterCounterType: Définit si le type de compteur est activé.
AllowedCharactersForCustomFormat: Définit si un format de caractères spécifiques est autorisé pour la variable.
Longueur: Nombre maximum de caractères qu'une variable peut contenir.
MinLength: Nombre minimum de caractères qu'une variable peut contenir.
IsFixedLength: la variable doit contenir le nombre exact de caractères donnés.
HasMinimumValue: Définit si la valeur minimum est définie pour la variable.
MinimumValue: Valeur de la variable minimum.
HasMaximumValue: Définit si la valeur maximum est définie pour la variable.
MaximumValue: Valeur de la variable maximum.
InputFormat: Format de la valeur d'entrée autorisé.
OutputFormat: Format de la valeur de sortie autorisé.
OutputLanguage: Formattage du choix de la langue et de valeur variable régionale.
InputFormatDecimalDelimiter: Format de la donnée d'entrée du caractère qui va séparer la partie entière de la partie décimale d'un nombre.
InputFormatDecimalPlaces : Définition de la saisie de données pour le nombre d'emplacements décimaux à inclure dans la valeur de la variable.
InputFormatDecimalSeparator: Format de la donnée d'entrée du séparateur (caractère) qui regroupe les milliers.
InputFormatCurrencySymbol: Symbole de la donnée d'entrée qui représente la devise sélectionnée.
InputFormatCurrencySymbolPosition : Spécifie la position de saisie de données du symbole de la devise.
OutputFormatDecimalDelimiter: Nombre d'emplacement décimaux à inclure dans la valeur de la variable sur l'étiquette imprimée.
OutputFormatDecimalPlaces: Nombre d'emplacement décimaux à inclure dans la valeur de la variable sur l'étiquette imprimée.
OutputFormatDecimalSeparator: Séparateur (caractère) qui regroupe les milliers sur l'étiquette imprimée.
OutputFormatCurrencySymbol : Symbole représentant la devise sélectionnée sur l'étiquette imprimée.
OutputFormatCurrencySymbolPosition : Indique la position du symbole de la devise sur l'étiquette imprimée.
HasPickList : Détermine si la liste de choix est activée ou non.
PickListValues: Sélection des valeurs de la liste de choix.
HasRolloverOnMinimumMaximumValue: Définit si le compteur est réinitialisé après avoir atteint la valeur minimum ou maximum.
Préfixe: Valeur du préfixe ajoutée à la variable.
Suffixe: Valeur du suffixe ajoutée à la variable.
PaddingType: Définit si la variable a des caractères de remplissage ou non.
PaddingValue: Caractère de remplissage.
HasMultilineEnabled: Divise le texte en plusieurs lignes.
MultilineNumberOfLines: Nombre maximum de lignes pour la valeur d'une variable.
MultilineLineLength: Nombre maximum de caractères sur une seule ligne.
HasMultilineWordWrap: Effectue les retours à la ligne uniquement sur un espace entre deux mots

Note

Toutes les valeurs de mesures sont exprimées en unités 1/1000 mm.

Définition du Schéma XML (XSD) pour la Spécification XML de l'étiquette

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

Note

Par défaut, la définition du Schéma XML (XSD) pour la Spécification XML de l'étiquette est accessible sur: c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\Configuration\Variables.xsd.

Exemple de fichier .NLVR

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>