变量作为对象、脚本、外部应用程序、打印机和用户输入之间存储和传递数据的容器。使用变量可以让打印的每个标签上的数据都不一样(如计数器、序列号、日期、时间、重量和产品图片)。

要创建具有可变数据的标签,使用 Desktop designer 可以使用变量数据轻松格式化您的标签。

Desktop designer 包含多种类型的变量:

变量键盘输入

变量键盘输入是一种变量,它使每个打印作业的提示字段内容都各不相同。其值需在每次打印前设定。

一般

定义组设定对某个变量而言,哪类输入数据是有效的。

  • 数据类型设定在变量中存储的是哪种类型的数据。

    UUID-48ea9718-eee6-383e-d849-49df42560ac7.png
  • 初始值:创建变量键盘输入时分配的起始值。可以使用以下方法之一来定义:

    • 手动输入固定值。属于任何允许的字符组中的字符都可以。

      提示

      在选择了日期时间数据类型时,如果输入句点 (".") 作为变量的初始值,则显示当前日期或时间。

    • 使用动态值 – 插入数据库字段。从先前添加的数据库中选择数据库字段。在此处阅读有关如何添加数据库的信息。

    • 使用特殊字符

      • 可以使用小于/大于符号手动输入特殊字符,例如 <CR>、<LF> ...

      • 可从下拉列表中选择特殊字符。

    提示

    请确保插入的初始值满足输出规则中为每个数据类型设定的条件。

文本

变量属性

文本数据类型用于存储文字内容的变量。由此,仅允许文本输作为变量输入数据类型。

输入规则

数据组设定允许的数据属性。

  • 允许的字符:定义允许的变量输入字符。

“允许的字符组”一节说明了数据输入过滤中允许的字符组。

  • 限制长度:变量值的最大长度。

  • 固定长度:变量必须准确包含限制长度中定义的字符数。

检查范围组用来输入变量允许的最小值和最大值。设置限制是可选的。

  • 最小值:允许的最低变量值。

  • 最大值:允许的最高变量值。

如果启用,则最小值和最大值不能为空。

输出规则

多行组将文本分为多行。

  • 行数:变量值的最大行数。

  • 行长度:单行中的最大字符数。

脚本定义允许您向打印机流数据定义和添加自定义打印机命令。通常,Desktop designer 处理标签模板并将相应的打印机命令导出至打印机。使用脚本定义,您可以定义额外的命令并将其包含在打印流文件中。

  • 使用脚本可以向打印流文件添加脚本。

此选项适用于高级用户。您的 ZPL 脚本中存在错误,您的标签可能不会正确打印。

日期

日期数据类型存储选定变量中的日期相关的值。日期字段使用各种日期格式来显示日期值。日期值的格式可以从预加载的格式中进行选择,也可自定义以满足特定的本地、监管或行业相关的要求。

输入规则

输入格式组设定了允许的日期格式和显示预览。

  • 输入格式:允许的日期输入格式。

  • 示例值:根据所选的输入格式显示预览。

注意

Desktop designer 支持一系列预先加载的或自定义的日期格式

检查范围组用来输入变量允许的最小值和最大值。设置限制是可选的。

  • 最小值:允许的最低变量值。

  • 最大值:允许的最高变量值。

注意

如果启用,则最小值和最大值不能为空。

输出规则

输出格式设置输出日期格式。

  • 输出格式:日期的显示格式。

  • 输出语言:日期和月份的语言选择和区域格式设置。

    输出语言在日期中包含用文字表示的月份或日期时,就与语言相关。在某些情况下,数据计算也可能受到影响。例如,在美国,新的一周从周日开始,而在欧盟和其他国家,新的一周从周一开始。

  • 示例值:根据所选的输入格式显示日期预览。

前缀和后缀组定义添加到变量值的字符。

  • 前缀:文字放置在变量值前面。

  • 后缀:文字放置在变量值后面。

多行:将文本分为多行。

警告

尽可能避免使用此设置。建议在标签上需要显示多行文本时,使用文本框对象

  • 行数:变量值的最大行数。

  • 行长度:单行中的最大字符数。

  • 自动换行:文本在空格字符位置分为多行。

时间

时间数据类型将时间值存储在变量中。时间字段使用各种时间格式来显示日期值。时间值的格式可以从预加载的格式中进行选择,也可自定义以满足特定的本地、监管或行业相关的要求。

输入规则

输入格式设定了允许的时间格式和显示预览。

  • 输入格式:允许的时间输入格式。

  • 示例值:根据所选的输入格式显示变量预览。

注意

Desktop designer 支持一系列预先加载的或自定义的时间格式

检查范围组用来输入变量允许的最小值和最大值。设置限制是可选的。

  • 最小值:允许的最低变量值。

  • 最大值:允许的最高变量值。

注意

如果启用,则最小值和最大值不能为空。

输出规则

输出格式设定输出时间格式。

  • 输出格式:时间的显示格式。

  • 示例值:根据所选的输入格式显示时间预览。

前缀和后缀组定义添加到变量值的字符。

  • 前缀:文字放置在变量值前面。

  • 后缀:文字放置在变量值后面。

多行组将文本分为多行。

警告

尽可能避免使用此设置。建议在标签上需要显示多行文本时,使用文本框对象

  • 行数:变量值的最大行数。

  • 行长度:单行中的最大字符数。

  • 自动换行:文本在空格字符位置分为多行。

浮点数

浮点数数据类型设定存储在一个变量中的数字值的表示形式设置。此数据类型用来根据区域设置设定数字分组点(分隔符),并在正确的位置放置小数分隔符。

输入规则

输入格式设定允许的输入数字格式。

  • 小数分隔符设定小数格式的数字的整数部分和小数部分的分隔符号。

  • 小数位置:数字中包含的小数位置数。

  • 使用千位分隔符:用于分隔千位的分隔符。

    • 分隔符:用作千位分隔符的字符。

  • 示例值:显示当前数字输入格式的预览。

  • 限制变量长度:限制在一个变量中定义的位数。

    • 长度(字符):允许在一个变量中使用的数字位数。

检查范围设定最小数字值和最大数字值。设定最小值和最大值限制是可选的:

  • 最小值:允许的最小输入数。

    注意

    如果已定义,则将初始值作为最小值。

  • 最大值:设定允许的最大输入数。

输出规则

输出格式组指定首选的输出数字格式。

  • 小数分隔符:小数格式的数字的整数部分和小数部分的分隔符号。

  • 小数位置:数字中包含的小数位置数。

    • 自动:本地系统设置所定义的小数位置。

  • 使用千位分隔符:使用分隔符对千位分隔。

    • 分隔符:用作千位分隔符的字符。

    • 示例值显示当前输出格式的预览。

货币

货币数据类型用于存储货币金额数值的变量。定义各个区域的货币并设置其属性。

输入规则

  • 输入格式组指定允许的输入货币格式。

  • 小数分隔符是小数格式的值的整数部分和小数部分的分隔符号。

  • 小数位置是值被允许包含的小数位置数。

  • 使用千位分隔符使用分隔符对千位分隔。

    • 分隔符:用作千位分隔符的字符。

  • 货币符号是表示一种货币的图形符号。

    • 位置:货币符号的位置。

  • 示例值显示货币输入格式的预览。

  • 限制长度限制在一个变量中定义的位数。

    • 长度(字符):允许在一个变量中使用的数字位数。

检查范围设定货币表示的最小值和最大值。设定最小值和最大值限制是可选的。

  • 最小值:允许的最低输入货币值。

    注意

    如果已定义,则将初始值作为最小值。

  • 最大值:允许的最高输入货币值。

输出规则

输出格式指定首选的输出货币格式。

  • 小数分隔符:小数格式的值的整数部分和小数部分的分隔符号。

  • 小数位置值中包含的小数位置数。

  • 使用千位分隔符:用于分隔千位的分隔符。

    • 分隔符:用作千位分隔符的字符。

  • 货币符号是表示一种货币的图形符号。

  • 位置设定货币符号的位置。从下拉列表中选择。

  • 示例值显示货币输入格式的预览。

当前日期

当前日期是一个显示当前日期值的变量类型。该值是从系统或打印机时钟获取的。

常规选项卡

关于组标识变量并定义日期输出格式和语言。

  • 名称:唯一的变量名称。

  • 说明:是一个用来添加额外的信息和建议的字段。

定义组设置输出格式并显示其预览。

  • 输出格式:日期的显示格式。此处列出了可用的日期格式。

    注意

    选定的时钟源选项(请参阅下文)定义允许的日期格式范围。打印机时钟选项仅允许使用的打印机支持的日期格式。如果使用非有效格式,则会返回错误。计算机(系统)时钟选项允许一系列预先加载的或自定义的日期格式

  • 输出语言:日期和月份的语言选择和区域格式设置。

例 12. 示例

输出语言在日期中包含用文字表示的月份或日期时,就与语言相关。在某些情况下,数据计算也可能受到影响。例如,在美国,新的一周从周日开始,而在欧盟,新的一周从周一开始。


  • 输出预览:显示打印的当前日期。使用字符的范围与所选的输出语言和打印机相适应。

日期偏移组用来在当前日期基础上添加一定数量的天数、月数或年数。偏移日期显示在对象中,而不是当前日期。

  • 天:以天数偏移日期。

  • 月:以月数偏移日期。

  • 年:以年数偏移日期。

打印机时钟组设定哪个时钟应作为日期值来源。

  • 总是使用计算机时钟:计算机(系统)时钟设置为唯一的当前日期值来源。

  • 总是使用打印机时钟:打印机时钟设置为唯一的当前日期值来源。如果打印机时钟不可用,则会返回错误。

  • 如果支持,则使用打印机时钟:打印机时钟设置为首选的当前日期值来源。如果该打印机时钟不支持,则使用计算机(系统)时钟值。

输出规则

前缀和后缀值在必要时可添加到变量值。

  • 前缀:文字放置在变量值前面。

  • 后缀:文字放置在变量值后面。

日期格式

Desktop designer 可以灵活使用日期字段。定义格式时,使用下列符号:

符号

说明

d

一个月中的日数。占一个或两个字符。

dd

一个月中的日数。始终占两个字符 - 必要时前面加零。

M

M 是月数。占一个或两个字符。

MM

MM 是月数。始终占用两个字符。

yy 或 yyyy

用 2 或 4 位数字代表年份。

ddd

一周中某一天的缩写名称。

dddd

一周中某一天的全称。

MMM

月份简称。

MMMM

月份全名。

J

自 1 月 1 日起的天数。占一个到三个字符。

JJJ

自 1 月 1 日起的天数。始终占用三个字符。

W

当前年度中的周数。占一个或两个字符。

WW

当前年度中的周数。始终占用两个字符。

N

工作日序数。值的范围为 1 - 7 字符,其中 1 代表星期一,7 代表星期日。

自定义文本

任何字符序列的显示不变。插入点、逗号和其他字符来显示当前日期。

日期格式示例

格式

打印的日期(英语)

d.M.yyyy

10.3.2016

dd/MM/yy

10/03/16

dddd, d.MMMM yyyy

Thursday, 10.March 2016

JJJWWyyyy

069102005

textd/M/yyyytext

text10/3/2016text

当前时间

当前时间是一个显示当前时间值的变量类型。该值是从系统或打印机时钟获取的。

常规选项卡

关于组设置标识变量并设定时间输出格式和语言。

  • 名称:唯一的变量名称。此名称在其使用过程中用作变量引用。

  • 说明:是一个用来添加额外的信息和建议的字段。

定义组设置输出格式并显示其预览。

  • 输出格式:时间的显示格式。此处列出了可用的时间格式。

    注意

    选定的时钟来源选项设定了支持的时间格式范围。打印机时钟选项仅允许使用的打印机支持的时间格式。如果使用非有效格式,则会返回错误。计算机(系统)时钟选项允许一系列预先加载的和自定义的时间格式

  • 输出预览:显示打印的当前时间格式。

时间偏移组启用在当前时间基础上添加或减去一定数量的秒数、分钟数或小时数。

  • 秒:以秒为单位偏移时间。

  • 分:以分钟为单位偏移时间。

  • 时:以小时为单位偏移时间。

打印机时钟组设定哪个时钟应作为时间值来源。

  • 如果支持,则使用打印机时钟:打印机时钟设置为首选的当前时间值来源。如果该打印机时钟不支持,则使用系统时钟值。

  • 总是使用打印机时钟:打印机时钟设置为唯一的当前时间值来源。如果打印机时钟不可用,则会返回错误。

  • 总是使用计算机时钟:计算机(系统)时钟设置为唯一的当前时间值来源。

输出规则

前缀和后缀值在必要时可添加到变量值。

  • 前缀:文字放置在变量值前面。

  • 后缀:文字放置在变量值后面。

时间格式

Desktop designer 可以灵活使用时间字段。选择一个预定义时间格式,或者创建一个自定义时间格式。定义格式时,使用下列符号。

符号

说明

h

12 小时格式小时。可选择添加 AM/PM。占一个或两个字符。

hh

12 小时格式小时。可选择添加 AM/PM。始终占用两个字符。必要时前面添加零。

H

24 小时格式小时。占一个或两个字符。

HH

24 小时格式小时。始终占用两个字符。

mm

用于分钟。

ss

用于秒。

时间格式示例

格式

打印的日期

h:mm {AM/PM}

8:25PM

H:mm

20:25

hh:mm:ss

08:25:36

计数器

计数器是一种变量,其值随着系统或打印机计数器的值的变化而递增或递减。

热敏打印机通常配有一个内部的递增计数器。这是一个专用的计数器,用于对打印的标签进行内部计数。打印机只接收第一个值,在后续标签时自动增大或减小。由于仅需将初始值发送到打印机,此选项可减少计算机与打印机之间的数据传输量。内部计数器可显著加快标签生产速度。

常规选项卡

关于组设置标识变量并设定序列化的详细信息。

  • 名称:唯一的变量名称。此名称用作变量引用。

  • 说明:是一个用来添加额外的信息和建议的字段。

序列化组设置定义计数器行为。

  • 计数器类型:计数器值增加或减少。

    • 增量:值随打印的标签而增加。

    • 减量:变量值随打印的标签而减少。

  • 间隔:代表下一个计数器状态值的单位的量。

  • 重复:每个计数器值的重复数。

  • 初始值:计数器启动时使用的值。

  • 预览:显示当前间隔、重复和初始值所设定的计数器值序列。

例 13. 示例

计数器间隔 = 3,重复 = 3,初始值 = 1,则为:1, 1, 1, 4, 4, 4, 7, 7, 7, 10, 10, 10, 13, 13, 13, ...


提示组设置定义数据源的打印时间行为。请在这里阅读关于提示的更多信息。

打印机计数器设定哪个计数器应作为计数器变量值来源。

  • 如果支持,则使用打印机计数器:如果活动的打印机支持,则将打印机计数器设置为所选计数器。如果该打印机计数器不支持,则使用系统计数器。

  • 总是使用打印机计数器:打印机计数器设置为独占计数器值来源。如果打印机计数器值不可用,则使用默认值(系统计数器)。

    注意

    如果选定打印机不支持内部打印机计数器,则会报告错误。打印无法继续。

  • 总是使用计算机计数器:计算机计数器设置为唯一计数器值来源。

要使用内部打印机计数器,请遵循以下规则:

  • 变量的最大长度受限于打印机。该值应包含在打印机用户指南中。

    提示

    如果没有准确的最大的变量长度值,NiceLabel 建议进行几次测试打印以确定该值。

  • 将变量长度设置为固定。

  • 将变量格式设置为数字。

  • 链接到该变量的文本对象必须使用内部打印机字体格式。

  • 启用始终使用打印机计数器选项。

  • 确保计数器文本旁边的内部元素图标可见。

  • 确保计数器文本用的是内部打印机字体。

输入规则

数据设定计数器的输入的条件。

  • 允许的字符:变量值允许的字符。数据输入筛选中允许的字符组见允许的字符组。

    例 14. 示例

    非数字字符也可以用作计数器值。字母数字设置序列间隔 = 3,初始值 = 1,则为 1, 4, 7, A, D, G, J, M, P, S, V, Y, b, e, h, ...


  • 限制长度:变量值的最大长度。

    • 长度(字符):指定的准确的允许字符数。

  • 固定长度:变量必须准确包含限制变量长度中设定的字符数。

检查范围组设定计数器值的最小值和最大值。

  • 最小值:最小的计数器值。

  • 最大值:最大的计数器值。

重新计数设置组设定计数器重置其值为默认值的条件。

  • 使用最小/最大值:最小和最大计数器值激活重新计数。

  • 当所选的数据源更改时:数据源值更改激活重新计数。

  • 当日期或时间更改时:日期或时间值更改激活重新计数。

    注意

    日期/时间更改由计算机时钟定义。

输出规则

提示

使用连接的动态数据源设计标签时,在打印之前要分配值。提示的变量是在打印时手动分配值。每个打印作业开始前,会询问用户每个变量的值。

手动输入值。可以使用提示顺序对话来指定输入的顺序。

提示组要求用户手动数据输入 - 在打印对话框打开后输入。

  • 打印时提示:启用或禁用提示表单变量值。

    注意

    如果初始值中包含动态数据源,则提示变为禁用。

  • 提示文本:包含提示用户输入值的文本。此文本指示了在打印之前应输入哪种类型的值。

  • 必需值:变量值状态 - 强制或可选。如果值的设置为强制的情况下,提示文本为空,则无法启动打印。将显示错误消息。