VeryReport · 帮助文档

数据大屏快速入门

以「销售战报大屏」为例,完成自由画布、图表与翻牌器、数据集绑定、预览投屏的数据大屏设计流程。

本文以销售战报大屏为例,讲解 VeryReport 数据大屏从零到预览发布的完整流程:深色背景、KPI 翻牌、地区柱图、页面轮播等常见投放场景。

范围说明:本文介绍数据大屏模块(resourceType=SCREEN,自由画布 + 固定分辨率),与仪表板(栅格布局 BI 分析,见仪表板快速入门)、复杂报表(.vrp 电子表格报表)相互独立。能力规划见《数据大屏设计》文档。

1. 概述

数据大屏面向大型显示屏投放,采用自由画布(absolute 定位)、支持多页面、图层管理、入场动画与装饰组件。定义存储于 bi_screen.definition + components,组件数据经 Calcite 聚合查询(POST .../v2/query)。

特性仪表板数据大屏
布局24 列栅格像素级自由定位
分辨率自适应固定如 1920×1080
预览同页预览等比缩放投屏 / 分享链接
典型场景日常分析看板展厅、战报、驾驶舱
阶段说明入口
准备数据全局或模型数据集数据中心 → 数据集
新建大屏空白画布或模板数据大屏 → 新建大屏
设计画布拖组件、绑数据、调样式设计器 `/screen/designer`
预览发布投屏预览、发布上线预览 / 保存并发布

1.1 预期效果

2. 制作步骤

2.1 准备数据集

  1. 数据中心 → 数据集 准备含「地区、销售额、统计日期」等字段的数据集。
  2. 确认度量可聚合(SUM/COUNT 等),维度可用于图表分类轴。

2.2 新建大屏

  1. 进入 数据大屏(菜单在「数据分析」下,与仪表板并列)。
  2. 点击 新建大屏,进入全屏设计器(新建模式 screenId=0,首次保存时选择目录)。
  3. 顶部可编辑大屏名称,如「销售战报」。

2.3 全局配置

  1. 右侧全局配置(未选中组件时):

2.4 添加组件

顶部第二层 组件分类 Tab(图表 / 文本 / 形状 / 媒体 / 交互 / 素材),点击后在弹出面板中选择组件添加到画布:

  1. 文本:拖入标题「2025 销售战报」,调整字号与颜色;
  2. 翻牌器(ticker):展示销售总额 KPI;
  3. 柱图(bar):展示各地区销售额对比;
  4. 可选:边框装饰视频背景 增强视觉效果。

画布支持拖拽移动、八向缩放、旋转;左下角 MiniMap 便于大画布导航;左侧图层面板可调整顺序、锁定、隐藏、组合。

2.5 绑定数据

  1. 选中柱图,右侧切换到 数据 Tab。
  2. 选择数据集,将「地区」拖入维度,「销售额」拖入度量并设聚合为「求和」。
  3. 翻牌器绑定同一度量的 SUM;可配置刷新间隔(自动刷新)。
  4. 需要筛选时,在数据过滤中添加条件,或使用交互类组件(下拉、平铺按钮、日期选择器)驱动全局过滤。

2.6 样式与事件(可选)

  1. 样式 Tab:标题、图例、坐标轴、数据标签、动画等(各组件专属面板)。
  2. 事件 Tab:配置联动钻取跳转(其他大屏页或 URL)。
  3. 左侧可新增页面并开启页面轮播,适合多屏轮播展示。

2.7 保存与发布

  1. 保存:写入 definition 与 components;状态为草稿(status=0)。
  2. 保存并发布:status=1,授权用户可在列表中预览。
  3. 顶部 预览 进入投屏预览(/screen/preview/:id),按 global.scaleMode 等比缩放。
  4. 可通过分享链接(bi_share_link)对外投屏展示。

3. 效果预览

  1. 在设计器点击 预览,全屏查看缩放与动画效果。
  2. 按 F11 或浏览器全屏,模拟真实投放环境。
  3. 确认数据刷新、交互控件、多页轮播正常后发布。

4. 进阶能力

能力说明
替换数据集顶栏批量替换组件绑定的数据集
全局参数跨组件传参,配合交互控件
地图类组件色彩地图、气泡地图、飞线地图、多图层地图等
素材库矢量图标、边框装饰、跑马灯、时钟
撤销重做⌘Z / ⇧⌘Z,历史快照

4.1 下一步

上一篇数据填报快速入门下一篇自助取数快速入门