OARS Docs

Appearance

大屏设计器 ​

大屏设计器用于创建可视化数据大屏，支持拖拽式设计和多种数据源绑定。

适用场景 ​

  • 管理者：创建业务监控大屏，实时查看 KPI 和流程数据
  • 业务分析人员：通过图表和数据展示分析结果
  • 展厅/汇报场景：在大屏幕或投影上展示数据可视化

功能概述 ​

  • 项目管理：新建、复制、删除大屏项目，按状态筛选（草稿/已发布/已停止）
  • 可视化设计器：拖拽式设计画布，内置 70+ 种组件
  • 组件库：装饰、KPI 指标、业务流程图、图表（柱状/折线/饼图等）、数据表格、地图、3D 地球、时间轴、筛选器等
  • 数据绑定：支持静态数据、系统数据源、运行时业务模块、流程分析预设四种方式
  • 筛选联动：筛选器写入全局变量，流程类组件默认可按部门、人员、日期范围、快捷范围（今日/本周/本月）过滤
  • 全局变量：在画布属性中配置初始变量，供筛选器与参数绑定使用
  • 动画效果：组件入场动画（淡入、上滑、缩放等）
  • 设计预览与播放：设计画布内为静态样例预览；「播放」在新窗口打开真实数据
  • 缩放模式：画布属性可选 fit（窗口自适应）或 scroll（原始尺寸滚动查看）
  • 撤销/重做：完整的编辑历史
  • 发布分享：发布后可复制公开链接（Token 分享），链接可随时换新或停用

操作说明 ​

创建大屏项目 ​

  1. 进入大屏设计器（菜单或 /screen）
  2. 点击「新建大屏」，系统创建空白项目并自动进入设计器
  3. 在画布属性中设置尺寸（推荐使用预设：1920×1080 或 3840×2160）

设计大屏 ​

  1. 从左侧组件库拖拽组件到画布
  2. 选中组件，在右侧属性面板中配置：
    • 基础属性：标题、文本、数值等
    • 样式：边框、透明度、旋转、动画
    • 数据源：选择数据绑定方式并映射字段
    • 事件：配置点击事件（打开链接、刷新数据等）
  3. 通过画布工具栏缩放、拖动，调整组件位置和大小
  4. 使用筛选器组件（下拉框、日期、快捷按钮等）创建交互式大屏
  5. 点击画布空白处，在「画布」属性中维护全局变量（如 deptId、dateRange 的默认值）

绑定数据源 ​

大屏支持四种数据来源：

  • 静态数据：直接填写 JSON 数据
  • 系统数据源：引用已配置的 SQL 数据源
  • 业务模块：引用运行时业务模块的数据
  • 流程分析：使用内置的流程分析预设（待办统计、审批趋势、审批轨迹等）

流程类组件默认将筛选变量映射为查询参数；如需自定义，可在数据源「高级设置 → 参数绑定」中调整。

字段映射保存在数据源配置中，运行时与组件属性合并后生效。

预览和发布 ​

  1. 设计器画布内展示静态样例，便于排版，不会请求真实接口
  2. 点击「播放」在新窗口查看真实数据效果
  3. 确认无误后点击「发布」；成功后可直接复制公开链接
  4. 公开链接只能访问当前大屏实际引用的数据源、运行模块和流程预设，不能用于查询未绑定资源
  5. 链接发到了不该发的地方，点「换链接」重新生成，原链接立即失效，大屏本身保持发布状态

常见问题 ​

大屏列表看不到同事建的大屏？ 列表受角色「数据范围」限制，标题旁会显示当前范围标签。需要看到更多请让管理员放宽角色数据范围，见 角色权限。

设计器和播放效果不一样？ 设计器画布为静态样例预览；真实数据与筛选联动请在「播放」或发布后的公开页查看。播放页默认按窗口自适应缩放（fit）；若画布设为 scroll，则按原始尺寸显示并可滚动。

业务模块表格只有一页？ 表格绑定「运行模块」时会走服务端分页，翻页会请求 GET /app/runtime-biz/{moduleKey}。可在组件属性中设置 pageSize，或调整表格高度以改变默认每页行数。

监控流无法播放？camera-stream 支持 MP4（原生）、HLS（Safari 原生 / 其他浏览器 hls.js）、FLV/HTTP-FLV（mpegts.js）。不支持时可配置 fallbackUrl 作为备用预览地址。

地图显示示意区块而非真实边界？ GeoJSON 加载失败（离线、数据源不可达）时会自动回退示意地图，并在组件内提示错误原因。私有化部署可设置 VITE_SCREEN_MAP_BASE_URL 指向自建边界数据。

筛选器改了但流程图表不变？ 请确认：① 已添加部门/日期等筛选器；② 流程组件使用「流程预设」绑定；③ 部门筛选值为数字型部门 ID（来自部门数据源选项）。人员筛选同理。

如何让图表数据自动刷新？ 在组件的数据源配置中设置刷新间隔（秒），数据将按间隔自动更新。

公开分享安全吗？ 公开链接使用随机 Token，只有知道链接的人才能访问，并且后端会校验公开大屏是否引用了对应数据源、运行模块或流程预设。收回分享有两种做法：点「停用」整块下线；或点「换链接」只让旧地址失效、新链接继续可用。

浏览器访问 ​

  • 项目列表：/screen
  • 设计器：从项目列表进入
  • 播放：设计器或列表中「播放」/「公开」

侧栏挂载（管理员） ​

若希望业务用户在侧栏直接进入某个已发布大屏（而非先进设计器列表），管理员可在 系统配置 → 菜单管理 使用 快速挂载 → 大屏播放页，挂到合适目录后在 角色权限 中授权。与设计器列表菜单相互独立。