UPRUN产品帮助中心
首页
目录

运维专项 · 蓝牙标签

标签设计

一张可用标签不是屏幕上排版好看，而是正式业务键、四个业务维度、模板版式、手机蓝牙输出和下游识别始终代表同一事实。

产品边界移动端只走手机无线蓝牙标签机与运维工具模板，输出 TSPL 或 ZPL；不使用打印站、旧 ERP 报表清单、OutputReports 或电脑端打印队列。

先看前因后果

标签从业务事实出发，最后还要能回到业务事实

设计器只负责中间的“怎么排版”。前面的码值来源和后面的扫码、补打不成立，再漂亮的模板也不能交付。

  1. 01
    业务定义

    确认标签身份

    明确这张标签代表哪类记录、由哪个正式键唯一定位，以及必须表达的客户、部门、货或批次、数量。

    缺失时：同一张纸可能无法判断属于谁、在哪个部门、是什么货、数量多少。

  2. 02
    物理条件

    确认纸张与设备

    记录宽高、方向、边距、DPI、打印语言、标签间距和实际蓝牙打印机能力。

    缺失时：屏幕正常，实体却截断、错位、过黑或无法发送。

  3. 03
    通用模板

    设计版式与变量

    摆放固定文字、业务字段、条码/二维码、图片和线框；变量只来自可用字段。

    缺失时：预览靠样例看似完整，真实打印时变量为空。

  4. 04
    功能配置

    绑定模板与码值列

    在配置专家为需要标签的功能选择匹配模板和新增后稳定生成的 ERP 码值列。

    缺失时：模板存在但 APP 不知道何时打印，也不知道条码应编码什么。

  5. 05
    手机输出

    选择蓝牙设备并首次打印

    手机用保存后读回的正式数据填充快照，向已配对标签机发送 TSPL/ZPL。

    缺失时：桌面预览通过，却没有证明实际纸张、设备和现场信号可用。

  6. 06
    下游业务

    扫描同一码继续业务

    生产交接或出货按各自 PDA 表单识别该码，并回到同一正式记录。

    缺失时：标签只是文字展示，不能成为下一环节可靠入口。

  7. 07
    历史一致性

    补打原快照

    补打保持原业务键、码类别、模板版本和字段快照，不按今天的配置重新拼。

    缺失时：同一码在不同时间代表不同内容，追溯和库存链失真。

先分清谁负责什么

模板、功能绑定、手机设备是三层，不要混在一个页面改

责任层负责的事实不负责的事实
通用标签模板纸张、网格、字体、元素、变量、条码样式和 TSPL/ZPL 版式。不决定哪个移动功能使用，也不保存具体业务记录的码值。
功能标签输出是否打印、模板选择、ERP 码值列、打印字段、首次份数和下游识别覆盖。不复制一套版式，也不维护打印机队列。
移动 APP选择已配对蓝牙设备，用正式读回数据和标签快照执行打印、补打。不发明字段、不改模板、不从旧 ERP 报表清单挑格式。
03

通用标签模板

设计器：先定物理画布，再放内容

相似模板优先复制后改名。直接修改共享模板前必须先确认引用范围；删除前确认没有移动功能仍在使用。

看不清文字时，点图进入接近原尺寸的大图，再用“文字清晰 150%”继续放大。 候选内容会随客户账套配置变化。
  1. 1模板标识、名称与当前功能归属
  2. 2纸张尺寸、边距、网格和单元格
  3. 3内容类型、业务变量、条码与图片
  4. 4校验、预览、保存和输出语言
  1. 1

    选择、新建或复制

    模板编码是稳定标识，名称用于人看。复制共享模板后必须改成能辨认用途的新编码与名称，避免两个业务误用同一正式模板。

  2. 2

    按实物设置画布

    填写实际毫米宽高、上下左右边距、方向和网格。单元格可合并、拆分和拖动；不要用浏览器或屏幕缩放补偿错误的纸张尺寸。

  3. 3

    逐格放置内容

    固定文字直接输入；业务字段从变量列表插入；条码/二维码绑定正式码值变量；图片按单元格尺寸处理。货品动态图只有在正式字段与图片来源都成立时才使用。

  4. 4

    校验、预览再保存

    先用样例检查版面与生成指令，再用真实记录检查字段。选择与实体打印机一致的 TSPL/ZPL 和份数；预览通过后保存到服务器。

    完成结果：模板本身无越界、重叠和未知变量，服务器重载后内容与版本一致。

设计时要看业务身份

每种元素都要回答：从哪里来，打印后有什么用

元素正确来源与用途交付时检查
固定文字标题、单位、提示等不会随记录变化的内容。不要把客户名、部门名或货品名写成固定文字。
业务变量来自当前功能保存后读回或已显式引用输出的字段。用真实记录预览，空值不能由样例或默认文字掩盖。
主条码 / 二维码编码正式唯一业务键，例如生产作业 WorkID；码类别由下游 PDA 明确识别。至少在两个实际距离和角度测试，可回到唯一记录。
可读文字把关键码值、客户、部门、货或批次、数量同时给人查看。条码损坏时仍能人工判断标签身份和处理方向。
图片固定 Logo 或有正式来源的货品图；动态图变量来自当前记录。黑白转换后仍可辨认，且不会把条码挤得过小。
线框与留白帮助分区和适应裁切、卷纸间距。实体纸边、打印头不可打印区和连续多张走纸都不截断。
05

仅实施员

功能标签输出：把版式接到正式码值

模板保存成功不代表移动功能已经会打印。必须回到配置专家，为当前功能完成输出绑定和体检。

看不清文字时，点图进入接近原尺寸的大图，再用“文字清晰 150%”继续放大。 候选内容会随客户账套配置变化。
  1. 1生产作业必需的 WorkID 标签输出
  2. 2稳定且唯一的 ERP 码值列
  3. 3与数据环境和 PDA 匹配的模板
  4. 4标签输出独立保存并重检
  1. 1

    完成生产作业必需的标签输出

    此页只对生产作业显示，WorkID 标签是必需配置。缺模板、码值列或四要素时应补齐来源，不能关闭标签来绕过阻断。

  2. 2

    选择正式码值列

    必须是新增保存时由数据环境真实生成、类型稳定且能唯一表示记录的列。预览值、提交前草稿、名称相似或“看起来像编号”都不是证据。

  3. 3

    选择精确匹配的模板

    模板候选需要匹配当前数据环境和 PDA 表单。页面还会检查客户、部门、货或批次、数量四要素；缺项应回字段映射或模板处理。

  4. 4

    保存并重新体检

    标签页只保存本页。体检还会确认生产交接、出货等已启用下游是否能识别该码；两类下游可同时存在。

    完成结果：体检无阻断，启用已保存；APP 能从同一正式记录取得码值和全部打印字段。

标签贴到实物后就是证据

首次打印、下游扫码、补打必须锁定同一身份

环节必须保持一致不一致时的处理
首次打印正式业务键、码类别、模板标识与版本、字段快照。缺任一项就停止打印并指出缺口，不能临时拼一张。
下游扫码下游功能自己的 PDA 表单能识别同一码，并唯一带回对应 MobileField。回到下游扫码规则修正，不在标签内容里加隐藏前缀猜类型。
历史补打同一 WorkID 或正式业务键、同一码类别、同一模板版本、同一字段快照。快照损坏或不完整时明确拒绝；不使用当前新模板替换历史事实。

排障顺序

从纸面现象追到真正责任层

现象真正应先检查不要这样修
预览正常，实物截断毫米尺寸、边距、方向、DPI、打印语言、标签间距和打印头可用区域。在模板里随意缩小所有内容，掩盖错误介质配置。
正式标签字段为空该变量是否来自保存后读回或显式引用输出；当前功能是否保存了字段映射。把预览样例写成固定文字或空值默认。
条码看得见但扫不出实体尺寸、密度、黑度、安静区、打印质量和码制是否适合现场设备。只在电脑屏幕上用截图扫码证明可用。
扫出码但查不到记录ERP 码值列是否稳定唯一；下游 PDA 的 SQL 与映射是否识别该正式键。修改码值前缀或让 APP 按外形猜记录类型。
补打内容变了历史标签快照、模板版本和字段值是否完整保存。按当前模板和当前字段重新生成“看起来一样”的新标签。
改模板影响别的功能该模板的引用范围；是否本应复制后建立独立模板。继续在共享模板上叠加功能专用字段。

必须有实体设备证据

标签交付验收清单

桌面预览和自动测试只能证明模板能生成，不能代替手机、蓝牙链路、打印机、纸张和现场扫描器的组合验证。

  1. 1. 物理参数

    实测纸张宽高、间距、方向、边距、DPI 和 TSPL/ZPL 与设备一致。

  2. 2. 四要素

    客户、部门、货或批次、数量可直接看到或能由唯一主码可靠解析。

  3. 3. 真实数据

    至少用短值、最长值、中文、数字、小数和可为空字段各打一组。

  4. 4. 连续打印

    连续多张不累计偏移、不漏打、不重复，份数与现场动作一致。

  5. 5. 扫码距离

    近距离和实际作业距离均能识别，倾斜、反光和轻微污损有可接受余量。

  6. 6. 下游闭环

    生产交接或出货能用该标签回到唯一业务记录，并受各自权限与范围校验。

  7. 7. 补打一致

    修改现行模板后补打历史记录，仍保持历史模板版本与原字段快照。

  8. 8. 失败提示

    缺设备、断连、缺字段、快照损坏和下游不识别都说明影响与处理位置。