历史版本21 :参数的种类与区别 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

参数入门章节在线视频学习请查看【参数入门】
FineReport报表中的参数按照其使用范围可以分为:模板参数和全局参数;
按照其使用方式不同可以分为:模板参数和数据集参数。

2. 按照使用范围划分编辑

2.1 模板参数
模板参数是指在当前模板下创建的参数,在模板>模板参数中定义,只在当前报表中可以使用,且必须与过滤结合才能筛选数据,详情请查看模板参数
2.2 全局参数
全局参数是指在当前工程下创建的参数,在服务器>全局参数中定义,定义方法与模板参数相同,在工程下的所有报表中都可以使用,必须与过滤结合筛选数据。
注:定义的全局参数都保存在%FR_HOME%WebReport/WEB-INF/resources/config.xml文件中,若全局参数与模板参数相同,则采用模板参数。
另:按照使用范围划分的参数都必须与过滤条件结合使用。
2.3 区别
模板参数和全局参数的使用方式一致,但是两者的作用域不同。
全局参数:当前工程应用下的所有模板都可以使用。
模板参数:只有当前模板才可以使用。

3. 按照使用方式划分编辑

3.1 模板参数
与按照使用范围划分中的模板参数一样,讲述的是同一种参数。
3.2 数据集参数
数据集参数就是指在为模板添加数据集的时候添加的参数,一般是指在SQL查询语句中使用动态的参数对数据进行过滤。数据集参数根据使用范围不同分为模板数据集参数和服务器数据集参数。
1)模板数据集参数
是指在当前模板的模板数据集中添加的参数,在模板>模板数据集>数据库查询中定义,只在当前报表中可以使用,详情请查看数据集参数
2)服务器数据集参数
是指在服务器上数据集中添加的参数,在服务器>服务器数据集>数据库查询中定义,定义方法与数据集参数相同,在工程下的所有报表中都可以使用;
注:定义的服务器数据集参数都保存在%FR_HOME%WebReport/WEB-INF/resources/datasource.xml中,若服务器数据集参数与报表数据集参数相同,则采用报表数据集参数。
3.3 区别
模板参数和模板数据集参数的作用域相同,但是使用方式不同,模板参数和服务器数据集参数的作用域不同,使用方式也不同。
模板数据集参数是直接对返回的数据集起作用,所以用这种参数定义方法,你所得到的数据集是已经满足条件后的数据,因此无需设置过滤条件,只对当前模板起作用。
服务器数据集参数与模板数据集参数类似,唯一不同的是其对整个工程下的所有模板起作用,均可直接调用。
模板参数对取出来的数据集,是没有影响的,即所有需要的数据全部都取出来,然后调用参数来对格子中的数据进行过滤,从而使自己所需要的数据得以呈现,只对当前模板起作用。
结论:数据集参数就是直接取出满足条件的数据,而报表参数是取出全部数据后通过设置过滤条件再获取对应参数的数据,因此若数据量大的情况下使用数据集参数可以提高报表的访问效率。

4. 公用说明编辑

全局参数和服务器数据集参数都是所有模板共用的,这个共用表示:不管有多少个模板,参数只需要定义一次,但是使用时各个模板间是独立的。不是说在bs端给一张模板的全局参数赋值之后,其他模板都可以使用这个值。
下面我们以几个简单的示例详细介绍一下模板参数数据集参数全局参数的具体使用方式。

参数入门章节在线视频学习请查看【参数入门】

索引:

模板参数

数据集参数

全局参数