--- layout: zh_single title: 仪表板 sidebar: nav: "zh_docs_sidebar" toc: true toc_label: 仪表板 toc_icon: "cog" last_modified_at: "2020-10-29" --- Davinci 提供了两个可视化应用（Viz），仪表板（Dashboard）是其中之一；仪表板提供自动布局和可交互能力，帮助用户快速打造可视化报表 ## 1 仪表板门户 在可视化应用首页，点击“创建新 Dashboard”按钮来创建仪表板门户 ![仪表板门户1](../../assets/images/dashboard/1.1.png) 制作中的仪表板门户可以选择“编辑”，这样对于[可视化应用模块只读权限的角色](3.4-project#32-权限设置)是不可见的 ![仪表板门户2](../../assets/images/dashboard/1.2.png) 权限管理页签可以选择该仪表板门户对哪些[角色](3.3-role)可见 ![仪表板门户3](../../assets/images/dashboard/1.3.png) 点击保存之后，可以看到刚才创建的仪表板门户卡片，编辑状态的仪表板门户卡片是置灰的；发布之后卡片会正常显示，卡片右上角有编辑和删除按钮 ![仪表板门户4](../../assets/images/dashboard/1.4.png) ![仪表板门户5](../../assets/images/dashboard/1.5.png) 点击卡片进入门户，门户页分为左右两部分，左侧展示仪表板菜单树，点击菜单上的仪表板名称，在右侧展示仪表板 ![仪表板门户6](../../assets/images/dashboard/1.6.png) 点击左侧上方的“+”按钮弹出新建表单，可以选择新建仪表板或文件夹；与仪表板门户一样，在“权限管理”页签可以选择该仪表板/文件夹对哪些角色可见 ![仪表板门户7](../../assets/images/dashboard/1.7.png) ![仪表板门户8](../../assets/images/dashboard/1.8.png) 左侧菜单可以拖拽仪表板选择其所属文件夹；在仪表板数量较多的情况下还可以通过上方的搜索按钮快速定位仪表板 ![仪表板门户9](../../assets/images/dashboard/1.9.gif) 鼠标移动到菜单项上在右侧会显示扩展按钮，可以点击扩展按钮对仪表板/文件夹进行编辑、移动和删除操作 ![仪表板门户10](../../assets/images/dashboard/1.10.png) ## 2 功能介绍 ### 2.1 添加组件 点击仪表板右上角的“+”按钮，弹出可视化组件列表，选择需要添加到该仪表板上的组件 ![添加组件1](../../assets/images/dashboard/2.1.1.png) 下一步中指定组件数据更新模式，支持以下两种模式： 1. 手动更新：通过点击组件右上角“同步数据”按钮更新数据 1. 定时更新：根据所设置的更新时长定时自动轮询更新数据，时长单位为秒 ![添加组件2](../../assets/images/dashboard/2.1.2.png) ![添加组件3](../../assets/images/dashboard/2.1.3.png) 点击保存按钮后组件会添加到仪表板上 ![添加组件4](../../assets/images/dashboard/2.1.4.png) ### 2.2 自动布局 用户可以拽住组件右下角调整尺寸 ![自动布局1](../../assets/images/dashboard/2.2.1.gif) 可以拽住组件标题调整位置 ![自动布局2](../../assets/images/dashboard/2.2.2.gif) 在调整组件尺寸和位置时，其他组件会适应该组件变化进行流式布局 仪表板可视区域宽度在 768 像素以上时组件会按照用户定义的比例进行显示，在 768 像素以下时会响应为移动端观看模式 ![自动布局3](../../assets/images/dashboard/2.2.3.gif) ### 2.3 分享 分享功能有普通分享、口令分享和授权分享3种，仪表板分享按钮在仪表板右上角左数第二个，组件分享按钮在组件右上角左数第四个 ![分享1](../../assets/images/dashboard/2.3.1.png) ![分享2](../../assets/images/dashboard/2.3.2.png) #### 2.3.1 普通分享 输入有效期后，点击生成分享链接，在任意浏览器打开链接即可查看分享页，分享页的数据权限与分享者一致 ![普通分享1](../../assets/images/dashboard/2.3.1.1.png) ![普通分享2](../../assets/images/dashboard/2.3.1.2.png) #### 2.3.2 口令分享 输入有效期后，点击生成分享链接和口令，在任意浏览器打开链接，需要输入正确口令才能查看分享页，分享页的数据权限与分享者一致 ![口令分享1](../../assets/images/dashboard/2.3.2.1.png) ![口令分享2](../../assets/images/dashboard/2.3.2.2.png) #### 2.3.3 授权分享 授权分享可以将仪表板分享给所属组织里的角色和成员，仅有授权的角色及成员登录后才能查看分享页 在配置界面，可以选择想要授权的角色和成员，同样需要输入有效期；授权分享页的数据权限有2种，在配置界面可以选择 1. 与分享者一致：分享页的数据权限与分享者一致 2. 使用被分享者自身权限：授权用户登录进入分享页之后，看到的数据与他自身在组织、项目内的权限保持一致 ![授权分享1](../../assets/images/dashboard/2.3.3.1.png) ![授权分享2](../../assets/images/dashboard/2.3.3.2.png) ### 2.4 下载 用户可以下载仪表板和可视化组件的明细数据 Excel 文件；仪表板下载按钮在仪表板右上角左数第三个，组件下载按钮在组件右上角左数第五个。 ![下载1](../../assets/images/dashboard/2.4.1.png) 当用户下载的仪表板中包含多个组件时，将分不同 sheet 页存储各个组件的明细数据 整个下载过程是异步的；点击下载按钮后，服务端生成下载任务，用户可以通过点击屏幕右上角云状按钮查看下载任务列表，当任务处理完毕之后，可以点击文件名称下载 Excel 文件 ![下载2](../../assets/images/dashboard/2.4.2.png) 分享页下载流程也与上述一致 ### 2.5 联动 仪表板中的组件之间可以配置联动关系，点击仪表板右上角左数第四个按钮打开配置面板 ![联动1](../../assets/images/dashboard/2.5.1.png) 一个仪表板中可以配置多条联动关系，每条关系中包含一个触发器和一个联动图表，用户需要指定触发器与联动图表之间的字段对应关系 触发器只能选择图表所用到的字段，联动图表可以选择数据视图模型中的任意字段和变量；触发器与联动图表所选的字段类型必须一致 以下图为例，当添加了“学历年龄分布”组件作为触发器、其“education”字段作为输出条件，“城市薪水排名”作为联动图表、其“education”字段作为输入条件这样一条联动关系之后，点击“学历年龄分布”组件中的图表元素会根据输入的“education”内容对“城市薪水排名”中的数据做条件过滤 ![联动2](../../assets/images/dashboard/2.5.2.png) ![联动3](../../assets/images/dashboard/2.5.3.png) ![联动4](../../assets/images/dashboard/2.5.4.gif) 通过配置多条联动关系，可以支持一个触发器联动多个图表，也支持多个触发器联动一张图表、过滤条件叠加生效；在配置界面右侧的关系图中可以一览联动关系 ![联动5](../../assets/images/dashboard/2.5.5.png) 作为联动触发器的组件左上角有操作提示 ![联动6](../../assets/images/dashboard/2.5.6.png) ### 2.6 全局控制器 全局控制器能够支持用户对仪表板中的一个或多个组件做条件过滤或是变量输入；点击仪表板右上角最右侧按钮打开配置面板，面板左侧为控制器列表，右侧为配置表单 ![全局控制器1](../../assets/images/dashboard/2.6.1.png) #### 2.6.1 查询模式 左下角可选择查询模式，默认为立即查询，即控制器值发生变化后立即触发关联图表进行查询，文本输入框、数字范围输入框在立即查询模式下需要敲回车键触发查询 ![查询模式1](../../assets/images/dashboard/2.6.1.1.png) 手动查询模式时，全局控制器栏右侧会显示查询和重置两个按钮，只有点击查询按钮时会触发查询 ![查询模式2](../../assets/images/dashboard/2.6.1.2.png) #### 2.6.2 控制器配置 点击列表上方的“+”按钮添加控制器，默认名称为“新建控制器”。鼠标移动到控制器名称上时右侧会显示编辑名称和删除按钮 ![全局控制器2](../../assets/images/dashboard/2.6.2.1.png) 中上方选择控制器关联图表，勾选完之后在中下方选择关联数据视图的字段或变量。当控制器关联字段时，控制器的输入内容将作为关联字段的过滤条件作用到 SQL 中；当控制器关联变量时，控制器的输入内容将替换变量作用于 SQL 模板中 右侧进行控制器及相关配置 ##### 2.6.2.1 通用配置 - 缓存：下拉菜单、单选按钮和下拉树可以选择开启缓存来帮助加速获取选项值，此选项与可视化组件缓存一样需要[配置redis](1.1-deployment#245-cache-配置可选)之后才可以正常使用 ![通用配置1](../../assets/images/dashboard/2.6.2.1.1.png) - 是否可见：控制器默认常驻显示，可以选择隐藏和条件展示。目前条件展示仅支持关联下拉菜单，当关联下拉菜单所选值满足条件公式时，该控制器才会显示 ##### 2.6.2.2 下拉菜单 ![下拉菜单1](../../assets/images/dashboard/2.6.2.2.1.png) 下拉菜单控制器只能关联维度字段 选项取值目前支持3种模式 - 自动关联：取值来源即为关联数据视图字段的值列表（distinct）；如果关联多个数据视图，即为多个值列表的并集 ![下拉菜单2](../../assets/images/dashboard/2.6.2.2.2.png) - 手动关联：可以手动选择项目中任意数据视图字段供选项取值；文本字段为选项展示的内容，当不选择时，选项默认展示取值字段的值 ![下拉菜单3](../../assets/images/dashboard/2.6.2.2.3.png) - 自定义：如果不希望从数据视图字段中取值，可以自定义选项 ![下拉菜单4](../../assets/images/dashboard/2.6.2.2.4.png) ![下拉菜单5](../../assets/images/dashboard/2.6.2.2.5.png) ![下拉菜单6](../../assets/images/dashboard/2.6.2.2.6.png) 点击加载之后，可以设置默认值，非必选 ![下拉菜单7](../../assets/images/dashboard/2.6.2.2.7.png) 当开启多选配置时，需要注意，如果关联的是变量，多选选项最终会以诸如 `'选项1','选项2','选项3'` 的格式传递给变量，需要 SQL 语句改变为 `in ()` 语法来保证执行正确 ![下拉菜单8](../../assets/images/dashboard/2.6.2.2.8.png) ##### 2.6.2.3 单选按钮 ![单选按钮1](../../assets/images/dashboard/2.6.2.3.1.png) 单选按钮控制器的配置项与[下拉菜单](2.4-dashboard#2622-下拉菜单)基本一致，除了默认值为必选项 ##### 2.6.2.4 日期选择 ![日期1](../../assets/images/dashboard/2.6.2.4.1.png) 日期选择控制器只能关联维度字段 支持将所选日期转换为以下格式： - 日期（如 2019-01-01） - 日期时间（如 2019-01-01 12:00:00） - 日期时间分钟（如 2019-01-01 12:00） - 月（如 2019-01） - 周（如 2019-5周） - 年（如 2019） ![日期2](../../assets/images/dashboard/2.6.2.4.2.png) 默认值支持固定值和动态值，非必选 ![日期3](../../assets/images/dashboard/2.6.2.4.3.png) ![日期4](../../assets/images/dashboard/2.6.2.4.4.png) 日期控制器同样支持多选配置，在多选的情况下，日期格式将只支持“日期”、“月”、“年”三种，默认值只支持固定值；与[下拉菜单](2.4-dashboard#2622-下拉菜单)一样，在关联变量时也需要注意 SQL 语法问题 ##### 2.6.2.5 日期范围 ![日期范围1](../../assets/images/dashboard/2.6.2.5.1.png) 日期范围控制器只能关联维度字段，支持格式与[日期控制器](2.4-dashboard#2624-日期选择)相同 在关联变量时，日期范围控制器必须关联两个变量，用于做起始时间与截止时间输入 默认值支持固定值和动态值，非必选 ![日期范围2](../../assets/images/dashboard/2.6.2.5.2.png) ![日期范围3](../../assets/images/dashboard/2.6.2.5.3.png) ##### 2.6.2.6 文本输入框 ![文本输入框1](../../assets/images/dashboard/2.6.2.6.1.png) 文本输入框控制器只能关联维度字段，在[立即查询模式](2.4-dashboard#261-查询模式)下需要敲回车键触发查询 支持固定默认值，非必填 ##### 2.6.2.7 数字范围输入框 ![数字范围输入框1](../../assets/images/dashboard/2.6.2.7.1.png) 数字范围输入框控制器只能关联指标字段，在[立即查询模式](2.4-dashboard#264-查询模式)下需要敲回车键触发查询 在关联变量时，数字范围输入框控制器必须关联两个变量，用于做起始与截止数值输入 支持固定默认值，非必填 ##### 2.6.2.8 数字滑块 ![数字滑块1](../../assets/images/dashboard/2.6.2.8.1.png) 数字滑块控制器只能关联指标字段，可以设置最大值、最小值和滑动步长 在关联变量时，数字滑块控制器必须关联两个变量，用于做起始与截止数值输入 默认值为必选项 ##### 2.6.2.9 下拉树 ![下拉树1](../../assets/images/dashboard/2.6.2.9.1.png) 下拉树控制器只能关联维度字段 选项取值需要手动关联数据视图、取值字段、父ID字段；文本字段为选项展示的内容，当不选择时，选项默认展示取值字段的值 ![下拉树2](../../assets/images/dashboard/2.6.2.9.2.png) 点击加载之后，可以设置默认值，非必选 当开启多选配置时，与[下拉菜单](2.4-dashboard#2622-下拉菜单)一样，在关联变量时也需要注意 SQL 语法问题 #### 2.6.3 级联 控制器之间可以通过拖拽的方式配置级联关系，当控制器之间为级联关系时，上级控制器的输入内容将作为下级控制器（下拉菜单）选项取值的过滤条件 ![级联1](../../assets/images/dashboard/2.6.3.1.gif) ![级联2](../../assets/images/dashboard/2.6.3.2.gif) #### 2.6.4 分享页参数传递 在分享页可以通过 URL 给全局控制器传递参数，具体格式如下 `<分享页URL>&<控制器名称>=<值>` 可以同时给多个控制器传参，控制器如预设了默认值会被参数值覆盖 该功能可以配合[全局控制器](2.4-dashboard#26-全局控制器)隐藏一起使用，在分享页嵌入第三方系统展示时，可以通过这种方式传递参数并避免用户直接操作控制器 ![分享页参数传递1](../../assets/images/dashboard/2.6.4.1.png) #### 2.6.5 自定义选项关联变量 如果需要使用单个下拉菜单传递不同的/多个变量值，这个功能会很有用处。参考如下场景，原始 SQL 中有3个 SQL 表达式类型变量，分别对不同字段内容进行控制，在仪表板中可以通过下拉菜单自定义选项关联变量来对多个变量值进行输入 ![自定义选项关联变量1](../../assets/images/dashboard/2.6.5.1.png) ![自定义选项关联变量2](../../assets/images/dashboard/2.6.5.2.png) ![自定义选项关联变量3](../../assets/images/dashboard/2.6.5.3.png) ![自定义选项关联变量4](../../assets/images/dashboard/2.6.5.4.png) ![自定义选项关联变量5](../../assets/images/dashboard/2.6.5.5.png) 以上场景仅为举例，实际使用中可以合理利用该功能满足更有意义的数据呈现需求 ### 2.7 同步数据（更新缓存） 当可视化组件需要获取最新数据时，点击组件右上角左数第一个按钮可以触发查询；如果组件开启了缓存，点此按钮可以更新缓存 ![同步数据1](../../assets/images/dashboard/2.7.1.png) ### 2.8 全屏展示 点击组件右上角左数第三个按钮可打开全屏模式展示图表 ![全屏展示1](../../assets/images/dashboard/2.8.1.png) ### 2.9 自由钻取 仪表板中部分图表类型支持自由[钻取](https://en.wikipedia.org/wiki/Data_drilling)；Davinci 中自由钻取的基本逻辑是：先点击图表元素进行条件过滤，然后点击鼠标右键选择维度进行钻取 以下图为例，用户选择“上海”、“深圳”、“广州”三项图表元素，钻取到“education”字段，此时图表的展示逻辑是：上海、深圳、广州三个城市的教育程度与薪水分布图 ![自由钻取1](../../assets/images/dashboard/2.9.1.gif) 可视化组件左下角会展示图表的钻取路径，用户可以选择之前任意一级路径返回 ![自由钻取2](../../assets/images/dashboard/2.9.2.gif) 支持自由钻取的组件在左上角有操作提示 ![自由钻取3](../../assets/images/dashboard/2.9.3.png) 需要注意，作为[联动](2.4-dashboard#25-联动)触发器的图表将无法进行自由钻取操作 自由钻取在透视驱动与图表驱动模式下有一定的区别 #### 2.9.1 透视驱动 透视驱动下的自由钻取，是在条件过滤的基础上，在透视表中增加/减少维度来观察数据变化 在透视表中，可以选择钻取方式为上卷或下钻，上卷即为去掉该维度，下钻即为增加该维度；同时透视表中可以选择钻取到行或列 ![透视驱动1](../../assets/images/dashboard/2.9.1.1.gif) #### 2.9.2 图表驱动 在图表驱动下，表格的自由钻取逻辑与透视表类似；其他图表是在条件过滤的基础上，将钻取的维度对图表中现有维度进行替换，以另一个维度观察数据变化 目前图表驱动中支持自由钻取的图表类型有 - 表格 - 柱状图 - 折线图 - 散点图 - 饼图 - 漏斗图 - 双Y轴图 ### 2.10 组件设置 #### 2.10.1 编辑组件 需要编辑组件时，可点击组件右上角左数第二个按钮快捷进入组件编辑界面 ![编辑组件1](../../assets/images/dashboard/2.10.1.1.png) #### 2.10.2 设置组件别名 点击组件右上角扩展按钮，点击基本信息，在弹出的面板中，可以设置组件别名，设置的别名将会在该仪表板中替代原始名称进行展示 ![设置组件别名1](../../assets/images/dashboard/2.10.2.1.png) ![设置组件别名2](../../assets/images/dashboard/2.10.2.2.png) ![设置组件别名3](../../assets/images/dashboard/2.10.2.3.png) #### 2.10.3 修改组件基本信息 在基本信息面板中，还可以编辑组件数据更新模式 #### 2.10.4 删除组件 点击组件右上角扩展按钮，选择删除并确认，将会从仪表板中删除该组件