明细表

在 VeryReport 仪表板设计器 中，明细表以表格逐行展示维度与度量字段，适合订单明细、区域产品清单等清单式核对场景。适用角色：仪表板设计人员、数据分析师。

仪表板组件不直接写 SQL。请先在数据中心创建并发布数据集，再在设计器中选用。详见 新建数据集。 练习数据见本文第 6 章示例。

1. 概述

1.1 功能说明

明细表将维度与度量混拖到同一「数值列」区域，按行展示明细（默认可不聚合）。支持主题/斑马纹/表头/序号/分页、冻结列、合并同类单元格、指标分组（多级表头）、条件格式（高亮、快捷色阶、数据条）、总计行（可钉底）、字段筛选与快捷过滤，以及钻取、联动、跳转、事件列。

1.2 适用场景

• 订单、客户、工单等业务明细清单；
• 区域 × 产品销售明细核对；
• 省级多指标一览（销售额 / 利润 / 成本）。

1.3 入口与前提

项	说明
设计器入口	左侧导航 数据分析 → 仪表板 → 新建或打开仪表板
组件路径	设计器左侧 添加图表（或工具栏「图表」）→ 分组 表格 → 明细表
数据前提	需先在 数据中心 → 数据集 中创建并发布数据集

数据集创建步骤见：新建数据集。

2. 基础操作

2.1 打开仪表板设计器

1. 左侧导航展开 数据分析，点击 仪表板。
2. 在列表页点击 新建仪表板，或双击已有仪表板进入设计器。
3. 确认进入全屏 仪表板设计器（地址形如 /dashboard/designer/...）。

2.2 插入明细表

1. 在设计器左侧找到 添加图表（或顶部「图表」入口），打开图表面板。
2. 在面板顶部可搜索「明细」；或直接找到分组 表格。
3. 点击 明细表（与「分组表」「交叉表」「热力图」同组）。
4. 画布出现表格组件卡片。

未绑定数据时可能显示占位/空表，属正常状态；正式使用请绑定数据集并点 更新。

2.3 选择数据集

1. 在画布上 单击选中 明细表。
2. 右侧出现组件设置与 数据 面板：组件设置含 字段 / 样式 / 分析（事件） 等 Tab；数据 面板用于选数据集与拖字段。
3. 在 数据 面板顶部点击 选择数据集，选择已发布的数据集。
4. 选择成功后，面板列出 维度 与 度量 字段。

若列表为空：请到数据中心确认数据集已 发布。

2.4 绑定字段

1. 组件设置切换到 字段 Tab。
2. 从右侧 数据 面板把字段拖到：

放置区	要求	说明
数值列/维度或度量	可多列	维度、度量混拖；可拖拽调整列顺序
过滤器（可选）	任意字段	组件级筛选条件

3. 度量字段可点字段菜单设置：聚合方式（明细场景常用 不聚合）、显示名、数据格式。
4. 底部点击 更新 刷新查询；完成后 保存 或 保存并发布 仪表板。

2.5 预期效果

• 表格按绑定列顺序展示每一行明细；
• 列头可点击排序（若样式中未关闭排序）；
• 开启分页后，底部出现分页条；
• 开启总计后，表尾出现汇总行。

3. 样式配置

选中明细表 → 组件设置 → 样式 Tab。样式区为多个折叠区块，可在顶部搜索样式项。

3.1 表格基础

配置项	说明
主题	默认 / 边框 / 简洁 / 极简
斑马纹	是否隔行变色及条纹色
字体 / 字号 / 颜色	表体文字
列宽	自适应或自定义
行高	自动或自定义；可设最大高度 / 动态高度
分页	开启后可设每页行数、简洁/完整模式

3.2 单元格

配置项	说明
冻结列	开启后可智能冻结首列，或指定冻结列数
指标分组	开启后，度量列归入二级表头，组名可改（默认「指标」）
合并同类单元格	相邻相同值纵向合并
内容自动换行	长文本折行显示
序号列	是否显示序号及列名

3.3 表头样式

可隐藏表头，或设置表头背景色、字号、加粗、对齐、自动换行等。

3.4 条件格式

路径：样式 → 条件格式。

1. 选择要着色的字段（建议选数值度量，如 order_amount、sale、sales）。
2. 快捷样式（可选其一）：大于/小于 0 着色；与列均值比较；双色 / 二色阶 / 三色阶 / 渐变色阶。可勾选颜色反转。
3. 自定义规则：类型可选「高亮」「数据条」等；高亮可设比较条件与文字色/背景色；数据条可设条形色。

效果：满足条件的单元格变色，或单元格内出现比例数据条。

3.5 总计

路径：样式 → 总计。

配置项	说明
启用总计	表尾显示汇总行
别名	如「总计」「合计」
计算方式	自动 / 求和 / 平均 / 计数 / 最大 / 最小 / 按列自定义
固定在底部	勾选后，滚动表体时总计行钉在表格底部

3.6 筛选展示

路径：样式 → 筛选（或「筛选展示」区块）。

配置项	说明
字段筛选	表格上方出现「显示字段」多选，可临时隐藏列
默认选中字段	字段筛选开启时的默认可见列
快捷过滤	表格上方出现搜索框，对当前可见列做包含匹配过滤

3.7 辅助

可配置滚动条常显/悬停显示、滚动条粗细等。

4. 分析：联动 / 钻取 / 跳转

选中明细表 → 分析（或 事件）Tab。

4.1 联动

1. 同一仪表板再放置目标组件（如柱图）。
2. 选中明细表 → 配置联动：选择目标组件与传参字段。
3. 预览时点击某一行，目标组件按该行字段过滤。

4.2 钻取

1. 先在仪表板中配置钻取目录（多级维度字段顺序）。
2. 明细表绑定该目录。
3. 点击当前层级维度单元格可下钻；组件上方面包屑可回退。

4.3 跳转

1. 在跳转规则中指定源字段（如省份、订单号）。
2. 配置目标仪表板 / 报表或外链，并映射参数。
3. 预览时该字段显示可点击样式，点击后跳转。

5. 推荐配置示例

5.1 订单明细清单（推荐）

项	建议
数据集表	order_info
维度	address_province、address_city、product_name
度量	order_amount（不聚合）
样式	斑马纹开；分页每页 10；条件格式对金额开色阶或数据条
总计	对金额列求和，并勾选「固定在底部」

5.2 区域 × 产品明细

项	建议
数据集表	region_sales
维度	region、product
度量	sale（不聚合）
样式	可开「合并同类单元格」（按区域）

5.3 省级多指标

项	建议
数据集表	map_province_sales
维度	area
度量	sales、profit、cost
样式	开启「指标分组」，组名填「经营指标」

6. 示例：VRDemo 练习数据

请在 数据中心 基于数据源 VRDemo 建数据集并发布，再在设计器中选用。 以下表均已存在于 VRDemo，无需新建视图，可与地图等组件共用。

6.1 可用表

表名	说明	建议字段
order_info	订单明细（推荐）	address_province、address_city、product_name、order_amount
region_sales	区域产品销售	region、product、sale
map_province_sales	省级多度量	area、sales、profit、cost

6.2 端到端练习（约 10 分钟）

1. 数据中心 → 数据集 → 新建：数据源选 VRDemo，表选 order_info，保存并 发布。建议数据集名称：订单明细。
2. 数据分析 → 仪表板 → 新建仪表板，进入设计器。
3. 左侧 添加图表 → 表格 → 明细表。
4. 选中组件 → 数据 面板选择数据集 订单明细。
5. 字段 Tab：拖入 address_province、address_city、product_name、order_amount（金额设为不聚合）。
6. 点 更新，确认表格出现约十余行订单。
7. 样式 → 条件格式：字段选 order_amount，快捷样式选色阶或添加「数据条」。
8. 样式 → 总计：启用，别名「合计」，计算方式求和，勾选「固定在底部」。
9. 样式 → 筛选：开启「快捷过滤」，在预览中输入「上海」验证过滤。
10. 保存并发布，打开预览核对效果。

6.3 对照练习（可选）

用同一数据源再建数据集指向 map_province_sales，再插一张明细表：维度 area，度量 sales/profit/cost，并开启 指标分组，对比多级表头效果。

7. 常见问题

Q：表格一直为空？
A：确认数据集已发布；字段已拖入「数值列」；点过 更新；过滤器条件是否过严。

Q：金额被聚成一行？
A：明细场景请将度量聚合设为 不聚合（或 NONE），不要用 SUM。

Q：条件格式没效果？
A：确认选中的是数值字段；快捷样式或自定义规则已保存；再点 更新。数据条需要字段为数值且行间有差异。

Q：指标分组后维度列不见了？
A：指标分组只把度量列包进二级表头，维度列仍在外层；请确认维度已拖入数值列区域。

Q：副指标列全是「-」？
A：当前版本仅在查询实际返回同环比字段时显示副指标列；未返回时不会整列空壳展示。

Q：和数据大屏里的明细表是不是同一个？
A：概念一致（清单式表格），但本篇入口是 仪表板设计器（数据分析 → 仪表板）。请按本章路径操作。

8. 相关文档

• 新建数据集
• 仪表板概览
• 分组表