1. 概述
1.1 版本
报表服务器版本 | 功能变更 |
---|---|
11.0 | - |
11.0.19 | 当常用参数组合中存在密码控件时,对密码控件进行加密 |
1.2 应用场景
在参数很多的时候,每次打开模板都要将每个参数都选择一遍,再查询,这样操作很繁琐。大多数情况下,用户所使用的参数组合是比较固定的。因此在FR 11.0 里,可以保存历史参数组合,同时智能判断并推荐参数组合。
1.3 注意事项
1)常用参数组合根据模板 ID 存储,因此对模板进行替换、另存为等操作后,新模板不会继承之前保存的常用参数组合设置;如果直接复制原模板,新模板会继承常用参数组合设置,且修改常用参数组合时,新模板和原模板会同步修改。
2)需要登录状态下才可使用常用参数组合。如果发现模板未显示常用参数组合,可以通过 fine_username 参数来确认是否为登录状态。
3)不支持移动端和新计算引擎/行式引擎。
2. 使用常用参数组合
打开模板%FR_HOME%\webroot\WEB-INF\reportlets\doc\Parameter\下拉框参数联动.cpt
进入参数面板的编辑状态,在属性面板中勾选「使用常用参数组合」,如下图所示:
登录决策系统,比如管理员或普通用户,登录后预览模板,就可以设置常用参数组合,如下图所示:
注:需要登录状态下,才会显示参数组合功能,系统会根据用户来保存设置的参数组合。
在点击常用参数对控件进行赋值时,不会触发控件的「编辑结束」事件,11.0.5 及以后可以通过在参数面板上勾选触发编辑结束事件按钮后触发。如下图所示:
如想要实现切换参数组合后自动查询报表。首先需要给参数控件添加一个能够自动触发查询的「编辑结束」事件,然后勾选「触发编辑结束事件」就可以实现切换后自动查询报表。如下图所示:
控件「编辑结束」事件中的 JavaScript 代码如下:
_g().parameterCommit();
2.1 保存新参数组合
设置参数,地区:华东、省份:江苏、城市:南京,点击「保存为常用参数组合」,弹出对话框,输入组合名称,点击「确定」,这样一个参数组合就保存完成,如下图所示:
保存后,预览模板时选择「组合一」,控件自动填写组合一中保存的控件值,效果如下图所示:
注:一个用户一张模板最多只能保存 9 个参数组合(包含智能推荐),超过 9 个会弹出警告“参数模板最多保存 9 个”。
2.2 修改原参数组合
选中组合一,将城市修改为无锡,点击「保存为常用参数组合」,弹出对话框,点击「保存」即可。如下图所示:
2.3 排序
鼠标选中组合一,拖动到组合二和组合三中间,松开鼠标,这样组合一就移动到了组合二、组合三的中间,如下图所示:
2.4 删除
选中某个组合,点击「删除」,确认即可,如下图所示:
2.5 重命名
双击组合名,对参数组合进行重命名,如下图所示:
3. 智能推荐
根据用户的历史操作记录——使用过的参数组合(保存在 fine_record_param 表),默认推荐近七天,使用次数排名前 2 且近七天使用次数需要大于 7 次的参数组合。
从启动服务器开始,第一个 00:01 推荐一次,之后每隔 24 小时推荐一次,如下图所示:
注:已经保存的组合不会再推荐。
4. 涉及到的表
4.1 fine_param_template
将不同用户所保存的参数组合存于 FineDB 的 fine_param_template 中,如下表所示:
字段 | 含义 |
---|---|
templateid | 模板 ID |
username | 用户名 |
tpgroup | 参数组合 |
TPGROUP 用 JSON 格式存储加密后的推荐参数组合信息,解密后如下所示:
name:推荐参数组合的名字
id:控件id
value:实际值
encrypt:判断是否加密,false 为非密码控件不加密,True 为密码控件进行加密
type:是否为智能推荐
注:data 中数据的顺序是有意义的,越靠前表示越常用,界面上靠前放。
{
name: 'xxx',
data: {
id1 : 'value1',encrypt:'flase'
id2 : 'value2',encrypt:'flase'
...
id9 : 'value9',encrypt:'flase'
}
type:'flase'
}
4.2 fine_record_param
将不同用户的历史使用明细情况存于 LogDB 中 fine_record_param 中,如下表所示:
字段 | 含义 |
---|---|
templateid | 模板ID |
username | 用户 |
pgroup | 参数(值以数组展示:参数 1:参数值,参数 2:参数值) |
time | 记录时间 |