［通用］设置顶部参数面板

1.1 版本说明

1.2 预期效果

模板默认参数界面是通过底部参数界面的漏斗过滤按钮调用的，点击后会跳转到新的页面编辑参数，再进行查询。

部分用户可能不习惯该交互，希望参数界面能够直接在报表主体中显示，选择参数等也不需要进行页面跳转。如下图所示：

注：标签控件不支持移动端的参数面板。

1.3 实现方法

用户可以设置「顶部参数面板」，自由选择参数面板的位置。

移动端预览参数界面直接显示在主体中，选择参数后，自动刷新下方的报表数据，适用于数据量不多，参数个数较少且无复杂自定义控制的参数界面模板下。

2.2 模板设置

在报表设计器中，可以对 CPT 和 FRM 模板参数界面设置显示样式为「顶部」样式。

打开模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\demo\Phone\parameter\参数查询-phone.cpt

点击编辑「参数面板」，点击「移动端」，参数面板选择「顶部」，默认「自动查询」点击取消勾选，完成点击「确定」。如下图所示：

注：勾选了「自动查询」，设置了某个条件后，会立即进行查询，详情可参见 4.3.2 节。

2.3 移动端预览

保存模板，选择「移动端预览」。

2.3.1 App

App 效果与本文 1.2 章节「预期效果」一致。

2.3.2 HTML5

注：部分版本不支持 HTML5 端的顶部参数面板，具体请参考本文1.1 版本章节。

「顶部参数面板」在模板中的具体使用及效果，可点击下载：参数查询.zip

4.1 数据筛选效果

若参数面板中存在文本控件时，参数面板选择顶部，顶部显示筛选按钮，点击后从侧边栏进行输入查询，移动端效果预览效果如下图所示：

4.2 控件显示效果

10.4.975 版本对顶部控件的显示效果进行了优化，优化点如下：

4.2.1 控件初始化显示规则

• 控件有默认值：显示设置的控件值。（如果多值控件设置了多个默认值，则显示第一个值+选中个数）
  

• 控件无默认值：按水印>标签名称>都为空的顺序来显示，对应的设置位置如下图所示：

示例效果如下图所示：

4.2.2 选中值显示规则

• 单值控件：切换后显示选中的值。

• 多值控件：切换后显示第一个值+选中个数，其中选中个数图标代替初始化选值图标。

4.3 条件筛选优化

10.4.976 版本对较多筛选条件的显示效果进行了优化，优化点如下：

4.3.1 多条件筛选

当条件数<=4时，所有条件都可以直接显示在一行，如下图所示：

当条件数>4时，多出的条件会收纳到「更多」里，用户可以下拉设置其他条件，如下图所示：

4.3.2 自动查询

样式模板选择「顶部」时，点击右侧的编辑按钮，可以选择是否开启数据自动查询，如下图所示：

勾选了「自动查询」，设置了某个条件后，会立即进行查询，效果如下图所示：

不勾选「自动查询」，设置了某个条件后，需要点击右边的查询按钮，才能进行查询，如下图所示：