1. 描述编辑
在线视频学习请查看:参数入门示例。
模板参数是只适用于当前报表的参数,需要与数据列的过滤条件结合使用。即通过数据集取出所有数据,在实现数据查询时使用模板参数过滤出有用的数据。
这篇文档通过在报表中设置模板参数进而实现数据查询效果。
2. 示例编辑
2.1 示例效果
文本框中输入「华东」,点击查询,只查询出报表中华东地区的销售信息。
文本框中输入「华北」,点击查询,只查询出报表中华北地区的销售信息。
2.2 数据准备
新建数据集 ds1,数据库查询对话框中写入 SQL 查询语句SELECT * FROM 销量,取出销量表中的所有数据。
2.3 表格样式设计
1)A1~C1 单元格写入表格标题信息,选中 A1~C1 单元格,右边属性面板选择单元格属性>样式,样式下拉框选择预定义样式,给标题设置一个Head类型的样式。
注:设置好 Head 类型的样式后,标题字体会自动居中,无需另外设置。
2)将数据集中的字段拖入到对应单元格中,选中 A2~C2 单元格,将字体居中,选中 A1~C2 单元格,给表格整体添加预定义样式默认的天蓝色内外框。
3)选中 C2 单元格,右边属性面板选择单元格元素>基本。数据设置下拉框选择汇总>求和。
2.4 定义模板参数
1)菜单栏选择模板>模板参数,打开模板参数设置对话框。
2)模板参数对话框点击增加按钮,新建一个模板参数,双击该参数将它重命名为「地区」,设置默认值为「华东」。点击确定完成模板参数的定义。
如果想要修改模板参数名称,只能通过双击原名称进入编辑状态后进行修改,修改完后点击确定即可,如下图所示:
2.5 参数添加控件
1)点击参数面板的编辑按钮,进入参数面板设置界面。
2)右上角控件设置面板会显示没有添加控件的参数,点击地区或者点击全部添加,将参数的默认控件添加到参数面板。
注:参数与控件是通过参数名称进行绑定的,也就是说当控件名称与参数名称一致时,参数与控件就进行了绑定,即在 Web 端给控件赋值就相当于给参数赋值。
3)参数「地区」的默认控件添加到参数面板后,效果如下图所示:
注:如果不想点击「全部添加」或「参数」快捷添加默认控件,也可以直接从控件栏中将控件拖拽到参数面板中,修改控件的名称与参数名称一致,即可将控件与参数进行绑定。
4)点击自定义控件的编辑按钮,选择文本框控件类型,让用户自行输入参数值。
5)将查询按钮往左边拖拽,形成紧凑式布局,让控件面板更加美观。再次点击参数面板的编辑按钮,完成参数控件的设置。
2.6 数据过滤
设置好控件后还不能实现根据文本框中输入的参数值查询指定地区的销售信息。因为数据集中的数据是将数据库中的数据全部取出来,表格的数据来源于数据集,所以需要给表格设置数据过滤条件,当用户在文本框中输入地区参数值点击查询时,表格只显示该地区的销售信息。
双击 A2 单元格,在弹出的数据列对话框中选择过滤,添加一个普通条件,让数据列地区等于参数$地区,点击增加按钮,点击确定。即将地区单元格与参数绑定起来。
3. 效果预览编辑
3.1 PC端
保存报表,分页预览查看报表。
文本框中输入「华东」,点击查询,只查询出报表中华东地区的销售信息。
文本框中输入「华北」,点击查询,只查询出报表中华东地区的销售信息。
3.2 移动端
移动端查看报表的方式参见 报表移动端预览。
文本框中输入「华东」,点击查询,只查询出报表中华东地区的销售信息。
文本框中输入「华北」,点击查询,只查询出报表中华东地区的销售信息。
4. 已完成模板编辑
已完成模板可参见:%FR_HOME%\webroot\WEB-INF\reportlets\demo\NewbieGuide\模板参数.cpt
点击下载模板:模板参数.cpt