模版数据集概述
模版数据集是复杂报表里「只给当前 .vrp 模版用」的数据来源。说明与全局数据集的区别、支持的六种类型,以及从哪里新建。
模版数据集(设计器界面也写作「模板数据集」)是绑定在当前复杂报表模版 (.vrp) 上的数据来源:换一张报表不会自动带上这些数据集。适合「这张表专用」的 SQL、上传文件或接口;若多张报表要共用同一口径,请改用数据中心 · 全局数据集。
产品入口:工作台 数据分析 → 复杂报表 → 打开设计器 → 左侧 数据集 面板 → 选中 模板数据集 Tab。
1. 和全局数据集有什么不同
| 对比项 | 模版数据集 | 全局数据集 |
|---|---|---|
| 作用范围 | 仅当前报表模版 | 多张报表 / BI 等可引用 |
| 维护位置 | 报表设计器左侧面板 | 数据中心 → 数据集 |
| 典型用途 | 单表专用 SQL、临时 Excel/CSV | 主题口径、多处复用 |
| 重名规则 | 与已选全局数据集也不能重名 | 按数据中心规范命名 |
2. 支持哪些类型
在「模板数据集」Tab 点工具栏新建,可创建以下类型:
| 类型 | 说明 | 文档 |
|---|---|---|
| 数据库查询 | 选 JDBC 数据源,写 SQL(可带 ${参数}) | 数据库查询 |
| 内置数据集 | 在弹窗里手工维护行列,适合演示与小静态表 | 内置数据集 |
| Excel 数据集 | 上传 .xls / .xlsx,按表取数 | Excel 数据集 |
| API 接口 | 按 URL 请求 JSON,可用 JSON Path 取列表 | API 接口 |
| Json 文件 | 上传本地 JSON 文件作为数据源 | Json 文件 |
| CSV 文件 | 上传 CSV 文本表 | CSV 文件 |
3. 怎么新建(通用步骤)
- 打开或新建复杂报表,进入设计器。
- 左侧切换到 模板数据集。
- 点击工具栏对应类型图标(数据库查询 / 内置 / Excel / API / Json / CSV)。
- 填写名称(勿与本报表已有数据集重名),按类型完成配置后保存。
- 在面板中展开字段,拖到单元格绑定;需要时再点编辑或预览。
4. 使用建议
- 正式报送、多人共用的口径 → 优先全局数据集。
- POC、客户样例、一次性 Excel → 用模版数据集更省事。
- SQL 里要用查询条件 → 数据库查询或 API 中用
${参数名},再在参数面板联动。
本文不覆盖:全局数据集建模、数据源驱动安装(见数据中心文档)。
常见问题
Q:界面写「模板」文档写「模版」是不是两套功能?
A:不是。同一能力;文档目录统一用「模版数据集」,设计器 Tab 文案可能写作「模板数据集」。
Q:建好后别的报表能看到吗?
A:不能。模版数据集只存在当前 .vrp 里;需要共享请做成全局数据集再引用。
Q:和「全局数据集」Tab 里勾选有什么区别?
A:全局是引用已有资产;模版是在本报表内新建私有数据源。两者字段都能拖进格子,但名称不能冲突。
