标签打印
本章介绍标签打印的原理与使用。
标签打印是"一条数据打一枚标签"的批量输出场景：商品价签、资产标签、样品条码、地址贴纸等。一张纸划分为若干小格，每格对应单据中的一行明细数据。
1. 基本原理
标签纸通常划分为 N 列 × M 行的网格（如 2 列 × 5 行共 10 格）。
数据来源是单据的明细表：明细有几行就打几枚标签，格子先行后列、从左到右、从上到下依次填满，用不完的格子留空。
每枚标签中通常包含：
- 二维码或条码（如商品编码，便于扫码识别）；
- 主要信息（如品名，字号较大）与次要信息（如规格、单位，字号较小）；
- 明码文本（扫码失败时人工识别）、打印日期等。
每格的具体内容与排版由提供该标签方案的设计者配置，在打印预览中选中方案即可看到效果。
2. 标签纸的尺寸
格子尺寸由纸张大小、页边距、列数行数、格间距共同决定：可用区域按列数行数均分，并留出格间隙（对应标签纸的模切缝）。
⚠️ 务必与实际使用的标签纸对应。 采购标签纸时应选择与方案中配置的格子尺寸匹配的模切规格。若对不上（格子偏大偏小或位置偏移），需调整边距、间距或格内坐标，直至预览效果与实物吻合。
部分方案支持配置起始格偏移（从第几格开始打印），用于标签纸已用掉若干格的情况。
3. 自动续页与数量保护
| 行为 | 说明 |
|---|---|
| 自动续页 | 明细行数超过一页格数时自动续打下一页，直至打完。例如 23 行数据、每页 10 格，自动输出 3 页，最后一页留 7 格空白 |
| 页数预告 | 打印前预览区显示总页数与末页留空格数，据此判断需准备几张标签纸 |
| 页数保护 | 预计页数较多时先弹出确认；超过系统上限直接拒绝，避免误操作产生大量输出 |
明细行数很多时，建议先在单据中筛选需要打印的明细，或分批打印。
4. 使用步骤
- 打开打印预览对话框，在打印方案下拉中选择对应的标签方案；
- 先用已保存且有明细数据的单据检查标签内容；设计态没有真实单据时不会自动生成字段样例，空数据来源会显示提示；
- 若方案提供了可调参数，在设置区调整；
- 需要设置默认方案时，由设计者在设计态点击「设为默认」并保存页面设置；填报态只选择本次方案；
- 填报态下，使用者保存单据后点击打印，系统自动取当前单据的明细行数据填入标签网格。
需要多种规格的标签纸时，可配置多个标签方案并存，打印时在下拉中切换。
演示标签扩展依赖 detailRows.items；本例未匹配该来源，预览提示缺少明细，需配置对应数据后再验证标签效果。
演示标签扩展：当前模板缺少 detailRows.items，预览提示未提供明细数据来源
采购标签方案已适配本例的真实明细表与字段，首枚标签可显示品名、数量、单价和单号；多条明细的整页网格与续页尚未验证通过。
选择采购物品标签方案，按真实明细生成标签；第一枚显示A4复印纸、数量20、单价28.50元与采购单号
采购标签预览已读取真实物品、数量、单价和采购单号；本图展示第一页首枚标签
5. 与多联打印的区别
| 功能 | 含义 |
|---|---|
| 标签打印 | 每格贴不同的一行数据，例如为每件商品打不同的条码 |
| 多联打印 | 同一份单据打印多份相同内容，如存根联与客户联，见水印与多联 |
6. 相关章节
数量核对：多行明细缺页
在本轮演练中，同一张已保存采购单有12项明细，但适配真实字段后的标签预览仍只有首枚和1页。已核对单据保存结果与画布中的12行内容；打印读取明细时仅返回1行，因此调整标签列数不能证明数量正确。
批量输出前必须同时核对单据明细数、标签数与总页数。当前这个演练结果未通过数量核对，不能用于证明批量网格或自动续页成功。
该场景已确认未通过：实际12行明细，打印读取仅1行。失败图不会计为批量输出成功。
已保存采购单包含12项真实明细，用于核对标签数量、顺序和续页
同一采购单有12项明细，但当前标签预览只生成首枚和1页；此图展示未通过的数量核对