1. 概述编辑
1.1 版本
| FineBI 版本 | JAR 包 | 新增内容 |
|---|---|---|
| 5.1 | 2020-01-15 | - |
| 2020-08-04 | 过滤组件标题样式设置&隐藏过滤组件标题 &自定义控制范围增加控制范围 |
1.2 应用场景
当用户需要在仪表板界面进行展示效果的过滤时，可以在仪表板界面添加过滤组件，点击过滤组件对仪表板进行过滤。
1.3 功能介绍
过滤组件的操作除了复制、删除等，还有升序、降序、自定义控制范围、登录名传递默认值、悬浮、清空所选数据、隐藏标题、编辑标题。下面我们对过滤组件的这些操作进行详细介绍；
2. 升序/降序/自定义 编辑
2.1 组件下拉操作
过滤组件的「升序」/「降序」操作是对控件中的过滤内容进行的排序，仅文本过滤组件和树过滤组件支持该功能。比如我们的文本过滤组件过滤内容为「用户名称」，选择的是「升序」排列，点击「下拉」即可设置排序。如下图所示：
则文本过滤组件内容排序，按照字母顺序进行升序排列。降序与之相似。如下图所示：
2.2 过滤字段设置操作
除了在过滤组件的下拉按钮处设置，还可以在过滤组件设置界面的过滤字段添加处进行设置，同时支持自定义的排序。如下图所示：
与组件下拉处设置的排序不同，过滤字段设置的排序可以选择排序依赖的字段，比如我们为「用户名称」设置按照「年龄」升序，点击「确定」保存。如下图所示：
查看该文本过滤组件的数据可以看到，「用户名称」字段值按照「年龄」排序。
「降序」与「升序」步骤一致；「自定义排序」就是拖动数据，手动设置数据顺讯，如下图所示：
3. 绑定字段过滤编辑
过滤组件设置界面在添加了字段以后，可以对添加的字段内容进行过滤，比如添加了「用户名称」字段过滤，但是过滤时只想选择长期类型的协议字段，可以在过滤组件添加字段后下拉选择过滤，如下图：
添加过滤条件，「用户类型」字段属于「 VIP 用户」和「老用户」，点击「确定」保存设置。如下图所示：
此时可以看到该过滤组件仅能选择「 VIP 用户」和「老用户」，如下图所示：
注：时间与数值过滤组件不支持该字段过滤的功能。
4. 自定义控制范围编辑
支持的过滤组件：时间过滤组件、文本过滤组件、树过滤组件、数值区间过滤组件；
注：在 2020-08-03 后过滤组件可以控制的范围扩大，可以选择是否对文本类过滤组件，树过滤组件，数值下拉过滤组件进行控制。
4.1 操作步骤
1）在仪表板节点下行业应用>零售行业找到「区域销售统计」仪表板，如下图所示：
2）进入仪表板，点击「选择大区」组件的下拉>自定义控制范围，如下图所示：
3）弹出「自定义控制范围」框，可以看到出现 6 个组件。这 6 个组件（其中包含文本过滤组件选择小区）在默认情况下都被选择大区组件控制。
勾选大区小区门店分布，其余组件不勾选，如下图所示：
4.2 效果查看
可以看到自定义范围后，过滤组件「选择大区」只对组件「大区小区门店分布」有控制作用。如下图所示：
若不进行过滤组件的自定义控制范围设置，则为默认控制范围。
5. 登录名传递默认值编辑
文本过滤组件及树过滤组件支持设置默认值，默认值仅支持设置登录用户名所在表字段对应控件字段值。比如在数据表「销售员维度表」中包含字段「客户名称」和「销售区域」，过滤组件绑定「销售区域」，登录用户名与「销售员维度表」中「客户名称」匹配，当用户「 aaron 」登录后，过滤组件默认直接匹配用户「 aaron 」所在「销售区域」并过滤。
5.1 详细操作步骤
1）打开「销售 DEMO 」下的「销售员维度表」，为文本过滤组件拖入「销售区域」字段。如下图所示：
注：此处选择的「销售员维度表」应与数据决策系统用户登录表一致。可参考用户同步数据集同步该「销售员维度表」中用户信息至数据决策系统。
2）为过滤组件勾选登录名传递默认值功能，如下图所示：
3）将做好的仪表板挂出到目录列表下。详细步骤请参考：挂出仪表板
4）为查看该仪表板的用户进行使用权限配置，设置目录中该仪表板的查看权限及对应业务包的使用权限，步骤可参考：权限管理指南
4）登录用户所在字段权限配置。进入管理系统>权限管理>权限配置>业务包权限，选择权限配置的用户范围「所有部门」，再选择「登录用户所在字段」为之前同样「销售员维度表」下的账号字段，如下图所示：
选择「销售维度表」下「客户经理」字段，设置成功显示在「登录用户所在字段」后，如下图所示：
5.2 效果查看
此时登录用户「 aaron 」账号，查看之前创建的仪表板，可以看到过滤组件过滤出「 aaron 」所在「销售区域」「上海」字段的所有「客户经理」的信息，如下图所示：
6. 悬浮编辑
支持的过滤组件：时间过滤组件、文本过滤组件、树过滤组件、数值区间过滤组件；
悬浮表示允许过滤组件与其他组件或者控件叠加显示，时间过滤组件、文本过滤组件、树过滤组件、数值区间过滤组件均支持。
点击下拉，选择「悬浮」，如下图所示：
则可以拖拽该组件至仪表板内任何地方，包括叠加到分组表组件内部。如下图所示：
其中设置悬浮的过滤组件始终覆盖在未设置悬浮的组件/过滤组件上方。若两个组件均设置悬浮，则可以点击「下拉」选择「顺序」，设置两个组件显示的顺序，哪个「置于顶部」，哪个「置于底部」。如下图所示：
7. 清空所选数据编辑
支持的过滤组件：时间过滤组件、文本过滤组件、树过滤组件、数值区间过滤组件；
清空所选数据为清空过滤组件内已经选择的过滤条件，时间过滤组件、文本过滤组件、树过滤组件、数值区间过滤组件均支持。为已经选择过滤条件的文本过滤组件点击「清空所选数据」。如下图所示：
则所有已选条件都被清空，可以重新进行条件的选择。
