1. 概述
1.1 版本
FineBI版本 | 功能变动 |
6.0 | - |
6.0.10 | 参数支持设置默认值,在组件界面根据默认值对数据进行过滤,方便用户进行数据校验 |
6.0.16 | 过滤组件绑定SQL参数功能优化 1)参数显示优化:
2)参数绑定优化
|
1.2 功能简介
在组件设置内可以新增参数并进行绑定,在仪表板中过滤组件也绑定参数,可以实现对目标组件传值的功能。
2. 应用场景
目前可以绑定参数进行传值的过滤组件有:时间过滤组件、文本组件、数值下拉组件。
2.1 计算字段中使用参数
在计算字段中使用参数参与计算,在过滤组件中绑定参数实现动态控制计算字段结果值。详情参见:计算字段中使用参数动态控制计算字段结果值。
例如:用户可以用过滤组件绑定参数进行传值,动态更改大订单和小订单的衡量标准,当数值下拉组件的值为 2000000 时,2000000 被传参到组件内部实现计算比较,合同金额大于 2000000 的订单为大订单,数量为 41 。如下图所示:
2.2 字段过滤绑定参数
在组件编辑界面对字段进行过滤过程中绑定参数,过滤组件也绑定参数,即可实现对字段过滤进行传参。详情可见:字段过滤绑定参数实现动态过滤数据。
例如,在数值下拉中输入数值 5 ,过滤出销售额前 5 名的店名;输入数值 9 ,过滤出销售额前 9 名的店名,如下图所示:
2.3 明细过滤绑定参数
在指标明细过滤中绑定参数并设置过滤条件,过滤组件绑定参数,可以实现动态过滤。详情可见:动态计算某时间段内的新增数、动态展示过滤组件值前后一段时间的数据、动态展示天/周/月/年数据
例如:默认显示距离当前时间前 15 天的数据,对日期过滤组件设置过滤条件后,数据也显示过滤条件前 15天的数据。
选择过滤条件为「2020-12-01」,则显示「2020-12-01」之前 15 天的数据,如下图所示:
3. 参数类型
在组件设置内新增创建参数,可对参数名称进行修改,参数类型包括日期、文本、数值,创建对应类型后不支持修改类型,新增参数有两种方式,如下图所示:
新增组件参数,如下图所示:
6.0.10版本 FineBI 支持设置组件参数默认值,组件界面会根据该值对添加了参数的字段进行过滤。方便用户进行数据校验。
新增组件参数后出现参数模块,此时可以在参数模块新增参数,如下图所示:
4. 使用或绑定组件参数规则:
参数暂时不支持单独作为字段拖入组件中使用
字段明细过滤、字段过滤绑定参数需要具备匹配关系:对应设置内容属于文本值的只能绑定文本参数,属于数值值的只能绑定数值参数,属于日期值的只能绑定日期参数,如果文本字段的过滤设置前N项,则绑定参数字段为数值参数
一个过滤组件支持绑定多个参数字段;同一个仪表板同一个组件参数只能被一个过滤组件绑定一次,绑定过后显示灰化
在仪表板中过滤组件绑定参数,根据对应过滤组件类型,对应显示相应类型的组件参数,如日期过滤组件,仅展示日期类型参数,如下图所示:
5. SQL 参数
在过滤组件编辑界面中,可以绑定 SQL 参数。
支持绑定 SQL 参数的过滤组件有,数值下拉过滤组件,文本过滤组件以及时间过滤组件。
关于 SQL 参数的使用,可参见:SQL 数据集参数。
日期区间、年月区间仅支持按开始区间、结束区间绑定参数,按照年月区间绑定会提示:不支持绑定 SQL 参数,如下图所示: