# 3.2维度过滤器 # 概述 不同类型的字段作为过滤器使用时，组件样式和过滤方式都会有一定的区别，维度过滤器是维度列表中除日期类型字段外的过滤器，即字段类型为字符型的过滤器； # 3.2.1显示标题 ![](/uploads/projects/querywizard/202605/18b1cf049f9bef29.png) **图3.2.1 显示标题** 标题指的是过滤器左侧的过滤器名称，默认会显示标题，且标题和字段名称一致。 如果配置不显示标题，则标题为空，直接显示过滤器。是否显示标题在所有过滤器中属于通用配置，度量过滤器和日期过滤器用法一致。 # 3.2.2编辑标题 通过编辑标题可以修改过滤器名称，此操作不会修改原始名称，仅修改显示名称。 ![](/uploads/projects/querywizard/202605/18b1cf04a04404d5.png) **图3.2.2编辑标题** # 3.2.3选项配置 选项配置用于配置过滤器的选项，针对不同类型的过滤器，选项配置的内容会有一定区别。 - 输入框 输入框类型的选项配置有字典表和自定义两个选项卡，输入框类型过滤器因为是在输入框中输入值进行查询，配置的选项主要是作为输入部分内容后的提示。 ![](/uploads/projects/querywizard/202605/18b1cf04a0fb11e0.png) **图3.2.3输入框选项效果** 字典表配置包括排序、数据来源、字段、选项值是否支持多选和输入框提示几个配置项 ![](/uploads/projects/querywizard/202605/18b1cf04a1cb25fc.png) **图 3.2.4输入框配置字典表** - 排序选择默认是不做排序，以数据库返回的数据顺序为准，升序和降序分别是按照数据库的升序和降序做排序，不去重适用于字典表中当前字段已经处理好了顺序，不需要再做任何排序，直接返回数据库内容的情况。按字段则是按照选择的字段对过滤器选项进行排序，如果同一类型对应多个排序字段值，那就只取每一类型的第一个。自定义则是由用户自行输入前 N 项的值来决定前 N 项的顺序，不在自定义范围的选项值则按照默认排序。 - 数据来源是从资源树上选择一个字典表，字段从当前字典表中选择选项的来源字段。 - 选项值是否支持多选决定了输入框是仅能对单个值进行查询还是可以对多个值进行查询。勾选了选项值支持多选后，可以从下拉列表中把查询出来的选项全部勾上进行查询。 ![](/uploads/projects/querywizard/202605/18b1cf04a276fbb2.png) **图 3.2.5选项值多选** - 输入框提示则是在查询之前显示在输入框中的一段提示文字，仅有提示作用，鼠标选中输入框后可以正常输入值。 自定义选项卡可以自定义选项列表，可通过导入选项的方式从本地 Excel 中将选项导入到选项列表中，也可以自行新增值，选中选项通过上移、下移、移至开头、移至结尾等功能对顺序进行调整。 ![](/uploads/projects/querywizard/202605/18b1cf04a33bdf9b.png) **图3.2.6输入框自定义** - 单值下拉 单值下拉过滤器有自动、字典表、自定义 3 个选项卡。 ![](/uploads/projects/querywizard/202605/18b1cf04a3fffeae.png) **图 3.2.7单值下拉选项配置** 选项类型为自动意为自动从当前字段中获取选项值，比如产品包箱过滤器，会取不重复的产品包箱值作为过滤器的选项。单值下拉过滤器会自动带一个“全部”选项，用于查询当前字段的所有值，如果选择不需要“全部”选项，则下拉列表不显示“全部”，仅有具体的选项值。 ![](/uploads/projects/querywizard/202605/18b1cf04a4cbdf6d.png) **图3.2.8 单选下拉过滤器全部选项** 单值下拉过滤器配置字典表时，需配置排序方式、数据来源和字段，用法同输入框过滤器。 ![](/uploads/projects/querywizard/202605/18b1cf04a586af9b.png) **图3.2.9 单选下拉过滤器配置字典表** 单值下拉过滤器配置自定义时，会默认将当前字段的选项添加在选项列表中，用户可基于此对选项进行调整。 ![](/uploads/projects/querywizard/202605/18b1cf04a658535a.png) **图3.2.10下拉过滤器配置自定义** “是否获取新增类别”则是用于数据会实时增加的情况，自定义列表固定了当前已有的选项及顺序，新增类别（表中有而选项列表中没有的选项）则是作为一个整体参与到已有选项的排序。新增类别内部也可以进行升序、降序和自定义排序。 ![](/uploads/projects/querywizard/202605/18b1cf04a730129c.png) **图3.2.11新增类别排序** - 多值下拉 多值下拉和单值下拉一样有自动、字典表、自定义三个选项类型，只是多值下拉没有是否需要“全部”选项这一配置，其它配置使用方法可参考单值下拉。 ![](/uploads/projects/querywizard/202605/18b1cf04a80d8b72.png) **图3.2.12 多值下拉选项配置** - 单值（树形） 树形过滤器因为其树形结构，需要在选项配置中配置下级字段，故树形过滤器的选项类型没有自定义，只有自动和字典表。 ![](/uploads/projects/querywizard/202605/18b1cf04a8d99cd4.png) **图3.2.13 单值（树形）选项配置** 单值（树形）过滤器选项类型为自动时，下级字段选型也来源于当前字段所在表，默认使用当前字段作为第一级，配置的下级字段作为下级，下级字段可配置多个。 当树形过滤器存在多个层级时，如果排序方式选择按字段排序，则是对每个层级以此排序，比如层级为区域，省份，按照利润排序，则先将区域按照利润排序，再在同一区域内将省份按照利润排序。 是否需要“全部”选项用法同单值下拉过滤器，配置在使用过滤器时选项中是否有“全部”。 配置字典表时，需要选择数据来源和第一级字段，下级字段来自于字典表内的其它字段，支持配置多个。 ![](/uploads/projects/querywizard/202605/18b1cf04a9b61c5f.png) **图3.2.14 单值（树形）选项配置字典表** - 多值（树形） 多值（树形）选项配置和单值（树形）一致，只是没有“是否需要‘全部’选项”这一配置。 ![](/uploads/projects/querywizard/202605/18b1cf04aaaab1c3.png) **图3.2.15 多值（树形）选项配置** # 3.2.4设置默认值 可以设置自助查询资源首次打开时过滤器以什么值对数据进行过滤，维度字段过滤器默认值有全部、自定义和无三种方式可以配置。 全部即打开的时候不做任何筛选，把所有数据全部查出来，选择全部后不需要配置任何内容。输入框、单值下拉、多值下拉、单值树形和多值树形均有此选项，且除了输入框过滤器外，其它四种类型默认均是使用全部进行查询。 ![](/uploads/projects/querywizard/202605/18b1cf04ab5ab1ca.png) **图3.2.16 默认值设置全部** 自定义可以自行选择过滤器默认查询的值，输入框、单值下拉、多值下拉、单值树形和多值树形均有此选项，且根据过滤器类型的不同，自定义的方式也有所区别。输入框过滤器自定义是一个输入框，由用户手动输入值作为默认查询的内容；单值下拉则是通过下拉列表的方式，用户仅能选择一个值作为默认查询的内容；多值下拉以下拉列表前面加复选框的方式，用户可以勾选多个值作为默认查询内容；单值树形以树的方式展示选项，用户仅能选择一个值且是最末尾层级的值作为默认查询内容；多值树形以树的方式展示选项，用户可以勾选多个值作为默认查询内容。 ![](/uploads/projects/querywizard/202605/18b1cf04ac2648d6.png) **图3.2.17 默认值设置自定义** 无仅在输入框过滤器的默认值配置界面存在，即默认不查询任何内容，返回空，且输入框过滤器的初始默认值就为无。 ![](/uploads/projects/querywizard/202605/18b1cf04acd61b6c.png) **图3.2.18 默认值设置无** # 3.2.5关联过滤器 如果一个工作表中有多个过滤器，且过滤器选项较多，如果在查找时希望过滤器之间明确的关联关系，方便快速精确的定位到某一个选项，则就需要设置关联过滤器了。 关联过滤器使用场景分为两种情况： 1. 区域、省份、城市字段：1个城市只会对应一个省份。一个省份也相对应一个区域，这种情况称之为一对多情况。 2. 区域、职业、性别字段：1个性别可对应多个职业，一个职业也可对应多个区域。这种情况称之为多对多情况。后续将用一对多和多对多形容两种情况。 - 一对多情况 首先在自助分析中，使用“区域”“省份”“城市”“销售额”字段建一张数据表，且将“区域”“省份”“城市”三个字段加为多值列表过滤器，设置过滤器间的关联关系，选择“关联过滤器”选项 ![](/uploads/projects/querywizard/202605/18b1cf04adbafd57.png) **图3.2.19 关联过滤器** 点击之后，弹出设置关联过滤器的弹框，弹框中展示的是，区域过滤器在设置关联过滤器页面，勾选“省份”，省份过滤器在设置关联过滤器页面勾选“城市” ![](/uploads/projects/querywizard/202605/18b1cf04ae93c5dc.png) **图3.2.20 设置关联过滤器** 可则当区域过滤器中选择“东北”选项；省份过滤器选择“吉林”时，城市过滤器显示东北吉林下的城市。 ![](/uploads/projects/querywizard/202605/18b1cf04af69989e.png) **图3.2.21 一对多关联效果** - 多对多情况 首先在自助查询中，添加关联过滤器数据源，使用“字段A”“字段B”“字段C”“性别”字段建一张数据表，且将“字段A”“字段B”“字段C”三个字段加为多值列表过滤器，设置过滤器间的关联关系，选择“关联过滤器”选项。 字段A过滤器在设置关联过滤器页面，勾选“字段B”和“字段C”，字段B过滤器在设置关联过滤器页面勾选“字段C”，则当字段A过滤器中选择“北京”选项；字段B过滤器选择“数据分析”时，字段C的值只存在李小雪。 ![](/uploads/projects/querywizard/202605/18b1cf04b044f570.png) **图3.2.22 多对多关联效果** 目前输入框和树形过滤器不能被关联。 # 3.2.6单值下拉 单值下拉过滤器组件为下拉框样式，每次仅可以选择一个值，过滤器会使用选择的这个值对目标数据进行精确匹配。选择全部则不执行任何过滤，是否支持选择全部可以通过选项配置中通过配置项决定。 # 3.2.7多值下拉 多值下拉过滤器和单值下拉很相似，只是所用组件不同，多值下拉支持通过复选框一次性选择多个值，单值下拉每次仅可以选择一个值。多值下拉框没有是否支持选择“全部”的配置，默认支持。 # 3.2.8输入框 输入框过滤器是一种较为特殊的过滤器，默认就是一个输入框，不查询任何值，所以查询结果也是空。 输入框适用于过滤器选项特别多，因为计算选项要耗费大量性能的情况。默认是空，不做任何查询，在输入具体值的时候才输入的值做精确匹配。 输入框过滤器也可以在选项配置中配置支持多值查询，根据输入的部分内容在选项中做查找，联想出能匹配上的选项，再通过复选框勾选多个值。 ![](/uploads/projects/querywizard/202605/18b1cf04b0f11fe6.png) **图3.2.23 输入框多值查询** # 3.2.9单值（树形） 树形过滤器是选项以树的结构展示，单值树形过滤器仅能选择最底层的值进行查询，也每次仅能选择一个值。 树形过滤器的第一级字段是当前显示过滤器的字段，下面几级内容需要在选项配置中进行配置。 ![](/uploads/projects/querywizard/202605/18b1cf04b1d44905.png) **图3.2.24 单值树形过滤器** # 3.2.10多值（树形） 多值树形过滤器树结构和单值树形一致，但每个选项前面有一个复选框，多值树形可以选择任意一级的值进行勾选。 比如，选择勾选“华北”，查询的时候只匹配区域等于华北的数据，不管省份和城市，因为勾选上级，下级默认是全选。勾选“北京”，则是查询区域等于华北且省份等于北京的数据，查询条件中不带城市。 ![](/uploads/projects/querywizard/202605/18b1cf04b2a8237e.png) **图3.2.25 多值树形过滤器** # 3.2.11设置样式 设置组件样式可以修改过滤器的边框颜色、文字颜色、边框高宽、文字大小等内容。 过滤器有默认样式，即没有选择值的情况的颜色配置，激活样式指的是选中某具体值后的边框颜色、背景颜色等。过滤器选项的文字可以修改默认颜色和激活颜色，但字体大小只能从默认修改，激活后的文字大小和默认的文字大小一致，不允许修改。单值/多值下拉和树形过滤器可以设置下拉框的阴影。 ![](/uploads/projects/querywizard/202605/18b1cf04b3a62463.png) **图3.2.26 设置过滤器样式** 当存在多个过滤器时，我们可以进行批量设置过滤器样式，比如表格中同时存在区域单值下拉过滤器和省份多值下拉过滤器，在编辑模式下，我们勾选批量设置，选中区域和省份两个过滤器，出现批量设置样式图标，点击即可对相关过滤器的样式进行批量设置。 **![](/uploads/projects/querywizard/202605/18b1cf04b4bc5560.png)** **![](/uploads/projects/querywizard/202605/18b1cf04b60ed104.png)** **图3.2.27 批量设置样式** # 3.2.12收藏样式 可以对过滤器的样式进行收藏，点击【收藏样式】，弹出收藏界面； ![](/uploads/projects/querywizard/202605/18b1cf04b6c95811.png) **图3.2.27 收藏过滤器样式设置** - 样式名称：文本输入框，输入要收藏的过滤器样式名称，该名称会进行重名校验，不可重复。重复校验规则：全租户内收藏过滤器样式的时候名称不能重复； - 谁可以看：用来配置该样式的使用权限。有2个选项：私有、公开； 私有：私有表示仅收藏样式的用户自己可以使用 公开：公开表示该样式，系统所有用户可见 # 3.2.13移除过滤器 移除过滤器可以将过滤器从配置界面移除，用于取消过滤器配置。