课程二十八：如何使用报表参数

说明：如何给报表加入变量，可以通过选择的方式展示报表的内容，这里要用到报表参数了。本课程以员工信息表为示例，按照年龄段来查找员工信息。

第一步：认识报表参数

单击菜单栏模板—模板参数，弹出模板参数设置对话框，

增加一个报表参数。

删除一个报表参数。

名称：报表参数的名称，可以用名称来做变量。

默认值：名称所对应的值。

数据类型：有字符串、整型、浮点、日期、布尔5种类型。

控件类型：控件类型有无、文本编辑框、下拉框、多选下拉框、下拉树、多选下拉树、日期框、复选框、自定义下拉框9种控件类型。

控件名称：可以对应默认值所代表的名称。

模板参数里面的控件不会在报表设计器和预览中显示，只有在模板上传后，用客户端打开后才能看显示使用。

步骤二：加入数据源

在数据源区点击，在数据集获取语句中输入：“select * from 员工信息”，把员工信息表加为数据源ds1。

步骤三：建立工作表

把数据源ds1中的数据集一次拖入工作表，在工作表的上方输入数据集的名称，给单元格居中、加入边框。为了方便查看年龄我们在数据集的最左边加入年龄数据集，在样式中选择升序排列，在工具栏中点击隐藏单元格，如下图：

步骤四：新建模板参数

在菜单栏点击模板—模板参数，弹出模板参数设置对话框，点击新建模板参数，名称为“age1”，默认值设置25，数据类型选择整型，控件名称设置为文本编辑框，控件名称设置为最小年龄。

点击新建模板参数，名称为“age2”，默认值设置40，数据类型选择整型，控件名称设置为文本编辑框，控件名称设置为最大年龄。

步骤五：在工作表中运用模板参数

选中数据源ds1，在数据源区点击，弹出数据源语句获取语句，原来的语句是：“select * from 员工信息”，现在修改成： “select * from 员工信息 where 年龄>=@{age1} and 年龄<=@{age2}”，在盈帆报表中用@{控件名称}来表示变量。

步骤六：预览报表

报表效果如下图，在预览图中不显示控件名称，模板参数的值为默认的，模板上传后，浏览报表可以手工输入年龄来确定年龄段。

步骤六：保存模板

点击文件菜单栏保存模板，模板命名为为报表参数。

注意：参数格式必须以字母（大小写）或下划线开头，由字母、数字、下划线组成。不建议用全大写字母加数字格式，如：A1，B1，容易与单元格混淆。

在模板参数设置成下拉树或多选下拉树时，子层设置数据源的格式可通过特殊参数指定。

如图，层次1的数据源是ds2，ds2的语句是“select 省份 from 城市销量 group by 省份”。层次2的数据源是ds3，ds3的语句是“select 城市 from 城市销量 where 省份='@{parentNodeValue}' group by 城市” 。

其中@{parentNodeValue}代表的是层次1的实际数据源的数据值。@{parentNodeValue}参数只在此处使用有效果。其他地方使用此数据源无效。