多维列表框

1. 概述

1.1 功能概述

多维列表框支持手动/自动构建树形筛选结构，自动模式智能识别数据集父子关系生成层级菜单，实现复杂数据的直观逐级筛选。

2. 操作步骤

本文将指导您在Wyn中创建和使用多维列表框。

2.1 前提条件

1. 数据要求： 已完成数据连接与数据准备，本文将缓存数据集（父子级缓存数据集和层级缓存数据集）为例演示操作流程。

2. 界面要求： 已进入仪表板设计界面，且仪表板至少已绑定一个数据集/数据模型（如“父子级缓存数据集和层级缓存数据集”）。

2.2 操作步骤

2.2.1 添加组件

1. 仪表板设计界面最左侧，单击组件按钮展开列表，选择多维列表框，按住鼠标左键将其拖拽至仪表板设计区域，成功添加一个多维列表框组件。

   
   

2.2.2 绑定数据

添加数据集后，单击绑定区右上角的按钮，可以看到有三个选项：多维数据、父子级和层级，这三个选项也就是构建多维列表的三种方式。选择多维数据即手动绑定数据形成树形结构；选择父子级或层级则可自动构建树形层级，但需要对数据有一定的要求。

2.2.2.1 绑定多维数据

1. 数据绑定选择多维数据。

   
   

2. 支持绑定1-N个字段（级联字段除外），智能识别绑定字段数量自动生成对应结构：单字段生成平铺列表，多字段自动构建树形层级筛选器。

   
   

2.2.2.2 绑定父子级

当数据包含ID/父ID关联字段且存在根节点（父ID为空/0）时，系统自动识别父子关系生成层级树形列表，如下图中ID-父ID的关联逻辑，第一列为“ID”，第二列为“父ID”，并且存在一个根节点，也即图中的1001，它的父ID为空，创建数据集后会自动置为0。

1. 数据绑定选择父子级。

   
   

2. 将数据集中的 ID 绑定到编号中，父ID 绑定到父级编号，组织名称绑定到数据中。数据用来绑定树形列表显示出来的内容，如不绑定字段，则会使用编号中绑定的数据进行显示。

   
   

3. 单击父子级右侧更多按钮选择设置，可设置根节点编号（默认-1，示例设为0）及未匹配节点处理方式（作为新根节点生成多棵树/直接忽略不显示）

   
   

4. 保存后设置成功。

   
   

2.2.2.3 绑定层级

当数据通过固定位数/符号（如图示三位数字递进）表达父子关系时，系统自动解析字段中的层级编码（如101→101101→101101101），一键生成标准树形结构。

1. 数据绑定选择层级。

   
   

2. 绑定数据。将含有父子关系的ID 绑定到层级中，将需要显示的内容绑定到数据中。

   
   

3. 单击层级右侧更多按钮选择设置，可自定义层级识别规则（默认"-"分隔符），根据数据特征选择数字长度或特定符号作为层级关系标识。例子中是使用3位数字代表一个层级，所以我们设置分隔方式为按长度，长度设置为3。

   
   

• 分隔方式 ：可以选择为分隔符或者长度。

  • 当选择分隔符，可以进一步在下方设置具体的符号。

  • 当选择长度，则可以进一步设置每一层的长度。

4. 保存后，可见树形层次已经构建成功。

   
   

2.2.2.4 自定义单维列表

1. 选中组件，在右侧属性设置面板找到数据来源，默认为查询结果，即绑定数据字段的方式，可将其调整为手动添加，此时即可添加自定义数据。

   
   

2. 数据来源设置为手动添加后，会增加手动添加属性，单击按钮，进入手动添加界面，选择数据类型并增加/删除数据条目。

   
   

3. 已增加的数据条目可通过项目左侧的箭头调节显示顺序，设置完成后，单击确定按钮即可查看效果。

   
   

4. 自定义数据的成功展示如下图，自定义筛选器数据在实际应用中通常与参数配合使用，实现参数值的输入效果。请见具体示例动态维度和动态度量值。

   
   

2.2.3 数据处理

1. 组件完成数据绑定后，可自由调整字段属性（如格式修改、重命名、聚合方式切换）并执行快速运算，具体操作步骤请参考数据绑定与动态计算。

   
   

2.2.4 组件属性

1. 数据处理完成后，可通过以下属性配置进一步优化组件展示效果：

   属性	说明	系统图示
   筛选器样式	用于设置数据筛内边框和内容字体样式属性
   动画	设置组件入场动画、延迟和持续时间
   数据交互	配置可见菜单项、选择模式、数据来源等属性
   标题	组件标题的样式属性
   特殊数据	自定义空值/空白数据的显示规则
   无数据样式	组件无数据时的显示内容和背景图片
   布局大小	调整组件位置于整体尺寸
   外观样式	调整组件外观样式

2. 多维列表框额外支持以下独有属性：

• 筛选器样式： 在属性设置中，可通过筛选器样式自动标记多维列表框的筛选器样式属性，包括内边框颜色、内边框尺寸和内容字体设置。

  
  

2.2.5 数据探索与分析

组件内置丰富的数据探索与分析功能，从多角度挖掘数据价值，为您的可视化分析提供专业级支持。

2.2.5.1 数据排序

数据排序有两种方法。

方法一：编辑状态快速排序

1. 选中组件，单击编辑按钮，进入组件编辑状态，单击排序图标可动态调整筛选项顺序（排序/降序），该排序效果在预览/运行时生效但不会保存。除此之外，您还可以如同其他普通组件一样，为筛选器添加复杂的数据排序。

   
   

方法二：组件属性排序

1. 选中组件，单击筛选器的排序按钮，即可添加排序。

   
   

• 支持使用字段值，其他的字段以及自定义顺序三种排序方法。

  排序方法	说明	图示
  字段值	置按照字段值的顺序排序，如果绑定字段为字符串类型的字段，则按首字母顺序进行排序；如果绑定字段为数值类型，则按照数值大小进行排序。可选择升序、降序或使用仪表板参数
  字段	选择一个非当前绑定的字段进行排序
  自定义顺序	自定义设置排序字段中数据的排列顺序。选中一个数据，单击右侧的上下箭头进行顺序的排列

2.2.5.2 数据筛选

1. 选中组件，单击筛选器的筛选按钮，即可添加筛选器，有关筛选器内部的具体介绍，请参考组件的数据筛选。

   
   

2. 在筛选器界面，根据实际需求添加筛选条件。（例如：仅展示华北和西北的地区）