菜单

报表使用动态参数

概述

在报表里,通过筛选可调整 SQL 语句中的部分条件,从而达到全局筛选某一特定条件下的报表数据的场景。

 

 

使用的条件

满足以下所有条件时,可在报表筛选器组里使用:

  1. 在自定义 SQL 里配置了动态参数且类型为字段表达式,保存成业务模型
  2. 该业务模型的调度模式为:实时

 

配置筛选器

支持的动态参数的筛选器类型:时间、文本。

 

自定义 SQL 配置动态参数

由于对应的自定义 SQL 为一个 where 条件的片段,分解为:动参字段名称 + 表达式 + 参数值,比如动参字段名为 “country”,类型为文本,表达式选择 “等于”,参数值填写 “中国”,那么生成的 SQL 片段为:${country} = ' 中国 ',当执行完成后,保存成业务模型后,该动参配置也会保存。报表筛选器选择动态参数后,会使用在自定义 SQL 中的 动参字段名称,不使用其配置的表达式,其参数值可以根据报表筛选器组的配置使用或不使用。

更多自定义 SQL 的配置见:动态参数

 

 

配置筛选

在报表 - 编辑页面,选择 “筛选器组”,如关联的图表组件符合上述使用条件,会展示出该业务模型里已有的动态参数,选择要关联的动态参数名称,比如选择上文举例中的动态参数名称”country“。

1、报表筛选器不会读取自定义 SQL 中的动参配置表达式,所以需要在右侧配置区,进行配置,选择表达式,表达式可以在查看报表页面进行切换。

2、候选值展示样式,如果选择输入框,在查看报表页面需要进行输入后方可查询;如选择提供选项,可设置下拉或平铺选择,单选或者多选。

3、候选值来源,如果选择了自动解析,则会获取关联图表们的字段里的所有数据(去重),如果其中有关联的是动态参数,会获取在自定义 SQL 里配置的动参候选值(如有显示名,使用显示名作为报表的候选值)。如选择仅解析主字段,且主字段选择的是图表中的动参字段,也会获取在自定义 SQL 里配置的动参候选值(如有显示名,使用显示名作为报表的候选值)。如果选择手动添加,以添加的候选值来展示在报表查看页。

 

筛选效果

在报表查看页,选择该筛选器,输入或选择想要查询的候选值,点击查询后,所关联的图表数据就会重新查询,获得想要的结果。

 

上一个
报表跳转
下一个
报表管理
最近修改: 2025-02-25