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

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

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

UUID-2817fb16-bf9a-f5f5-5d95-68a4e97a1176.png

提示

动态数据浏览器中管理您的所有标签和解决方案变量。

变量

变量(也称为提示变量)是在打印时获得值的变量类型。

一般

关于组设置标识变量并设定其定义。

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

    注意

    设定变量名称时,避免使用非字母数字字符。

    提示

    输入名称,便于在动态数据浏览器中查找。

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

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

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

    UUID-9e226f5c-c066-f9d3-fec0-e5cf08a23fed.png
  • 初始值:创建变量时分配的起始值。可以使用以下方法之一来定义:

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

      提示

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

      例 24. 示例

      通过将日期选作数据类型,表单中的“编辑”字段会与变量相关联。如果将休止符选作初始值,那么在表单运行时,编辑字段会显示当前日期。下拉按钮将打开带有预选当前日期的“日期”选择器。

      UUID-a7cd8101-e6ae-a1bf-472e-774bb708b9ab.png

    • 使用动态值。支持工具栏的动态数据源 - 有两个选项可用:

      • 在方括号内输入名称作为来源,如 [CurrentDate]、[Counter]。

      • 在方括号内输入名称作为来源。

      • 从下拉列表中选择动态数据源。

    • 使用特殊字符:

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

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

    提示

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

临时值在设计标签或表单时,定义对象中的自定义占位符变量值。在标签对象中,临时值在打印时替换为实际变量值。在表单对象中,运行表单时将显示实际变量值。

  • 自动生成:自动生成临时值。禁用此选项可定义和使用自定义的临时值。

    提示

    默认情况下,临时值等于初始值。

如果临时值(自动生成或自定义)为空或使用无效格式,则根据选定变量数据类型生成。下面列出了临时值的默认格式。

  • 文本数据类型:6 个问号 (??????)

  • 日期数据类型:当前日期或时间

  • 时间数据类型:当前时间

  • 浮点数据类型:9.999.999,99

  • 货币数据类型:9.999.999,99 €

注意

如果变量输出规则发生变化,则相应地调整临时值格式。

文本

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

输入规则

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

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

    提示

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

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

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

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

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

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

注意

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

挑选列表组预定义变量的可选输入值的列表。如果定义了挑选列表,将不能将任何其他值与此变量一起使用。

可在打印表单上选择标签对象的挑选列表值。用户选择一个可用值并打印标签。如果挑选列表用于表单对象,其作用相当于编辑字段对象 – 运行表单时,用户从预定义的值中进行选择。

  • 启用挑选列表:启用此选项可设置有限范围的可选值。

  • 挑选列表值:输入可选值。使用换行符分隔各个值。

输出规则

日期

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

输入规则

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

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

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

注意

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

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

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

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

注意

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

输出规则

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

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

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

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

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

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

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

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

多行:将文本分为多行。

警告

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

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

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

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

时间

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

输入规则

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

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

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

注意

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

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

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

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

注意

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

输出规则

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

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

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

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

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

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

多行组将文本分为多行。

警告

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

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

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

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

浮点数

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

输入规则

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

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

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

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

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

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

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

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

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

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

    注意

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

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

输出规则

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

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

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

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

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

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

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

货币

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

初始值定义

货币数据类型初始值有以下几种定义方法:

  • 手动输入固定值。根据输入格式设置来分隔数字。

  • 使用动态值。支持工具栏的动态数据源 - 有两个选项可用:

    • 在方括号内输入名称作为来源,例如 [Variable_1]。

    • 从下拉列表中选择动态数据源。

  • 使用特殊字符:

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

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

输入规则

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

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

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

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

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

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

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

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

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

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

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

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

    注意

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

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

输出规则

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

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

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

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

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

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

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

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

当前日期

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

常规选项卡

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

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

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

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

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

    注意

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

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

例 29. 示例

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


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

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

  • 天:以天数偏移日期。

  • 月:以月数偏移日期。

  • 年:以年数偏移日期。

提示

要设置负日期偏移,请使用日期偏移函数

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

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

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

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

输出规则

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

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

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

日期格式

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

计数器

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

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

常规选项卡

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

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

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

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

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

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

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

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

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

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

  • 预览:显示计数器值序列。

例 30. 示例

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


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

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

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

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

    注意

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

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

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

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

    提示

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

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

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

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

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

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

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

输入规则

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

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

    例 32. 示例

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


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

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

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

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

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

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

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

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

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

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

    注意

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

输出规则

提示

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

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

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

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

    注意

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

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

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

打印表单变量

打印表单变量是运行打印表单时自动生成的变量,可存储用户定义的默认打印表单对象值。

在以下两种情况下,打印表单变量将添加到解决方案中:

  • 添加新的打印表单时(转到主页选项卡 > 自定义打印 > 添加新表单 > 打印表单)。

  • 编辑打印表单时(转到主页选项卡 > 自定义打印 > 编辑打印表单)。

此处介绍了有关这两个操作的详细信息。

这些变量已列入连接的其他数据源(名为 PrintingForm_[VariableName])。它们全部列在动态数据浏览器中,因此在动态数据管理器中将变为可编辑。

UUID-e13fa436-2d2a-576b-7cd8-bfa65ff44549.png

所有打印表单变量均属于提示变量类型。它们都可以编辑,即:使用自定义的数据类型和输入/输出规则进行重命名和配置。

注意

要与最佳实践建议保持一致,NiceLabel 建议您避免编辑打印表单变量。如果您认为有必要进行编辑,请双击自定义的数据类型,输入/输出规则不会影响标签打印。

注意

如果在使用自定义的打印表单时出现问题,则可通过重新创建打印表单选项恢复默认打印表单。在这种情况下,将放弃所有更改。

打印表单变量与“普通”用户创建的变量存在以下不同之处:

  • 由解决方案中的所有其他打印表单重复使用。

  • 删除后,为解决方案中新添加的任何打印表单重新创建。

Desktop Designer 打印表单变量包括:

  • PrintingForm_IdenticalCopies:存储要打印的相同标签副本数。

  • PrintingForm_LabelName:存储选定标签的名称。此变量告知打印表单将打印解决方案中的哪个标签。

  • PrintingForm_LabelSets:存储要发送到打印机的打印作业数。

  • PrintingForm_PrinterName:存储选定打印机的名称。

  • PrintingForm_PrintToFile:存储标签打印到的文件的名称。

  • PrintingForm_Quantity:存储打印的标签数。

  • PrintingForm_SkippedLabels:存储跳过的标签数。

注意

尽管打印表单上的对象可以连接到任何类型的用户定义数据源,但是 NiceLabel 建议您将对象连接到自动生成的打印表单变量。