无预览打印服务

无预览打印（静默打印）是指在网页中点击打印按钮后，直接将报表内容发送给打印机，无需弹出浏览器打印预览窗口的打印方式。

目录

• 概述
• 打印服务软件安装
• 打印服务配置
• 打印文件列表
• 后台运行
• Linux 系统配置
• MacOS 系统配置
• 在 BaskReport 中调用
• JavaScript API 调用

概述

BaskReport 是一款 Web 报表软件，通常通过浏览器预览报表。原生浏览器打印会弹出打印预览窗口，客户可能希望省略这一步，实现点击即打印。

为满足这一需求，我们开发了跨平台（Windows/Linux/MacOS）的客户端打印服务应用，基于 Java 实现。

打印服务软件安装

Windows 系统

点击此处下载 Windows 版打印服务软件，下载到本地解压后双击 BaskReportPrinter.exe 即可运行。

提示：在下载链接上点击右键，选择"另存为"

软件运行后界面如下：

打印服务配置

选择打印机

打印机列表中会显示当前系统中所有打印机，默认选择系统默认打印机，可根据需要更改。

设置端口号

默认使用 56565 端口对外提供服务。如无端口冲突，不建议修改。

注意：修改配置后需点击 重置打印服务 按钮使其生效

打印文件列表

下方表格显示正在打印的报表文件：

• 打印完成的文件会自动清除
• 出错的打印项会高亮显示
• 可点击 清理错误打印项 按钮清除错误记录

后台运行

最小化到后台

点击窗口右上方的关闭按钮，可将打印服务放置到后台运行：

系统托盘操作

在 Windows 状态栏托盘图标上：

• 双击 或选择 Open：重新打开服务窗口
• 选择 Exit：结束打印服务

Linux 系统配置

安装步骤

1. 下载并解压 BaskReport 打印服务软件（Linux 版本）
2. 设置脚本可执行权限：

   chmod +x run.sh && ./run.sh
   

3. 安装并设置默认打印机

MacOS 系统配置

安装步骤

1. 下载并解压 BaskReport 打印服务软件（MacOS 版本）
2. 设置脚本可执行权限：

   chmod +x run.command && ./run.command
   

3. 安装并设置默认打印机

在 BaskReport 中调用

开启无预览打印功能

从 2.1.1 版本起，在 Web 预览工具栏配置中开启无预览打印服务选项：

勾选后，预览报表工具栏的打印项中会显示相关选项：

打印配置窗口

点击无预览打印按钮后，弹出配置窗口：

配置项说明：

配置保存

配置信息保存到浏览器 localStorage，如需重新显示配置窗口，删除对应存储项即可。

JavaScript API 调用

在 baskreport 的 npm 组件（0.1.7+ 版本）中，通过 BaskReport 对象的 doSlientPrint 方法调用无预览打印服务：

baskReport.doSlientPrint({
  host: '127.0.0.1',      // 打印服务器地址
  port: 56565,           // 打印服务端口
  copies: 1,              // 打印份数
  duplex: false           // 是否双面打印
});

详细文档请参阅 baskreport 组件文档。