java报表开发工具FineReport教程之参数入门：参数的种类与区别.docx

java报表开发工具FineReport教程之

参数入门：参数的种类与区别【1】模

板参数

java报表开发工具FineReport教程之参数入门：参数的种类与区别【1】模板

参数

参数入门

1.描述

在大多数情况下，我们并不需要报表把数据库中所有的数据都呈现出来，而是

要根据一些条件来过滤出我们想要的数据，这就是参数查询。

FineReport报表中就是使用参数来动态的过滤数据的，实现用户和数据的实时

交互，如下图：

注：鼠标移至参数界面的中间区域会出现收缩按钮，折叠或展开参数查询界面。

2.如何实现参数查询

几乎所有的统计报表都会有类似上图的统计条件，传统的做法是使用如ext、

html等编程实现，工作量大且维护成本高。

FR报表只需要通过参数的定义，添加参数控件绑定数据、参数过滤和参数面板

样式四个步骤便可以轻松实现参数查询，零代码，维护简单。

3.实现步骤

FR报表提供了参数界面的概念，让用户快速制作出参数表单界面，制作参数查

询界面的步骤如下：

参数定义：设置参数名称，添加参数，根据实际情况的不同添加不同种类的参

数，详细请查看参数的种类与区别。

添加控件绑定数据：FineReport参数查询，是在参数面板中添加控件，使控件

名字与参数名称一样，通过该控件将其控件值传递给参数，实现动态修改参数

值得效果，可为控件绑定数据，直接选择；

参数面板样式设定：设置参数界面中控件的位置，参数面板的位置，背景等等。

参数入门在线视频请查看【参数入门】

参数的种类与区别

1.描述

FineReport报表中的参数按照其使用范围可以分为：模板参数和全局参数；按

照其使用方式不同可以分为：模板参数和数据集参数。下面详细介绍。

2.按照使用范围划分

2.1模板参数

模板参数是指在当前模板下创建的参数，在模板模板参数中定义，只在当前报

表中可以使用，且必须与过滤结合才能筛选数据，详情请查看模板参数

2.2全局参数

全局参数是指在当前工程下创建的参数，在服务器全局参数中定义，定义方法

与模板参数相同，在工程下的所有报表中都可以使用，必须与过滤结合筛选数

据；

注：定义的全局参数都保存在WEB-INFresourcesconfig.xml文件中，若全局参

数与报表参数相同，则采用报表参数。

另：按照使用范围划分的参数都必须与过滤条件结合使用。

2.3区别

模板参数和全局参数的使用方式一致，但是两者的作用域不同。

全局参数：当前工程应用下的所有模板都可以使用。

模板参数：只有当前模板才可以使用。

3.按照使用方式划分

3.1模板参数

与按照使用范围划分中的模板参数一样，讲述的是同一种参数。

3.2数据集参数

数据集参数就是指在为模板添加数据集的时候添加的参数，一般是指在SQL查

询语句中使用动态的参数对数据进行过滤。数据集参数根据使用范围不同分为

模板数据集参数和服务器数据集参数。

模板数据集参数

是指在当前模板的模板数据集中添加的参数，在模板数据集数据库查询中定义，

只在当前报表中可以使用，详情请查看数据集参数

服务器数据集参数

是指在服务器上数据集中添加的参数，在服务器数据集数据库查询中定义，定

义方法与数据集参数相同，在工程下的所有报表中都可以使用；

注：定义的服务器数据集参数都保存在WEB-INFresourcesdatasource.xml中，

若服务器数据集参数与报表数据集参数相同，则采用报表数据集参数。

3.3区别

模板参数和模板数据集参数的作用域相同，但是使用方式不同，模板参数和服

务器数据集参数的作用域不同，使用方式也不同。

模板数据集参数：是直接对返回的数据集起作用，所以用这种参数定义方法，

你所得到的数据集是已经满足条件后的数据，因此无需设置过滤条件，只对当

前模板起作用。

服务器数据集参数：与模板数据集参数类似，唯一不同的额是其对整个工程下

的所有模板起作用，均可直接调用。

模板参数：对取出来的数据集，是没有影响的，即所有需要的数据全部都取出

来，然后调用参数来对格子中的数据进行过滤，从而使自己所需要的数据得以

呈现，只对当前模板起作用。

结论：数据集参数就是直接取出满足条件的数据，而报表参数是取出全部数据

后通过设置过滤条件再获取对应参数的数据，因此若数据量大的情况下使用数

据集参数可以提高报表的访问效率。

4.