SpringReport--报表设计器的使用

1、报表模板创建

要进行报表设计，首先需要创建一个报表模板，找到报表模板模块，新增即可。其中报表模板中有以下几个属性需要进行特殊说明：

报表标识：全局唯一，不能重复

查看权限：查看权限有所有人可查看和指定角色查看两个选项，如果选择所有人可查看，那所有的用户都可以查看该报表。

如果选择指定角色查看，则需要进行角色配置，只有有对应角色的用户才可以查看报表。

设计密码：打开设计页面时是否需要输入密码，如果设置了密码则打开设计页面时需要输入正确的密码才可以进行设计

导出是否加密：导出的excel文件是否需要加密，如果选择是，则导出excel文件时需要设置excel文件的打开密码，下载excel文件打开时需要输入正确的密码才可以打开excel文件。

2、报表设计

在报表模板页面点击报表设计进入报表设计页面，报表设计页面主要由三部分组成，左侧是数据集，中间是设计区域，使用的是luckysheet，

右侧是单元格的一些自定义属性和报表属性。

2.1添加数据集

初始化进来时需要先添加数据集，点击添加数据集弹出数据集页面，数据集页面分两个tab页，sql语句和参数配置

sql语句：选择数据源，数据源是创建模板时绑定的数据源，sql类型分两种类型，标准sql和存储过程两种。

在中间书写区域书写sql，如果sql中有参数，则参数的规则是${参数编码}，参数编码是【参数配置】tab页中对应的参数编码，例如

where name = ${name},格式化按钮可以帮助美化写的sql，执行按钮可以校验写的sql是否正确并且解析sql返回的字段，如下图

2.2参数配置

当sql类型是标准sql时，有分页参数和字段参数两部分，

当sql类型是存储过程是，有输入参数和输出参数两部分

分页参数：选择是，则需要设置每页显示条数，查看报表的时候页面上也会有分页查询条件

字段参数：字段参数对应sql中的参数，sql中如果有参数，需要在字段参数中也进行添加，添加后报表查看页面可以显示这些参数并可以进行数据查询。可以设置参数的默认值和是否必填。

3、报表设计

添加完数据集后会在主页面上显示出添加的数据集和对应的解析字段。

在中间表格区域设计表格的显示样式，静态数据直接自己手写即可，动态表格数据则直接单击左侧对应的解析字段拖动到对应的单元格即可。

具体的样式可以通过上方的工具栏进行操作。

自定义单元格属性

扩展方向：支持不扩展，向右扩展，向下扩展，交叉扩展四种方式，默认是不扩展

静态数据单元格及时设置了向右扩展，向下扩展或者交叉扩展，也不会进行扩展，扩展是针对动态的数据设置的

不扩展：数据只会显示到一个单元格，及时有多条数据也只会显示第一条数据

向右扩展：多条数据时数据会自动向右扩展，将数据全部展示出来

向下扩展：多条数据时数据会自动向下扩展，将数据全部展示出来

交叉扩展：数据会向同时向右和向下扩展

聚合方式：列表，分组，分组汇总，汇总四种方式

列表：数据会以列表的方式全部展示出来

分组：相同的数据会进行分组，并且进行单元格合并

分组汇总：相同的数据会进行分组，并且需选择汇总方式，汇总方式支持合计，平均值，最大值，最小值，计数五种方式。

报表属性：

数据集参数是否合并：如果选择合并，则查看报表时多个数据集的参数会合并成一个tab页显示，如果不合并，则查看报表时每个数据集的参数都是独立分开的，会显示多个tab页

添加循环块：可以将某一部分单元格设置成循环块，设置成循环块部分的单元格会一起进行向下扩展

4、报表设计以及展示demo

4.1普通扩展报表设计以及展示

4.2分组汇总报表设计以及展示

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GxQp60j2-1658914548180)(https://upload-images.jianshu.io/upload_images/26840554-7e5deac61010cbe7.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

4.3交叉扩展报表设计以及展示

4.4循环块报表设计以及展示