目录:
1、描述编辑
过滤组件的参数用法是实时数据(直连数据库)特有的功能,因为实时数据是将前端页面上的交互式拖拽操作转成不同数据库查询语言的过程,所以通过参数的功能,能实现返回动态SQL的效果。过滤组件绑定参数后,当输入或选择数据时,将参数带入sql实时传递给数据库执行,从而实现过滤效果,是一个向数据库重新请求结果的过程。
注:不支持表名或者字段名中等对表结构有影响的位置添加参数。目前仅有文本过滤组件和日期类过滤组件提供绑定参数功能。
2、参数使用示例编辑
2.1 数据准备
1. 在数据准备>业务包下选择添加SQL数据集,如下图:
注:此步骤需要数据处理用户操作。
2. 输入带参数的SQL语句,比如添加获取店性质参数的门店表(select * from new_dian where 店性质 in ('${店性质}')),点击刷新获取参数并输入默认值,获取数据预览,如下图:
3. 点击右上角的确定保存该数据表设置。为该表开启实时数据按钮,如下图:
此时我们便可以在前端过滤组件中绑定该参数了。过滤组件绑定参数分为两种:1、过滤组件不绑定字段,仅绑定参数;2、过滤组件绑定字段和参数。下面分别介绍。仅绑定参数实现的是在过滤组件中手动输入值进行参数过滤,绑定字段和参数实现的是在过滤组件中选择字段值进行过滤。
2.2 过滤组件仅绑定参数
1. 新建仪表板,在仪表板的组件中拖入刚刚创建的门店信息表中的字段,如下图,可以看到该组件显示数据为之前设置的店性质默认值自由店的数据。
2. 我们新增一个文本过滤组件,勾选绑定参数,再点击旁边的设置按钮,出现参数的配置框。选中想要绑定的参数,这里选择店性质,如下图所示:
注:此时所有sql数据集获取的参数都在这个下拉框中,因此不是一个作用的参数最好不要用一样的参数名。
3. 点击确定保存该过滤组件设置,此时实现的效果是文本过滤组件不绑定字段。
回到仪表板界面,因为文本过滤组件没有绑定字段,所以文本过滤组件的下拉列表是空的。需要我们自己手动输入店性质。比如我们输入管理店,回车。此时下面的数据就变成了店性质为管理店的门店信息,如下图:
2.3 过滤组件绑定字段和参数
过滤组件绑定字段和参数是为了实现在过滤组件下拉时,可以直接选择数据进行参数过滤。
1. 选择之前新建的文本过滤组件,进入其详细设置界面,为其绑定字段“店性质”,且该店性质字段不能为之前设置的带参数的字段(需要另外创建一张不带店性质参数的门店信息表,此处可直接使用零售行业(实时数据)>门店信息下的店性质字段)。如下图:
2. 绑定参数处同样是勾选并绑定之前设置的店性质参数。点击确定保存该文本过滤组件设置。
进入仪表板,可以看到该文本过滤组件中可以选择店性质的字段数据,如下图:
3. 选中两个,点击确定,出来的结果都是对应店性质的门店数据。
注:此处不用带参数的门店信息表的店性质字段拖入文本过滤组件中,是因为此时“门店信息表(有参数的)”取过来数据库的数据,是店性质为设置的默认值自有店的门店信息。所以文本框下拉出来的值也只有自有店。不包括所有店性质的字段值。
3、过滤组件的两种用法编辑
过滤组件有两种用法:上面介绍的参数绑定的用法和普通过滤组件的用法,默认情况下过滤组件的功能为参数控件和普通控件只有一个生效。若想要同一个过滤组件两种功能同时实现的效果,可去管理系统>系统管理>常规中的BI参数设置框,开启参数控件过滤生效按钮,如下图: