变量导出文件定义

本节提供了 .NLVR 变量导出文件中的元素及其属性的结构概览。要了解各个元素的作用，请参阅下面的定义。

.NLVR 文件定义

<Variables> 和 <Variable>：所有提示标签变量的列表，每个变量在单独的 Variable 元素中定义。打印表单的数据输入表中列出了提示变量。如果未在标签中定义任何提示变量，则元素 Variables 为空。

Name：变量名称。
Description：变量说明。
数据类型设定在变量中存储的是哪种类型的数据。
初始值：创建变量时分配的起始值。
初始值：创建变量时分配的起始值。
临时值在设计标签或表单时，定义对象中的自定义占位符变量值。
IsProvisionalValueAutoGenerated：临时值由应用程序自动生成。
IncrementType：有关变量是否定义为计数器以及（如果是）计数器是哪种类型的信息。
IncrementStep：有关计数器间隔的信息。计数器值根据此值在下一个标签上递增/递减。
IncrementCount：有关计数器值递增/递减点的信息。通常，计算器在每个标签上更改其值，但可对此进行更改。
Format：变量可接受的内容（字符）类型。
IsPrompted：定义是否在打印时提示变量。
PromptText：在打印时向打印操作员显示的文本。
IsValueRequired：定义是否应定义变量值。
IsDynamicValue：有关是否动态定义值的信息。
PrinterCounterType：定义计数器类型（如果启用）。
AllowedCharactersForCustomFormat：定义是否允许变量使用特定的字符格式。
Length：变量可以包含的最大字符数。
MinLength：变量可以包含的最小字符数。
IsFixedLength：变量必须准确包含给定的字符数。
HasMinimumValue：定义是否为变量设置最小值。
MinimumValue：最小变量值。
HasMaximumValue：定义是否为变量设置最大值。
MaximumValue：最大变量值。
InputFormat：允许的输入值格式。
OutputFormat：允许的输出值格式。
OutputLanguage：语言选择和区域变量值格式设置。
InputFormatDecimalDelimiter：用于分隔小数格式数字的整数部分和小数部分的数据输入格式。
InputFormatDecimalPlaces：要包含在变量值中的小数位数的数据输入定义。
InputFormatDecimalSeparator：千位分隔符（字符）的数据输入格式。
InputFormatCurrencySymbol：表示选定货币的数据输入符号。
InputFormatCurrencySymbolPosition：指定货币符号的数据输入位置。
OutputFormatDecimalDelimiter：要包含在打印标签上的变量值中的小数位数。
OutputFormatDecimalPlaces：要包含在打印标签上的变量值中的小数位数。
OutputFormatDecimalSeparator：打印标签上的千位分隔符（字符）。
OutputFormatCurrencySymbol：表示打印标签上的选定货币的符号。
OutputFormatCurrencySymbolPosition：指定打印标签上的货币符号位置。
HasPickList：定义是否启用挑选列表。
PickListValues：挑选列表值的选择。
HasRolloverOnMinimumMaximumValue：定义是否在达到最小值或最大值后重置计数器。
Prefix：添加到变量的前缀值。
Suffix：添加到变量的后缀值。
PaddingType：定义变量是否已添加填充字符。
PaddingValue：填充字符。
HasMultilineEnabled：将文本分为多行。
MultilineNumberOfLines：变量值的最大行数。
MultilineLineLength：单行中的最大字符数。
HasMultilineWordWrap：在空格字符位置将文本分为多行

注意

所有测量值以 1/1000 mm 为单位表示。

标签规范 XML 的 XML 架构定义 (XSD)

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

注意

默认情况下，可从以下位置访问标签规范 XML 的 XML 架构定义 (XSD): c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\Configuration\Variables.xsd.

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