博尔杰PTS - 工业标签标识打印整体解决方案
首页 > 技术支持 > BarTender 变量打印出占位符或空白怎么排查

BarTender 变量打印出占位符或空白怎么排查

先说结论:标签上打出 <客户名> 这样的字段名、问号、星号,或者本该有内容的那一段整片空白,绝大多数不是打印机坏了,也不是字体丢了,而是模板里的变量对象没有从数据源取到值。按「变量对象 → 字段映射 → 数据源连接 → 当前记录 → 输出」五层顺序往下查,通常十分钟内就能定位到断在哪一层,不必重画模板,也不必先去调浓度或换打印头。

本文面向 BarTender、Codesoft、NiceLabel、Brady Workstation 这类标签设计软件,配合 Zebra ZT411、TSC TTP-244 Pro 等热转印机型在日常打印中遇到的一类具体问题:变量取值失败。机型名称经 MROer 产品图库核对,具体规格、指令与参数以产品页和随机手册为准。全文解决四件事——打出占位符字面量、个别字段整段空白、打出问号星号或一串井号、以及取到上一张的旧值;并给出与中文乱码、字体缺字、旧版模板误用、日期取错等相邻故障的分界线。文章只讲使用中「怎么设、怎么查」,不涉及软件选型或采购判断。

一、先分清四型现象,排查入口完全不同

同样是「该有字的地方没字」,四类表现指向的层级并不一样,动手前先用一张实物样张把它们分开,能省掉大半返工。

  1. 打出字段名或占位符字面量:标签上出现 <客户名>、{PartNo}、%%FIELD%% 之类的原文字符。说明模板把这个对象当成「静态文字」送去了打印机,变量根本没有被解析,问题在变量对象层或占位符语法。
  2. 个别字段空白,其余字段正常:同一张标签上品名、批次都有值,只有一两项是空的。说明数据源连上了、变量也解析了,断在字段映射或当前记录的这一格——列名对不上、该行是空值,或者被筛选掉了。
  3. 打出问号、星号或一串井号:字段有值但显示成符号。先别急着改数据源,这类多与字段宽度、格式掩码或字符编码有关,要和字体缺字、中文乱码分开看(见第八节)。
  4. 取到上一张的旧值:连续打印时某一项一直沿用前一张的内容。这不是取值失败,而是变量没有按记录递增刷新,或输出侧用了缓存的旧作业,核对顺序与前三型相反。

把样张按这四型归好位,再决定从哪一层开始查。若一张标签上同时出现两型以上,先处理占位符字面量那一型,因为它会掩盖其余现象。

二、五层定位顺序:从模板往数据源走,不要反过来

现场最常见的错误是一上来就重装驱动、重连数据库,结果把本来就对的设置改乱了。正确顺序是从离模板最近的一层往外走,每层只做一次判定,命中即停。

  1. 变量对象层:这个对象是不是真的声明为变量,占位符写法对不对,默认值有没有设。
  2. 字段映射层:变量名绑定的字段名,与数据源里的列名是否逐字一致(含大小写、前后空格、全半角)。
  3. 数据源连接层:文件是否可读、路径是否失效、数据库连接是否成功、查询是否返回了记录。
  4. 当前记录层:打印时游标停在哪一行,该行这一列是不是空值、空行或被筛选排除。
  5. 输出层:预览与实际输出是否走同一条链路,触发文件、打印到文件、机器内存里的旧格式有没有插进来。

顺序不能颠倒的原因很简单:前一层没通过时,后一层的表现会被完全遮住。比如变量对象被当成静态文字,无论数据源多完整,打出来的都还是占位符原文。

三、第一层 变量对象:占位符语法、对象类型与默认值

先在软件里双击那个空白对象,确认三件事,三十秒内就能定性。

  • 对象类型:它必须是「变量 / 数据库字段 / 数据源对象」,而不是文本框里手打的字符。若属性面板显示的是普通文本,把内容删掉,重新从变量列表拖一个字段进来,不要在原文本框里改字。
  • 占位符写法:不同软件的变量语法不一样,有的用尖括号,有的用花括号,有的由软件自动管理、不允许手改。手改过的占位符经常因为少一个括号或多了空格而失效。做法是从软件的字段列表重新插入一次,让软件自己写占位符,比照着手册敲可靠。指令层下发时(ZPL、TSPL 等)变量占位与替换的写法以随机手册为准,不要凭记忆拼参数。
  • 默认值与空值处理:不少软件允许给变量设「当值为空时显示」的默认值,或勾选「允许空值」。现场建议先临时设一个显眼的默认值(例如全角问号),再打一张:如果标签上出现这个默认值,说明变量对象本身是好的、只是没取到值,问题在下游;如果仍然是占位符原文,问题就锁在对象层。判定完记得把默认值改回业务要求的口径。

另有一类容易忽略的情况:对象被设成了「只在满足某条件时打印」,条件表达式引用了另一个也取不到值的字段,于是整块被判为不打印。检查对象的可见性条件,把条件暂时关掉再打一张,能快速区分「没值」和「被条件隐藏」。

四、第二层 数据源连接:Excel、CSV 与数据库三类各查什么

变量对象确认无误后,再看数据源本身。三类载体的失效点不同,逐类核对,不要混着查。

  1. Excel 工作簿:核对文件路径有没有被移动或改名;工作簿是否正被另一台电脑以独占方式打开;目标工作表(Sheet)名称有没有改过、顺序有没有变;软件里选的是不是那张表。另有一个高频坑——首行被当成表头时,若第一行是标题或合并单元格,字段名会整行错位,表现为所有变量都取不到值。确认「首行作为字段名」这一项与表格实际结构一致。
  2. CSV / 文本文件:核对分隔符(逗号、分号、制表符)与文件实际用的符号是否一致,编码是 UTF-8 还是 GBK,有没有 BOM,字段里含逗号时有没有加引号。分隔符认错时,整行会被当成一列,第一个变量之后的字段全部为空。
  3. 数据库 / 业务系统:核对连接串、账号权限、表名与视图名;把软件里那条查询语句单独放到数据库工具里跑一次,看它到底返回几行、字段名是什么。查询加了日期范围或状态筛选后返回零行,是最典型的「昨天还好、今天全空」。若走中间接口或触发文件,还要确认下发的数据里确实带了这些字段。

核对时养成一个习惯:把数据源当前实际返回的列名抄在一张纸上,再和模板里的变量名逐个对,肉眼看「差不多」最容易漏掉前后空格与全半角差异。

五、第三层 字段映射:列名一改,整批就空

连接正常、查询有记录,但个别字段还是空的,十有八九是映射断了。按下面四项顺一遍。

  • 逐字比对:字段名大小写、下划线、中英文括号、全半角、首尾空格,任何一处不一致都会取不到值。数据源侧把「客户名称」改成「客户名」,模板不会自动跟着变。
  • 列顺序变动:有些模板按列序号而不是列名绑定。数据源插了一列、删了一列,序号全往后错一位,表现是「字段都有值,但整体错位」,比空白更隐蔽。优先改成按列名绑定。
  • 隐藏列与筛选:Excel 里隐藏的列、被筛选排除的行,部分驱动会直接跳过,导致变量读成空值。把隐藏列取消、筛选清掉再打一张对照。
  • 数据类型:数值列被当成文本、日期列被当成数字,遇上格式掩码就可能显示成井号或星号。确认软件里字段类型与数据源列类型一致,必要时在查询里做一次显式转换。

改完映射后不要直接批量打印,先用「打印预览」看第一条记录,再打一张实物,确认字段名和值都对上。

六、第四层 当前记录:空行、空值与游标

数据源有几百行、模板也绑对了,偏偏某几张是空的,问题通常落在「打印时读到的是哪一行」。

  1. 空行与尾部空记录:表格末尾常有格式没清干净的空白行,被当成有效记录读到,于是最后几张标签只有固定文字、变量全空。把数据源末尾的空白行整行删除,不要用「看起来没内容」来判断,选中行看行号最稳。
  2. NULL 与空字符串:数据库里 NULL、空字符串、全角空格是三种不同的值,软件对它们的处理不一样。若业务允许,在查询里用统一口径把 NULL 转成一个可读占位(例如短横线),避免下游各按各的解释。
  3. 游标与起始记录:确认打印任务从哪里开始、到哪结束,有没有设成「只打选中的记录」而选中状态已失效;批量触发场景还要确认下发方传的记录编号范围。
  4. 变量不刷新:连续打印时某些计数器或全局变量被设成「每次作业只取一次」,于是后面每张都沿用第一张的值。这类不是取值失败,而是刷新时机设置,检查变量属性里的重置条件。

定位手法很朴素:让软件只打印出问题的那一条记录,单独打一张。单张正常、批量才空,就说明是记录范围或游标问题,而不是字段映射。

七、第五层 输出:预览正常、实际空白的四种插手环节

预览里字段齐全,实物却是空的,说明数据源与模板都没问题,链路在输出段被换掉了。

  • 预览与打印走不同路径:个别驱动在预览时用本机缓存的数据,实际打印时重新读数据源。改完数据源后先关掉预览、重新打开一次,再触发打印,不要沿用旧预览窗口。
  • 打印到文件 / 指令文件下发:导出的指令文件里如果变量没被替换,说明替换动作发生在软件侧而不是机器侧;这类文件直接下发,机器只会照着打印占位符。用一份只含一个变量的最小模板做验证,确认链路在哪一段完成替换。
  • 触发文件与集成下发:业务系统或触发文件里字段名与模板变量名不一致时,机器收到的是没有对应值的指令。核对下发报文里带的键名,而不是只看界面上的中文标签名。
  • 机器内存里的旧格式:部分机型支持把模板存进打印机,若机器里留着旧格式且优先被调用,新模板的变量就取不到。核对设备里存储的模板列表,必要时清理后重新下发。

这一层的判定口诀是:预览对、实物错,先怀疑「实物这条链路用的是另一份数据或另一份模板」,而不是回头改浓度、压力或打印头设置。

八、与相邻问题的分界线:别把别的故障当成取值失败

下面几类现象和「变量空白」很像,但归在不同的排查线上,认错方向会白忙一轮。

  • 中文乱码、显示方框:有内容、只是字形不对,属于字体与字符集问题,查字体嵌入、代码页与指令编码,不要动数据源。
  • 缺字、生僻字打不出:字符本身存在但字形覆盖不到,同样归字体层;变量取值链路是通的。
  • 序列号不递增、整批打同一行:数据源连上了、也有值,问题是游标没有按记录推进,属于计数器与数据源游标设置。
  • 换电脑后字段全空:多为模板引用的数据源路径或引用文件失效,按路径与引用核对,而不是重设字段映射。
  • 版式是新的、几个字段却是旧值:版本或缓存问题,先取证确认打出来的是哪一版模板,再谈取值。
  • 日期、有效期不对:变量取到了值,只是取错了来源(系统时间、机器时钟或手填值),属于时间取值路径的核对。

一句话区分:本文处理「这一段根本没有取到值或取到了占位符原文」,上面这些处理「取到了值,但值不对、字形不对、版本不对或时间不对」。

九、六步排查流程与首件验证

把前面的分层收成一套现场可以照做的顺序,每步都留一张样张,避免边查边改、最后说不清是哪一步修好的。

  1. 固定现象:打一张样张,按第一节归入四型之一,记录是整批还是个别张、是全部字段还是单个字段。
  2. 查变量对象:确认对象类型、占位符由软件生成、临时默认值能显示,把问题锁定在对象层或推到下游。
  3. 查数据源:文件可读、连接可用、查询确实返回记录,并把实际列名抄下来。
  4. 查字段映射:变量名与列名逐字比对,确认按列名绑定、无隐藏列、类型一致。
  5. 查当前记录:清掉尾部空行,统一空值口径,单独打问题那一条记录做对照。
  6. 查输出链路:重开预览、核对触发报文键名、清理机器内旧格式,确认实物走的是刚改过的那份数据。

验收用三张样张:第一张取第一条记录,第二张取中间一条,第三张取最后一条。三张的变量都有值、且与数据源对应行逐字一致,才算修好;涉及条码的字段,按 ISO/IEC 15416 做一次条码等级判级,确认变量内容变化后等级没有掉档。之后把「数据源路径 + 列名清单 + 变量名清单 + 打印份数与记录范围」写成一页作业指导书,换人换电脑时直接照抄比对。

十、把取值口径固化下来,减少复发

  • 数据源文件放在固定共享位置并用统一命名,避免各人本机各存一份;路径变更时同步更新所有引用它的模板。
  • 字段名一经确定不要随意改名,确需改动时列出受影响的模板清单,逐个改绑定后再复用。
  • 表格模板里锁定表头行,禁止在数据源中间插入或删除列;新增字段一律追加在末尾。
  • 给关键变量设合理的空值处理口径,让「没取到值」在样张上显眼,而不是安静地留一片空白流到客户手里。
  • 交接班抽打一张含全部变量的首件样张留档,出现批量异常时能第一时间判断是数据源变了还是模板被改了。

变量取值失败几乎都不是硬件故障,把顺序和口径固定下来,比每次临时试错省时得多。

常见问题

1. 预览里明明是「苏州博尔杰」,打出来却是 <客户名> 几个字?

这是最典型的占位符字面量:模板把这个对象当静态文字送去了打印机。先看对象属性是不是变量类型,再从字段列表重新插入一次让软件自己写占位符。若改完仍出现原文,改查是不是走了「打印到文件 / 指令文件」下发,替换动作没发生在软件侧。这一型与字体、浓度、打印头都无关。

2. 只有一两个字段是空的,其他字段都正常,哪里出问题?

说明数据源连上了、变量也在解析,断在字段映射或当前记录这一格。优先逐字比对这几个空字段的列名与变量名(大小写、前后空格、全半角最常出错),再看数据源里这一行该列是不是空值、有没有被隐藏列或筛选排除。不要因为别的字段正常就去重装驱动。

3. Excel 里这一列明明有值,标签上却打印成空白?

按三处查:一是「首行作为字段名」有没有把标题行或合并单元格当成表头,导致字段名整行错位;二是工作表名称、Sheet 顺序有没有改过,软件选的是不是那张表;三是工作簿是不是被另一台电脑独占打开、软件读到的是旧缓存。把查询或连接刷新一次,单独打第一条记录对照,很快能定位。

4. 打出来是问号、星号或一串井号,是字体问题吗?

不一定,但先别急着换字体。字段宽度小于内容长度、格式掩码与数据类型不匹配,都会把正常值显示成井号或星号;这时数据源和变量都是好的。若确认是中文变方框、缺字或乱码,那才属于字体与字符集层,按字体嵌入和代码页去查。判断标准是:把该字段临时加宽、去掉格式掩码再打一张,符号消失了就是格式问题而非字体问题。

5. 数据源把字段名改了一个字,整批标签那一项都空了?

正常现象——模板绑定的是旧列名,改列名不会自动同步。把模板里对应变量的绑定改成新列名,或把数据源列名改回去;同时列一份受这个字段影响的模板清单逐个核对。若模板是按列序号绑定的,还要一并改成按列名绑定,否则插列删列会引发更隐蔽的错位。

6. 数据库查询加了筛选条件之后,变量就取不到值了?

先把那条查询语句单独放到数据库工具里跑一次,看返回行数。返回零行时,模板自然没有任何值可填,界面上往往只表现为「字段全空」而不报错。核对筛选的日期范围、状态值与单据是否已审核;确认查询有记录后,再看软件是不是仍指向旧的视图或旧的连接串。

7. 同一批标签前几张正常,后面几张变量突然空了?

多半是数据源末尾有格式没清干净的空白行被当成有效记录,或记录范围设得比实际数据长。把数据源末尾的空白行整行删除(按行号判断,别只看有没有内容),再把打印记录范围收敛到实际行数。若只有固定某几张空,单独打那一条记录,检查该行该列是不是空值或 NULL。

8. 为什么改了数据源要重新打开一次预览才生效?

部分驱动在预览时用本机缓存的数据,实际打印时才重新读数据源;沿用旧预览窗口,看到的还是改之前的值。改完数据源后关掉预览、重新打开,必要时重启一次软件让连接刷新,再打实物。养成「改数据 → 重开预览 → 打单张 → 再批量」的顺序,能避开大部分「预览对实物错」的困惑。

9. 变量取到的是上一张的旧值,是不是打印机有缓存?

先分清是「值没刷新」还是「模板用错了版本」。软件侧的计数器或全局变量若设成每次作业只取一次,后面每张都会沿用第一张的值,检查变量属性里的重置条件即可;若版式是新的、只有几个字段是旧值,则要先取证确认打出来的到底是哪一版模板,属于版本与缓存域。两者都不是数据源取值失败。

10. 调完之后怎么验收,才算真的修好了?

打三张样张:第一条记录、中间一条、最后一条,三张变量都有值且与数据源对应行逐字一致;涉及条码的按 ISO/IEC 15416 判一次等级,确认内容变化后没有掉档。再把数据源路径、列名清单、变量名清单和打印记录范围写成一页作业指导书留档,下次换人、换电脑、换批次时直接照单比对。

相关支持文章

更多标签设计软件与打印设置问题的答案,请前往 MROer 支持中心软件分类浏览全部支持文章,或查看 BarTender、Codesoft、Brady Workstation 相关专题。文中涉及的软件功能名称、指令写法与机型规格以各产品官方手册与 MROer 产品页标注为准。

« 返回列表
博尔杰PTS|博尔杰标识商城|博盾安全标识|博锐迪生物标签