参数查询入门示例

1.1 预期效果

参数的主要作用是实现用户与数据的实时交互，即进行数据的过滤。我们可以在很多情况下使用参数，比如在单元格中引用参数来实现动态标题、根据参数值的不同显示不同值等等。如下图所示：

1.2 实现思路

设置模板参数，使用参数面板，通过参数控件实现数据过滤。

1.3 视频教学

2.1 模板准备

1）新建普通报表，新建数据集 ds1 ，SQL 语句为：SELECT * FROM 销量。

2）点击「模板>模板参数」，在弹出的「模板参数」设置页面中，点击添加按钮添加参数。

3）双击左侧的页面中双击参数名称，将参数名设置为「地区」，在右侧的默认值处，设置默认值为「华北」，点击「确认」。

4）合并 A1~C1 单元格，添加公式：$地区 + "销售额"，使标题显示为选中的地区名称加“销售额”，例如：华北销售额。

5）A2、B2、C2 分别输入：地区、销售员、销量，并将数据集 ds1 中对应的数据列拖入到 A3~C3 单元格中，调整单元格的大小。

6）选择 C3 单元格，选择「单元格元素>基本>数据设置」，选择「汇总」、「求和」。

2.2 控件设置

2.2.1 添加控件

1）点击编辑参数面板，在右侧是组件设置中选择「全部添加」。

2）将控件设置为下拉框控件。

2.2.2 设置控件

1）选中标签控件，控件值为「地区:」。

2）选中下拉框控件，控件名称为「地区」，数据字典类型设置选择「数据查询」，数据集为 ds1 ，实际值和显示值列名相同均选择「地区」。

注：下拉框控件名称需要与设置的模板参数名称一致。

2.3 添加过滤

双击 A3 单元格，添加过滤条件：地区等于参数「$地区」，使单元格中内容根据下拉框选择的地区名称进行过滤。

2.4 效果查看

2.4.1 PC 端

保存模板，点击分页预览，效果如下图所示：

2.4.2 移动端

App 及 HTML5 端效果如下图所示：

已完成的模板，可参见：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Primary\Parameter\参数引用.cpt

点击下载模板：参数引用.cpt