OpenAuth.Net/newdocs/docs/notes/pro/printerplan.md

---
title: 智能打印
createTime: 2025/04/23 23:43:26
permalink: /pro/printerplan/
---

OpenAuth.Net提供强大且灵活的低代码打印方案，企业用户仅需进行简单配置（可能需要编写SQL查询）即可实现个性化打印需求，无需开发人员参与即可快速部署各类打印模板。

## 系统界面展示

### 打印模板设计界面

专业的设计工作台，支持拖拽式操作与精确配置：

![sysprinterplan](http://img.openauth.net.cn/sysprinterplan.png)

### 业务系统集成效果

无缝集成到各类业务功能模块中：

![20231002114914](http://img.openauth.net.cn/20231002114914.png)


## 详细使用指南

### 创建与设计打印模版

在【打印中心】-【打印模版】功能中新增打印模版。设计界面布局如下：

![20231004165652](http://img.openauth.net.cn/20231004165652.png)

界面分为三大区域：
- 左侧：设计工具栏，提供各类控件与格式设置工具
- 中间：设计画布，实时预览打印效果
- 右侧：属性配置区，精确调整各元素参数与样式

用户可根据实际需求，通过拖拽与配置快速构建专业打印模板。

### 配置数据源

数据源是打印模版的核心，通过合理设计数据源，实现真正的低代码打印解决方案：

![20231004165939](http://img.openauth.net.cn/20231004165939.png)

关键配置项说明：

1. **数据源**：用于查询打印数据的SQL语句，支持复杂查询与条件筛选
   
2. **Id参数**：系统根据数据源SQL自动生成的参数文本框，用于动态传递查询条件
   
3. **分组字段**：决定打印模版的类型与数据结构处理方式
   - 配置分组字段：生成列表式打印模版（一对多数据结构）
   - 不配置分组字段：生成卡片式打印模版（单条数据记录）

### 打印模式类型说明

系统支持两种主要打印模式，适应不同业务场景：

* **卡片式打印**：适用于单条记录的打印场景，如快递标签、会员卡、用户名片等
  ![20231004164125](http://img.openauth.net.cn/20231004164125.png)

* **列表式打印**：适用于主从结构数据的打印场景，一页包含多条关联数据，如销售订单、发货清单等
  ![20231004164203](http://img.openauth.net.cn/20231004164203.png)

::: warning 特别说明

两种模版类型在底层处理上存在灵活性。当配置了`分组字段`时，后端将自动将数据按该字段进行分组，转化为主从结构。例如，上图展示的【入库随货同行单（列表式）【带参数】】正是通过按OrderId分组后生成的数据结构。

:::

### 打印方案与功能模块关联

完成打印方案设计后，需在【模块管理】功能中将打印方案与业务功能关联，实现功能集成：

![20231004173811](http://img.openauth.net.cn/20231004173811.png)


### 实际打印操作

完成上述配置后，用户可在相应业务功能中直接调用打印方案，实现一键打印：

![20231002114914](http://img.openauth.net.cn/20231002114914.png)

## 最佳实践建议

1. 设计数据源时，建议先测试SQL查询结果，确保数据结构符合预期
2. 打印模板设计时注意适配不同纸张规格，预留适当边距
3. 对于复杂报表，可考虑使用分组字段实现数据的合理组织
4. 利用系统提供的预览功能，及时调整布局与样式