报表管理
报表管理用于连接业务数据、配置查询模板，并通过 GoView 设计、发布和查看可视化报表。本手册适用于数据源管理员、报表配置人员和报表查看人员。
首次配置按以下顺序进行：创建数据源 → 测试连接 → 调试查询 → 生成查询密文 → 配置 GoView 控件 → 保存与预览 → 分配角色并发布。
功能入口
先登录管理后台，在“报表管理”中打开对应功能。菜单由管理员按岗位分配；没有菜单或按钮时，请联系管理员核对权限。
| 功能 | 用途 | 操作说明 |
|---|---|---|
| 报表数据源配置管理 | 维护数据库连接、测试连接、调试只读查询 | 数据源管理 |
| 报表查询加解密 | 将查询模板生成密文，或恢复已有模板 | 查询模板与动态参数 |
| GoView 大屏设计器 | 管理项目、配置控件数据、预览与发布 | GoView 设计与发布 |
| 项目卡片“更多 → 分配角色” | 指定可以访问项目的角色 | 角色与权限 |
数据源页面路径为 /report/data-source，加解密页面路径为 /report/query-crypto。GoView 也可从当前系统站点的 /goview/ 进入，项目列表地址形如 /goview/#/project。这些路径属于业务系统，不是本文档站的链接。
管理后台与 GoView 在同一浏览器、同一协议、主机和端口下复用登录。使用管理员提供的统一入口；切换到另一端口、域名、localhost 或 IP 地址后，不会自动共享原站点的登录状态。
按职责阅读
| 您要完成的工作 | 阅读顺序 |
|---|---|
| 只查看已有报表 | 查看与发布 → 常见问题 |
| 使用已有数据源制作报表 | 查询模板 → GoView 配置 |
| 让查看人员自行选择时间范围 | 日期控件与时间范围筛选 |
| 从零配置一张报表 | 数据源管理 → 查询模板 → GoView 配置 → 角色与权限 |
| 给同事开放报表 | 角色与权限 → 查看与发布 |
| 处理报错或旧项目 | 常见问题与旧配置处理 |
| 查找对应版本的官方查询语法 | 官方查询手册与版本说明 |
| 理解 ES 的 SQL、日期统计和 DSL | Calcite SQL 与原生 DSL 详解 |
开始前准备
- 确认当前账号、租户和所需菜单权限正确。
- 数据源管理员准备数据库地址、端口、库名和只读账号；报表配置人员准备业务字段、筛选 条件和展示目标。
- 使用专用测试项目验证查询和图表后，再修改正式报表。
- 修改已有项目之前保留可恢复的项目配置，尤其是仍使用旧数据库查询配置的项目。
普通查看人员不需要数据库密码、明文 SQL 或加解密权限。GoView 报表查询中只选择数据源、粘贴查询密文并填写参数值。
基本概念
| 名称 | 含义 |
|---|---|
| 数据源 | 由管理员维护的数据库连接，可供多张报表使用 |
| 查询模板 | 经过检查的 SQL、ES DSL 或 Redis 只读命令，可定义动态参数 |
| 查询密文 | 服务端生成的 RQ2. 开头内容，绑定数据源及查询规则，供 GoView 使用 |
| 参数定义 | 规定参数名、类型、来源、必填与限制，在生成密文时确定 |
| 动态参数 | 每次查询填写的实际值，只能满足已定义的规则 |
| 项目访问角色 | 决定哪些角色可以访问项目，仍需配合查看、编辑等操作权限 |
| 发布 | 允许通过独立预览地址查看已保存项目，访问者仍需登录并具有权限 |
连接测试成功、查询成功、生成密文成功和图表展示正确是不同的检查环节，应逐步确认。
本手册配图使用示例项目、示例配置和常量查询，仅用于对照页面操作。表单配图不代表连接或查询已验证；图片中的名称、编号及数据不是需要照抄的业务配置。
最后更新时间：2026年9月19日