仪表盘

在 VeryReport 仪表板设计器 中，仪表盘用圆弧 + 指针展示 单个 指标在「起点～终点」范围内的位置（类似速度表），适合 KPI 达成率、库存水位、负载监控。适用角色：仪表板设计人员、数据分析师。

仪表板组件不直接写 SQL。请先在数据中心创建并发布数据集。详见 新建数据集。 更侧重完成百分比的多指标展示请用 进度条。

1. 概述

占比 = (当前值 − 起点) ÷ (终点 − 起点) × 100%（限制在 0～100）。必须正确设置起点 / 终点，默认终点为 100。

入口：数据分析 → 仪表板；组件：添加图表 → 指标 → 仪表盘。

2. 基础操作

1. 打开仪表板设计器。

2. 添加图表 → 指标 → 仪表盘。

3. 选中组件 → 右侧 数据 选择已发布数据集。

4. 字段 Tab：将度量（如 sale）拖到 指针角度 / 度量（仅 1 个），设置聚合后点 更新。

5. 到 样式 → 范围设置 配置起点 / 终点（必做，见下节）。

3. 样式配置

选中组件 → 右侧 样式 Tab（折叠项为手风琴，一次展开一项）。

• 仪表样式：显示样式选 标准 / 扇形 / 刻度（切换会重置起止角度）；可调弧线宽度与角度。

• 范围设置：起点 / 终点支持固定数值或动态字段（选数据集度量 + 聚合）。示例：表 quarter_sale，度量 sale 求和，起点 0、终点固定 70000。

• 颜色区间：等分多段配色，或自定义比例区间（如 0～0.5 红、0.5～0.8 黄、0.8～1 绿）。

• 刻度：标签显示百分比或原值；分割线与小刻度。

• 指针：显示、颜色（auto 跟随区间）、长度、宽度。

• 数据主标签 / 副标签 / 度量名称：主标签可显示指针值或百分比；副标签可显示占比或自定义文字。

• 备注：组件底部说明文字。

• 组件设置 → 标题：通用标题区。

4. 分析

分析 Tab 可配置跳转：开启规则后，点击仪表盘即可跳转并携带当前度量值。悬停默认显示名称、当前值、占比与范围。本组件无维度槽位，一般不作联动源。

5. 推荐配置示例

6. 示例：VRDemo 练习数据

请在 数据中心 基于数据源 VRDemo 建数据集并发布。以下表已存在，无需新建视图。

1. 数据集：VRDemo / quarter_sale，发布为「季度销量仪表盘」。

2. 添加仪表盘 → 绑定 sale（求和）→ 更新。

3. 样式 → 范围设置：起点 0，终点 70000。

4. 切换 标准 / 扇形 / 刻度，配置颜色区间与备注。

5. 可选：分析 → 跳转 后点击组件验证。

6. 保存或保存并发布。

如下图所示：

7. 常见问题

• 指针顶满？检查范围终点是否与数据量级匹配（默认终点 100）。

• 能否多指标？不能，每个仪表盘仅 1 个指针度量。

• 按区间变色？样式 → 颜色区间 → 自定义，按 0～1 比例分段配色。

• 动态终点无效？确认已选字段与聚合，并点击更新。