Skip to content

仪表盘设计

仪表盘是把数据集可视化为图表、指标卡、表格的画布。在「报表中心 → 仪表盘」(/report/dashboards)管理,点「设计」进入拖拽设计器。

设计器布局

设计器分三栏:

  • 左侧组件面板:按「指标 / 表格 / 图表 / 其它」分组,点击即可添加到画布。
  • 中间画布:栅格(默认 12 列)拖拽布局,拖动卡片头部移动、拖右下角缩放。
  • 右侧配置面板:选中组件后,配置数据集、字段映射与样式。

顶部工具栏:返回、名称、布局模式切换(栅格 / 大屏画布)、撤销/重做、筛选器、轮播(多页配置)、主题(浅色/深色,栅格模式)、大屏设置(画布模式)、预览、保存。

组件类型(23 种)

分组组件
指标指标卡(kpi)、仪表盘(gauge)、翻牌器(flipper)、水波球(liquid)
表格表格(table)、透视表(pivot)
图表柱状图、折线图、面积图、双轴图、饼图、散点图、雷达图、漏斗图、矩形树图、桑基图、词云、热力图、地图
其它文本、滚动榜单(scrollList)、图片、网页(iframe)

配置组件

选中组件后在右侧:

  1. 选择数据集(文本/图片/网页组件无需数据集)。指标卡 / 仪表盘 / 翻牌器 / 水波球还可改为直接绑定指标指标中心定义的 metricId,与数据集二选一)——组件复用指标的口径、缓存与格式化,无需重复配置字段映射。
  2. 配置字段映射
    • 指标卡 / 仪表盘 / 水波球:取值字段 + 聚合方式(求和/平均/最大/最小/计数/首行)。
    • 柱/线/面积/饼/散点等:分类字段(X)+ 指标字段(Y,可多选)。
    • 桑基图:源字段 / 目标字段 / 值字段;热力图:X / Y / 值;词云:词语 / 权重。
  3. 图表选项:堆叠、百分比、水平、平滑、数据标签、排序 + TopN 等。
  4. 组件样式:背景色、是否显示标题栏、无边框模式等。

表格增强

  • 展示列:留空=全部字段。
  • 合计行每页行数(分页)。
  • 条件格式:按列阈值(≥ ≤ > < = ≠ / 介于)设置文字色或背景色。
  • 字段配置了格式化时,单元格自动按格式显示(货币、百分比、字典翻译等)。

指标卡增强

支持对比字段(环比/同比基准、显示涨跌幅)、目标值(进度条)、迷你趋势(sparkline)。

全局筛选器

点顶部「筛选器」管理仪表盘级筛选控件:

类型控件
date / daterange日期 / 日期范围
select / multiSelect下拉单选 / 多选
input文本输入
numberRange数值范围

筛选器选项可来自静态列表某数据集(取值/标签字段),并可配置控件宽度。查看页与公开分享页的筛选值会同步到 URL 查询参数,刷新或转发链接即恢复筛选状态。

参数绑定(筛选器 → 数据集参数)

若组件的数据集声明了参数,在组件配置的「参数绑定」区把全局筛选器绑定到数据集参数,筛选变化即驱动该组件重新取数,实现联动查询。

点击联动与钻取

  • 点击联动:开启后,点击图表的某个分类,把该值写入指定筛选器,联动刷新其它组件。
  • 钻取:点击图形可
    • 维度层级下钻(fields 类型:预设字段层级如 省→市→区,点击逐层替换分类字段,支持面包屑回退),或
    • 目标仪表盘(携带点击值为参数),或
    • 外链(URL 支持 {value} 占位)。

多页轮播

「轮播」设置把仪表盘分成多页(pageCount),每个组件通过 page 属性归属某一页;设计器顶部出现页签切换(含各页组件数),逐页编排。查看时按 intervalSec 自动轮换页面,可选页码指示点(showDots)与手动翻页。适合值班大屏多主题轮询场景,详见 数据大屏

主题与自动刷新

  • 主题:浅色 / 深色。
  • 在「大屏设置」(画布模式)或仪表盘配置中可设自动刷新间隔(秒,0=关闭)。

发布与生命周期

仪表盘有三种生命周期状态:

  • 设计器里的「保存」仅保存草稿,不影响对外展示;保存携带修订号(revision)乐观锁,多人同时编辑发生冲突时会返回当前修订号并提示刷新,避免互相覆盖。
  • 列表点「发布」把当前草稿固化为发布快照;已发布状态下可点「下线」停止对外提供。
  • 已发布查看、公开分享、匿名嵌入始终读取发布快照——继续修改草稿不会影响线上,直到再次发布。
  • 草稿预览需要 report:dashboard:update 权限;普通查看者只能看到发布态。
  • 发布类动作可纳入资源治理的发布审批与环境晋级流程;列表「权限与转移」可直达该仪表盘的 ACL 与所有权管理。

预览、版本与收藏

  • 预览:进入只读查看页,支持刷新、导出 PNG 图片、全屏、(有权限时)回到编辑。
  • 版本历史:保存/发布产生版本快照(来源标注 手动保存/发布/回滚等,回滚前自动生成当前状态的备份版本),可查看版本差异(diff 摘要)并随时回滚。
  • 收藏 / 分类:仪表盘可收藏、归类(分类支持管理维护),列表支持按分类与收藏筛选。
  • 复制 / 批量启停:列表可一键复制现有仪表盘作为新草稿,也可多选批量启用/停用。

导出与分享

权限

操作权限码
查看 / 预览 / 评论report:dashboard:list
新增 / 复制report:dashboard:create
设计 / 编辑 / 发布 / 下线 / 版本 / 分享report:dashboard:update
删除report:dashboard:delete

Built with VitePress for local documentation preview.