参数筛选器

1. 概述

1.1. 功能介绍

当页面中有卡片使用了参数（无论是计算字段使用，还是来源于数据集），新建参数筛选器后，参数筛选器可以针对页面当中所有使用到筛选器参数的卡片进行筛选，以实现动态分析.

与选择筛选器的差异如下所示：

• 选择筛选器是从已获取的数据集数据进行筛选；

• 参数筛选器，当对应参数已在数据集模型结构中进行过滤时，此时参数筛选的范围是直接从数据库获取部分数据，不会全量获取后，再进行筛选。

1.2. 应用场景

• 场景一：大数据量限制接入的分析数据范围

对于数据量较大的数据源，如果不想全量接入到BI，只想接入预备分析的部分数据，此时可以在数据集的SQL中使用参数筛选数据；

那么，在这样的数据进入BI来做分析时，也需要有能力来配合修改筛选条件，从而仅获取部分数据进行计算分析，这样才能满足业务人员的分析灵活性。

• 场景二：动态切换维度/数值字段

自助分析场景下，不同的角色/业务/部门的用户，在主题看板下查看报表时关注的维度/数值不同，需要能够将维度/数值的自由组合权利下放到每个用户手中，实现相对自由的数据分析；

此时可以通过在卡片中引用参数来新建计算字段，通过参数筛选器来控制卡片展示的维度/数值字段。

2. 操作步骤

2.1. 新建参数筛选器

在页面中，有两个入口可以新建参数筛选器，分别是在筛选栏中新建，以及新建卡片-选择卡片类型为筛选器。

• 筛选栏-新建筛选器

• 页面-新建卡片-选择新建筛选器

选择类型为“参数”，即可进入编辑参数筛选器弹窗。

2.2. 筛选器属性配置

设置参数筛选器时，首先选择一个全局参数，再根据全局参数的类型配置不同的内容：默认值、可选项等；

• 可以设置参数筛选器是否跟随全局参数的变化而变化。

可配内容/全局参数类型	多值/单值文本	数值	日期
选择参数
名称	默认为全局参数名称，可修改
默认值	选填，从可选项中选择 单值参数仅支持默认值选择一个值 多值参数支持默认值选择多个值	默认取全局参数的默认值，可手动修改	默认取全局参数的默认值，可手动修改 固定日期：选择一个具体的日期作为默认值 时间宏：设置一个动态的日期范围作为默认值
可选项	默认为全局参数设置的可选项 不勾选继承上级时，也可以选择从数据集导入字段的值，来作为参数筛选器的可选项 自定义：用户使用参数筛选器时，可以手动输入文本内容进行筛选	?	?
继承上级	勾选继承上级（默认）时，如果上级（全局）的默认值、可选项更新，会一并更新此处的值 未勾选继承上级时，则按照筛选器卡片的设置生效

如果需要再次编辑筛选器的属性，需要在筛选器卡片的工具栏中找到“编辑”功能，再次进入筛选器的属性配置弹窗。

2.3. 设置联动目标卡片

联动时，参数筛选器会自动关联已使用该参数的所有卡片，暂不支持取消。

如果需要再次编辑筛选器的联动关系，需要在筛选器卡片的工具栏中找到“联动”功能，再次进入筛选器的联动配置弹窗。

2.4. 使用筛选器

使用

用户在使用时，可选项上限为1000；可以模糊搜索选项、批量粘贴、查看已选

• 模糊搜索：大小写不敏感，但某些直连数据库不支持大小写不敏感；

• 批量粘贴：一键复制可选项后，可以根据名称自动匹配选项列表，减少点击步骤。

查看筛选效果

筛选器筛选后，会对每个联动卡片生效，卡片呈现出筛选器筛选后的数据；

用户浏览卡片时，可以通过鼠标hover至卡片工具栏的“小漏斗”图标查看当前的筛选条件。