能否把 Lodop API 直接改成 printHtml?
不能一对一替换。需为目标单据准备 HTML/CSS 版式,再调用 printHtml;Lodop 模板需单独评估重写范围。
正在做 Lodop 迁移,又不敢全切?本文给出盘点 → 下载客户端跑通样例 → 与 Lodop 并行 PoC → 按单据 HTML 化的步骤,不是 API 一对一替换。选型见 Lodop 替代对比;Chrome/C-Lodop 见 C-Lodop 排查。
Lodop 在套打、内网票据等场景有长期应用积累。若现有 Lodop 运行稳定,无需仅因本文而变更。本文面向:新建业务模块、希望用 HTML/CSS 统一报表版式、需在 Win/Mac/信创多端共用 npm 接口、或需与 远程打印 联动的团队,作为与 Lodop 并行的 PoC 参考。
先梳理现状,再决定哪些单据并行 PoC、哪些继续沿用 Lodop。
| 盘点项 | 建议记录 | 用途 |
|---|---|---|
| 单据/模板清单 | 名称、调用页面、日打印量 | 排 PoC 与 HTML 化优先级 |
| 版式类型 | A4 报表 / 热敏 / 毫米套打 | 评估是否适合 HTML 渲染 |
| 打印机 | 驱动名称、纸张、是否默认机 | 配置 printOptions |
| 终端环境 | Windows / 信创、浏览器版本 | 选客户端安装包 |
| 现有 Lodop 调用 | 入口函数、是否 C-Lodop | 设计并行开关,便于回滚 |
下表描述常见集成差异,非 API 一对一替换说明;具体以各产品官方文档为准。
| 环节 | Lodop 常见做法 | web-print-pdf 常见做法 |
|---|---|---|
| 版式 | Lodop 指令 / 套打 | HTML/CSS 模板 |
| 触发 | LODOP 对象 API | printHtml(html, pdfOpts, printOpts) |
| 静默出纸 | 本地控件 / 服务 | Web打印专家客户端 + npm |
| 浏览器侧 | 含 C-Lodop 等部署 | 标准 Web + WebSocket 本地服务 |
| 信创桌面 | 以 Lodop 官方说明为准 | deb 客户端(见 Linux 部署) |
三阶段可重叠:阶段 1 验证技术可行;阶段 2 业务并行;阶段 3 按盘点表逐步扩展。全程可保留 Lodop 处理尚未 HTML 化的单据。
npm install web-print-pdfprintHtml,与 Lodop 样张并排对比并行期务必保留 Lodop 环境与授权配置,回滚时关闭 web-print-pdf 开关、恢复原有 Lodop 调用即可。避免在未完成 PoC 前卸载 Lodop 服务或删除模板。
getConnectStatus(),见错误处理专题不能一对一替换。需为目标单据准备 HTML/CSS 版式,再调用 printHtml;Lodop 模板需单独评估重写范围。
已稳定运行的精密套打、短期无法 HTML 化的票据,可继续 Lodop;新建 HTML 报表优先 PoC web-print-pdf。
关闭 web-print-pdf 功能开关,恢复原有 Lodop 调用;勿删除 Lodop 服务与模板。
C-Lodop 与浏览器适配见 C-Lodop 专题;本文侧重分阶段并行接入步骤。
本文仅供技术集成参考。Lodop、C-Lodop 为独立产品,名称仅用于识别与对比,商标归权利人所有。文中现象为部分环境的公开反馈,不代表该产品必然存在缺陷。是否继续 Lodop 或引入 web-print-pdf,请以官方文档与本单位 IT 规范为准。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。