1. 概述编辑
1.1 应用场景
当一个组件使用的原始数据是带了参数的 SQL 数据集,那么用过滤组件在对该组件进行过滤时,操作方式不同于正常情况,本文将详细介绍。
1.2 功能简介
过滤组件的参数用法是实时数据(直连数据库)特有的功能。
注:不支持表名或者字段名中等对表结构有影响的位置添加参数。目前仅有文本过滤组件和日期类过滤组件提供绑定参数功能。
2. 参数使用示例编辑
2.1 制作组件
用带参数的 SQL 数据集制作组件
2.1.1 准备数据
1)在数据准备>业务包下选择添加SQL数据集(注:只有数据处理用户才能添加 SQL 数据集),如下图所示:
2)添加带参数的 SQL 数据集。
本示例数据使用 BI Demo 的 new_dian,输入带参数的 SQL 语句,select * from new_dian where 店性质 in ('${店性质参数}'),点击刷新获取参数输入「店性质参数」的默认值为自有店。再点击右侧预览,如下图所示:
3)点击右上角确定保存该 SQL 数据集,为该表开启实时数据,如下图所示:
2.1.2 使用 SQL 数据集制作组件
1)利用带参数的 SQL 参数制作一个组件,例如制作一个明细表,如下图所示:
2.1.3 进入仪表板
点击进入仪表板进入仪表板编辑界面,如下图所示:
此时便可以在前端过滤组件中绑定该参数了。过滤组件绑定参数分为两种:
过滤组件不绑定字段,仅绑定参数;
过滤组件绑定字段和参数。
2.2 过滤组件仅绑定参数
2.2.1 操作步骤
1)新增文本过滤组件,如下图所示:
2)绑定「店性质参数」,如下图所示:
注:所有 SQL 数据集获取的参数都在③这个下拉框中,因此参数最好不要用一样的参数名。
2.2.2 效果展示
当文本过滤组件为空时,明细表中也无数据,如下图所示:
在文本下拉框中可以输入自己要的字段,例如输入「管理店」并回车,明细表自动过滤出店性质为管理店的数据,如下图所示:
2.3 过滤组件绑定字段和参数
【过滤组件只绑定参数】只能通过手输进行过滤,若是需要有下拉框则需要绑定字段(这个字段用来提供下拉框内容)。
有以下要求:被绑定字段所在的表不能有「店性质参数」
2. 绑定参数处同样是勾选并绑定之前设置的店性质参数。点击确定保存该文本过滤组件设置。
进入仪表板,可以看到该文本过滤组件中可以选择店性质的字段数据,如下图:
3. 选中两个,点击确定,出来的结果都是对应店性质的门店数据。
注:此处不用带参数的门店信息表的店性质字段拖入文本过滤组件中,是因为此时“门店信息表(有参数的)”取过来数据库的数据,是店性质为设置的默认值自有店的门店信息。所以文本框下拉出来的值也只有自有店。不包括所有店性质的字段值。
3、过滤组件的两种用法编辑
过滤组件有两种用法:上面介绍的参数绑定的用法和普通过滤组件的用法,默认情况下过滤组件的功能为参数控件和普通控件只有一个生效。若想要同一个过滤组件两种功能同时实现的效果,可去管理系统>系统管理>常规中的BI参数设置框,开启参数控件过滤生效按钮,如下图: