1.1 应用场景

当一个组件使用的原始数据是带了参数的 SQL 数据集，那么用过滤组件在对该组件进行过滤时，操作方式不同于正常情况，本文将详细介绍。

1.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. 选中两个，点击确定，出来的结果都是对应店性质的门店数据。

注：此处不用带参数的门店信息表的店性质字段拖入文本过滤组件中，是因为此时“门店信息表(有参数的)”取过来数据库的数据，是店性质为设置的默认值自有店的门店信息。所以文本框下拉出来的值也只有自有店。不包括所有店性质的字段值。  

过滤组件有两种用法：上面介绍的参数绑定的用法和普通过滤组件的用法，默认情况下过滤组件的功能为参数控件和普通控件只有一个生效。若想要同一个过滤组件两种功能同时实现的效果，可去管理系统>系统管理>常规中的BI参数设置框，开启参数控件过滤生效按钮，如下图：