3.3.7 标签管理
组件名称：标签管理 组件编号：LabelManagement
功能说明
标签管理用于将产品、工位、打印机、标签模板及打印数据关联起来，并查询打印结果、补打原标签。页面包含“标签管理”“标签记录”两个页签。
标签版式在配套的模板设计软件中制作；在 LMES 中选择已有模板，并设置每个动态字段的取值来源。
适用场景与解决的问题
- 同一产线需要打印不同产品标签：分别建立产品对应的标签，逐工位选择打印机和模板，打印时按实际产品与工位匹配。
- 标签需要同时打印产品信息和设备数据：将模板动态字段关联到业务字段、变量或条码生成规则，试打后核对来源值和实物内容。
- 标签损坏或输出失败后需要补打：找到原打印记录，使用其中保存的数据重新打印，并核对已输出份数与本次实物。
使用前准备
- 在产品管理中建立适用产品，准备模板及需要打印的字段。
- 完成配置 LMES 打印连接，保存打印机名称、连接地址和模板目录。
- 完成配置工位打印流程，在目标工位选择打印机并关联打印信号。标签中可选的打印机来自该工位的配置。
- 需要新生成条码时，先在条码管理中建立生成规则；打印已有产品码时，准备保存该码的变量或业务字段。
本机 BarTender 打印无需安装 Agent；远程打印的 Agent 安装与连接见准备打印环境。完成以上配置后，在本页维护标签。
相关教程
标签管理
查找标签
在查询框中输入标签名称关键字，查询对应标签。列表显示标签名称、适用产品名称、操作用户和备注；选择目标记录后，可编辑或创建副本。
需要确认具体工位、打印机和模板时，打开标签编辑窗口查看“适用工位”，再选择其中一行查看该行的“数据映射”。
新建与维护标签
- 点击“新增”，填写标签名称并选择一个适用产品。
- 在“适用工位”中添加一行，选择该产品需要打印标签的工位。
- 选择打印机，再选择标签模板；需要查看版式时，在模板选择窗口点击“预览”。
- 设置“打印次数”，点击选中当前工位行，在下方“数据映射”中填写模板的动态字段、数据类型和数据源，具体取值见下方“配置打印数据映射”。
- 需要在其他工位打印时，继续添加工位行，分别配置打印机、模板、打印次数及数据映射。
- 填写备注，点击“确认”保存。重新打开标签，逐行检查工位配置及其数据映射。
基本信息与打印配置
| 配置项 | 填写要求与业务影响 |
|---|---|
| 标签名称 | 必填，名称不可重复。用于查询标签及识别打印记录，可按“产品＋标签用途”命名 |
| 适用产品 | 一个标签选择一个产品。打印时用于匹配标签；不同产品可创建副本后分别维护 |
| 适用工位 | 决定标签在哪个工位使用。同一标签可维护多行工位配置，每行分别保存模板与数据映射 |
| 打印机 | 从所选工位关联的打印机中选择。打印流程选用的打印机应与此处一致 |
| 标签模板 | 先选择打印机，再从其模板列表选择。决定标签版式及动态内容，模板位置由对应打印连接配置确定 |
| 打印次数 | 默认为 1，填写不小于 1 的整数，表示该行配置每次打印时输出同一份数据的份数 |
| 备注 | 记录标签用途、纸张规格等说明，便于后续维护 |
同一标签内，“工位＋打印机＋模板”组合不可重复。确需在同一工位打印不同模板时，分别添加配置行；每行独立设置打印次数。
工位与模板调整
- 选择某一工位行后，下方显示该行的数据映射；切换到其他行时，继续维护对应行的映射。
- 更换适用产品后，重新选择工位并配置数据映射，原工位与映射会被清空。
- 更换工位后，重新选择打印机和模板；更换打印机或模板后，检查每个动态字段是否仍与模板一致。
- 模板预览用于查看版式及模板中的样例内容。实际产品信息、变量和生成码在执行打印时取值，需通过试打确认。
配置打印数据映射
数据映射决定标签中的每个动态字段打印什么内容。先选择“适用工位”中的目标行，再配置下方映射。
- 添加动态字段，填写模板中对应的字段名称。
- 选择“数据类型”：变量、字段或条码生成规则。
- 在“数据源”中选择该字段需要读取的变量、业务字段或生成规则。
- 逐项配置模板需要的动态字段；切换工位行，检查其他行各自的映射。
- 点击“确认”保存标签，使用目标产品在对应工位执行试打。
| 映射项 | 填写要求与取值规则 |
|---|---|
| 动态字段 | 填写模板中的动态字段名，如 Barcode、ProductModel；与模板中的名称及大小写保持一致 |
| 数据类型：变量 | 执行打印时读取所选变量的值。适用于设备条码、检测值等；变量读取异常时，检查通信及变量状态 |
| 数据类型：字段 | 从本次打印的业务信息中取值，如产品型号、当前工序信息或对应追溯字段；按选择窗口实际提供的字段选择 |
| 数据类型：条码生成规则 | 执行打印时调用所选规则生成条码，将生成结果填入该动态字段；计数范围和格式由生成规则决定 |
| 数据源 | 与数据类型配套选择，决定实际取值对象。改变数据类型后，重新选择数据源 |
选择“字段”时，选到具体需要打印的值，例如产品型号或产品名称。使用追溯字段时，确认本次打印对象在对应工序已有可供查询的记录；缺少业务信息时，相关字段可能为空。
同一工位行中，每个动态字段名称只配置一次。模板新增、删除或重命名动态字段后，同步调整映射。
需要条码图形和条码下方文字显示同一个值时，在模板中让两处使用同一命名数据源，LMES 对该动态字段配置一次。
选择条码生成规则与下发变量
- 将该动态字段的“数据类型”设为“条码生成规则”，点击数据源中的“选择”。
- 在“生成规则”中选择已经建立的条码生成规则。
- 需要将新码同步送给设备时，选择“下发变量”；只用于标签内容时，可不设置。
- 确认选择并保存标签，打印后同时检查标签条码和接收变量。
下发变量接收本次生成的条码，写入发生在准备打印数据时。设备收到新码后，仍需结合打印结果和实物确认标签是否正常输出。
打印已有产品码时，选择保存该码的变量或业务字段；需要为本次业务创建新码时，选择条码生成规则。重新触发正常打印会重新取数，并执行所配置的生成规则；补打原标签使用下方“重新打印”。
打印次数与条码数量
例如某行配置的打印次数为 2，动态字段 Barcode 使用生成规则：本次取到一个生成码后，按该码输出两份标签。需要每件产品分别使用新码时，应按件触发相应打印业务。
配置示例：产品标签
为产品 A100 在贴标工位建立标签，选定工位已关联的打印机及产品标签模板，打印次数设为 1。模板包含以下三个动态字段：
| 动态字段示例 | 数据来源与预期内容 |
|---|---|
ProductModel | 选择“字段”，关联本次打印产品的型号，预期内容为 A100 |
Barcode | 选择“条码生成规则”，关联产品赋码规则；例如输出 FX202610220001，需要同步设备时设置下发变量 |
TestValue | 选择“变量”，关联该工位的检测值变量；标签内容取本次打印时读取的值 |
首次贴标且产品尚无加工履历时，按工位打印流程提供 A100 产品档案中的产品识别码。触发后检查型号是否为 A100、标签条码是否符合生成规则、检测值是否与打印时的设备值一致。模板字段名按实际模板填写，示例名称不作为固定要求。生成码格式详见条码生成规则。
确认打印应用与结果
标签保存后，通过已配置的生产打印流程使用。打印时按实际产品、当前工位及流程选用的打印机匹配标签，使用匹配行的模板、打印次数和数据映射。
- 在目标工位准备本次产品信息和变量值，按触发标签打印完成一次请求及反馈复位。
- 打开“标签记录”，按打印时间和标签名称或工位查找记录；已提供产品 ID 时，也可用该 ID 查询。检查产品、标签名称、工位及打印模板。
- 核对实物标签的文字、条码、方向与份数，扫描条码确认其内容。
- 使用下发变量时，核对接收变量与本次生成码；使用多个工位或模板时，分别试打确认。
同一产品、工位和打印机匹配到多条标签配置时，会分别准备对应打印任务。创建副本后检查适用范围，避免保留重复的生产配置造成额外输出。
设备触发、反馈与复位详见标签打印流程，打印环境及实物检查详见标签打印配置。
复制、修改与删除
创建副本
选择需要沿用的标签，点击“创建副本”。副本会保留适用产品、工位配置及数据映射；编辑副本，修改名称和实际需要改变的产品、工位、模板及数据来源，再保存并试打。
更换副本的适用产品后，重新配置工位和映射。名称不同的两个标签仍可能匹配相同打印业务，需检查原标签与副本是否都要使用。
编辑标签
选择目标标签，点击“编辑”，调整配置并确认保存。模板或字段来源变更后，分别在涉及的工位试打，检查字段内容与打印份数。
删除标签
选择不再使用的标签，点击“删除”并确认。删除后，该配置不再用于后续正常打印；需要更换生产标签时，先准备并确认替代配置。
处理配置与打印问题
| 现象 | 检查与处理 |
|---|---|
| 打印机列表没有目标设备 | 1. 检查系统打印设置中是否已配置打印机。 2. 检查当前工位是否关联该打印机，配置后重新选择 |
| 模板列表为空或预览失败 | 确认已选择正确打印机，按打印环境检查检查模板目录及服务连接 |
| 提示配置重复 | 检查同一标签内是否重复添加了相同的工位、打印机和模板组合，合并需要的配置并核对打印次数 |
| 标签字段为空或不符 | 1. 检查模板动态字段名及大小写。 2. 检查当前工位行的数据映射和实际来源值。 3. 使用追溯字段时检查对应产品记录 |
| 设备已收到生成码但没有标签 | 1. 查看本次打印记录及备注。 2. 检查队列、连接、耗材和实物输出，再决定是否补打 |
| 输出份数多于预期 | 1. 核对每行打印次数及重复触发情况。 2. 检查是否有多个标签或配置行匹配同一打印业务 |
标签记录
查询打印结果
- 设置“时间范围”，按打印发生时间查找记录。
- 输入产品 ID、产品名称、标签名称或工位等关键字执行查询。
- 查看产品 ID、产品名称、工序、工位、标签名称、打印模板、打印时间、打印结果、操作用户和备注。
- 出现失败或异常时，先阅读备注，再核对模板、字段来源和打印环境。
时间范围按打印时间筛选，包含开始与结束时间。关键字支持对产品 ID、标签名称、产品名称、工位、打印结果及备注进行包含查询。
打印结果的含义
| 结果 | 含义与处理 |
|---|---|
| 成功 | 本次打印调用返回成功。继续检查实物输出、条码内容和份数 |
| 失败 | 本次打印调用失败，备注记录相关原因。处理连接、模板或打印设备问题后，可选择原记录补打 |
| 异常 | 准备打印数据时出现问题，如缺少产品信息、系统打印机配置或初始化异常。按备注处理，再从原业务重新触发打印 |
列表中的记录条数表示打印记录数量；一次记录可能对应多份标签。重新打印也会增加记录，实物数量需结合原配置、重复请求和实际输出核对。
产品 ID 记录本次请求提供的产品条码。仅提供产品识别码并在打印时生成新码的场景，产品 ID 可能为空，可按时间、标签名称或工位查找。新生成的标签码不会自动填入该列；需要核对生成码时，结合标签内容及配置的下发变量检查。
重新打印
- 找到原打印记录，核对产品 ID、产品名称、标签名称、工位和模板，清点原任务已经输出的标签。
- 处理缺纸、离线、服务不可用等问题，按打印环境检查确认原打印连接与模板可用。
- 点击选中需要补打的一条记录，再点击“重新打印”。该操作提交原记录的打印任务，使用原打印份数。
- 查询新增的打印记录，查看本次结果；补打成功的记录备注为“重新打印”。
- 收取标签，检查条码、文字及份数，确认与需要补打的原标签一致。
补打的数据与份数
补打沿用原记录保存的打印数据、打印机、模板路径和打印份数，不重新读取变量、业务字段，也不再次调用条码生成规则。原配置为两份时，补打仍按两份执行。
例如原记录保存的条码为 FX202610220001，补打继续使用该码；从生产流程重新发起一次正常打印时，则重新取数并按配置执行生成规则。
补打沿用原打印连接与模板路径。打印环境迁移后，先按补打前的连接检查确认原连接仍可用。历史记录不保存模板文件副本；需要复现原版式时，先确认原模板文件可用。模板修改后先试打，核对实际加载的版式。
原结果为“异常”的记录不支持重新打印；按备注修正产品、模板或数据配置后，从原业务重新发起打印。
常见问题
| 现象 | 检查与处理 |
|---|---|
| 查询不到记录 | 1. 按实际打印时间调整范围。 2. 首次赋码时使用标签名称或工位查询，产品 ID 可能为空。 3. 检查打印流程是否已触发及其反馈 |
| 显示成功但没有标签 | 核对打印队列、实际输出设备、连接和耗材，清点已输出标签后再补打 |
| 点击重新打印提示先选择记录 | 点击选中列表中的目标记录，再执行“重新打印” |
| 重新打印被拒绝 | 查看原结果是否为“异常”，按备注处理后从原生产业务重新发起打印 |
| 改了数据映射，补打内容仍是旧值 | 补打使用原记录保存的数据；新配置通过新的正常打印请求取值，原标签补打仍保留原值 |
| 补打版式与原来不同 | 检查原模板路径下的文件及打印环境实际加载的版式，按模板修改后的确认试打确认 |
| 条码扫不出 | 检查条码内容、码制、模板尺寸、纸张及打印清晰度，调整后试打并扫码确认 |