系统换了,Lodop 设计器里攒了几十张票:入库单、送货单、标签。业务说「版式不能变」。新栈想走 HTML + 静默,老模板又不能一键魔法转换。
直说吧:
迁的不是「控件」,是字段清单 + 纸上位置。先对齐字段,再谈导出 HTML;别一上来就重画,也别幻想完整兼容层。
先做一张字段映射表
打开 Lodop 设计器,把每个打印项抄下来:
| Lodop 项(例) | 含义 | 新模板字段 | 备注 |
|---|---|---|---|
订单号 文本 |
单号 | {
{orderNo}} |
字号跟旧票目测 |
明细 表格 |
行项目 | 表格区域 / 循环行 | 列顺序别乱 |
条码 |
单号条码 | 条码元素,内容绑 orderNo | 码制确认 |
| 底图 | 套打背景 | 背景图或矩形框 | 扫描分辨率要够 |
一页票一张表。没有这张表,拖设计器只会「看起来像」,对账时才发现少字段。
迁移顺序(别跳步)
- 定纸型:旧票是 A5 还是 241 针式宽?新模板纸型先锁死。
- 贴底图或画框:套打先保对齐,再填字。
- 按映射表拖字段:名字用业务字段,别用「文本1」。
- 样本数据预览:用真实单号、长品名、极端金额测一次。
- 导出 HTML,进业务灌数 + 静默出纸。
- 旧票与新票叠着对光:差 1~2mm 再微调,别凭感觉改代码。
import webPrintPdf from 'web-print-pdf';
async function printMigratedTicket(html, data, printerName) {
if (!(await webPrintPdf.utils.getConnectStatus())) {
throw new Error('本机打印客户端未运行');
}
const filled = html.replace(/\{\{(\w+)\}\}/g, (_, k) => (data[k] == null ? '' : String(data[k])));
return webPrintPdf.printHtml(
filled,
{
paperFormat: 'A5', printBackground: true, margin: {
top: '0', right: '0', bottom: '0', left: '0' } },
{
printerName, copies: 1 },
{
action: 'print' }
);
}
老票若仍有一部分必须 Lodop 出(特殊针式、授权未到期),可以并行:新模块走 HTML,旧票暂不动——前面写过共存思路,这篇不展开安装与授权。
字段对不齐时,先分三类
| 类型 | 表现 | 处理 |
|---|---|---|
| 名对不上 | 纸上空白或 {
{xx}} |
映射表写错;替换 key 不一致 |
| 位偏了 | 字在框外 | 设计器里挪,别在业务 CSS 里补丁 |
| 内容溢出 | 长品名盖住下一栏 | 字号/换行/截断规则写进模板,不要运行时猜 |
排障表
| 现象 | 先查 |
|---|---|
| 中文正常、金额错位 | 小数位、千分位格式跟旧票不一致 |
| 表格只打出一行 | 导出 HTML 是静态样例行,循环渲染没在业务里做 |
| 条码扫不出 | 码制、静区、热敏 DPI——先别怀疑字段映射 |
| 新票整体缩放 | 打印机驱动缩放开了;或 paperFormat 写错 |
Lodop 设计器里的资产不是废纸,是字段与版式的说明书。对齐表做好,迁 HTML 是体力活;表不做,迁多少次都会「差一点」。