Definizione del file di esportazione delle variabili

Questa sezione fornisce una panoramica strutturale sugli elementi e i relativi attributi in un file di esportazione delle variabili .NLVR. Per comprendere il ruolo dei singoli elementi, vedere le relative descrizioni qui di seguito.

Definizione del file .NLVR

<Variables> e <Variable>: elenco di tutte le variabili dell'etichetta di richiesta, definite in un elemento Variable separato. Le variabili di richiesta sono elencate nella tabella di immissione dei dati del modulo di stampa. Se nell'etichetta non sono definite variabili di richiesta, l'elemento Variables è vuoto.

Nome: nome della variabile.
Descrizione: descrizione della variabile.
Tipo di dati: definisce quale tipo di dati è memorizzato in una variabile.
Valore iniziale: valore di partenza assegnato a una variabile al momento della sua creazione.
Valore iniziale: valore di partenza assegnato a una variabile al momento della sua creazione.
Valore provvisorio: definisce un valore di variabile segnaposto in un oggetto durante la progettazione di etichette o moduli.
IsProvisionalValueAutoGenerated: il valore provvisorio viene generato automaticamente dall'applicazione.
IncrementType: informazioni, se la variabile è definita come contatore e, se lo è, indica di che tipo si tratta.
IncrementStep: informazioni sul passo del contatore. Il valore del contatore aumenta/diminuisce usando questo valore sull'etichetta successiva.
IncrementCount: informazioni sul punto di incremento/decremento del valore del contatore. Di solito, il contatore cambia valore su ciascuna etichetta, ma, esso può essere modificato.
Format: tipo di contenuto (caratteri) che possono essere accettati dalla variabile.
IsPrompted: definisce che la variabile sia richiesta o meno al momento della stampa.
PromptText: testo che viene visualizzato per l'addetto alla stampa al momento della stampa.
IsValueRequired: definisce se il valore della variabile deve essere definito o meno.
IsDynamicValue: definisce se il valore è definito dinamicamente.
PrinterCounterType: definisce se il tipo di contatore deve essere attivato.
AllowedCharactersForCustomFormat: definisce è presente un formato di carattere specifico consentito per la variabile.
Lenght: numero massimo di caratteri che una variabile può contenere.
MinLength: numero minimo di caratteri che una variabile può contenere.
IsFixedLength: la variabile deve contenere il numero di caratteri esatto dato.
HasMinimumValue: definisce se il valore minimo è impostato per la variabile.
MinimumValue: valore minimo della variabile.
HasMaximumValue: definisce se per la variabile è impostato il valore massimo.
MaximumValue: valore massimo della variabile.
InputFormat: formato del valore di input consentito.
OutputFormat: formato del valore di output consentito.
OutputLanguage: selezione della lingua e formattazione del valore della variabile internazionale.
InputFormatDecimalDelimiter: il formato di input dei dati del carattere che separa la parte intera dalla parte frazionaria di un numero scritto in formato decimale.
InputFormatDecimalPlaces: definizione di input dei dati per il numero di posizioni decimali da includere nel valore della variabile.
InputFormatDecimalSeparator: formato di input dei dati del separatore (carattere) che raggruppa le migliaia in gruppi.
InputFormatCurrencySymbol: simbolo di input dei dati che rappresenta la valuta selezionata.
InputFormatCurrencySymbolPosition: specifica la posizione di input dei dati del simbolo di valuta.
OutputFormatDecimalDelimiter: numero di posizioni decimali da includere nel valore di variabile sull'etichetta stampata.
OutputFormatDecimalPlaces: numero di posizioni decimali da includere nel valore di variabile sull'etichetta stampata.
OutputFormatDecimalSeparator: separatore (carattere) che raggruppa le migliaia di gruppi sull'etichetta stampata.
OutputFormatCurrencySymbol: simbolo che rappresenta la valuta selezionata sull'etichetta stampata.
OutputFormatCurrencySymbolPosition: specifica la posizione del simbolo di valuta sull'etichetta stampata.
HasPickList: definisce se la lista prelievi è attivata o meno.
PickListValues: la selezione dei valori della lista prelievi.
HasRolloverOnMinimumMaximumValue: definisce se il contatore viene ripristinato dopo che è stato raggiunto il valore minimo o massimo.
Prefix: il valore del prefisso che viene aggiunto alla variabile.
Suffix: il valore del suffisso che viene aggiunto alla variabile.
PaddingType: definisce se alla variabile vengono aggiunti o meno dei caratteri di riempimento.
PaddingValue: carattere di riempimento.
HasMultilineEnabled: divide il testo in più righe.
MultilineNumberOfLines: numero massimo di righe per un valore di variabile.
MultilineLineLength: numero massimo di caratteri in una singola riga.
HasMultilineWordWrap: divide il testo in più righe nelle posizioni dei caratteri spazio

Nota

Tutti i valori di misurazione sono espressi in unità 1/1000 mm.

Definizione dello schema XML (XSD) per l'XML della specifica dell'etichetta

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

Nota

La definizione dello schema XML (XSD) per l'XML della specifica dell'etichetta è disponibile, per impostazione predefinita, in: c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\Configuration\Variables.xsd.

Esempio di file .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>