历史版本12 :数据集参数 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
目录:
1. 数据集参数原理编辑
类似通信、监控行业，每天都有海量数据生成，数据库表中总数据量非常大，而报表中往往只要当天的几百条数据就可以了。
如果使用模板参数，就需要先取出所有数据，再进行过滤，取数+过滤，将消耗大量时间；
1)简单应用
可以在定义数据集sql的时候，直接使用where条件过滤出需要的数据，从而大大缩短报表取数时间，类似下面的sql：
SELECT * FROM 销量 where 地区 = '${地区}'
2)带公式的应用
数据集sql中可以使用参数宏${}动态地生成过滤条件，${}中的语句在FineReport报表中执行，将${}的执行结果与sql语句拼接起来形成最终的查询语句，传递给数据库执行，可以使用多个${}，如下语句：
SELECT * FROM 订单 where 1=1 ${if(len(area) == 0,"","and 货主地区 = '" + area + "'")} ${if(len(province) == 0,"","and 货主省份 = '" + province + "'")}
${}中可以使用所有内置的FR公式，如if函数；
${}中除了FR内置的函数名、常量外，其他变量就是数据集参数。
如上SQL语句，if公式是FR内置的公式，变量area就是数据集参数，如果len(area)!=0，即area参数不为空，比如说area的值为华东，那么if语句的执行结果为and 货主地区='华东'，然后再把这句话拼接到SQL语句当中，SQL语句就变成：
SELECT * FROM 订单 where 1=1 and 货主地区='华东'
2. 制作步骤编辑
2.1 打开报表
打开报表%FR_HOME%\WebReport\WEB-INF\reportlets\doc\Primary\GroupReport\Group.cpt。
2.2 定义数据源参数
修改数据集SQL语句为SELECT * FROM 销量 where 地区 = '${地区}'，点击下方的刷新按钮显示出参数，默认值设置为“华北”：
注：在数据集SQL语句中，使用${para}做为一个参数宏，其中变量para为参数名，若字段值为字符串则加上引号如'${para}'。
2.3 过滤数据
若参数地区的值为华北，那么${地区}这个参数宏最终的值就是华北，数据集SQL即为SELECT * FROM 销量 where 地区 = '华北'；
可以看出，数据集取数时就会根据数据源参数过滤出需要的数据，因此不需要额外设置数据列过滤了。
2.4 制作参数界面
切换到参数界面，添加参数。
注：如果参数控件是通过点击右上角的以下参数未生成按钮生成的，那么数据集参数的默认值，可以传到参数面板的控件中。
注：如果参数控件是直接添加控件，修改控件名和参数绑定的，数据集参数的默认值无法传递到参数面板的控件中，控件默认值需要另外设置，详细请参照控件默认值
2.5 保存报表并发布
保存报表并分页预览，便可以看到效果。
模板效果在线查看请点击Parameter_1.cpt
已完成的模板，可参见%FR_HOME%\WebReport\WEB-INF\reportlets\doc\Primary\Parameter\Parameter_1.cpt
注：若模板中有多个数据集并且定义的参数名相同，在参数界面中可以通用一个参数控件。即若数据源参数名称相同，只需定义一个参数控件即可。