官方文档

模版数据集概述

模版数据集是复杂报表里「只给当前 .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. 怎么新建(通用步骤)

  1. 打开或新建复杂报表,进入设计器。
  2. 左侧切换到 模板数据集。
  3. 点击工具栏对应类型图标(数据库查询 / 内置 / Excel / API / Json / CSV)。
  4. 填写名称(勿与本报表已有数据集重名),按类型完成配置后保存。
  5. 在面板中展开字段,拖到单元格绑定;需要时再点编辑或预览。

4. 使用建议

  • 正式报送、多人共用的口径 → 优先全局数据集。
  • POC、客户样例、一次性 Excel → 用模版数据集更省事。
  • SQL 里要用查询条件 → 数据库查询或 API 中用 ${参数名},再在参数面板联动。

本文不覆盖:全局数据集建模、数据源驱动安装(见数据中心文档)。

常见问题

Q:界面写「模板」文档写「模版」是不是两套功能?
A:不是。同一能力;文档目录统一用「模版数据集」,设计器 Tab 文案可能写作「模板数据集」。

Q:建好后别的报表能看到吗?
A:不能。模版数据集只存在当前 .vrp 里;需要共享请做成全局数据集再引用。

Q:和「全局数据集」Tab 里勾选有什么区别?
A:全局是引用已有资产;模版是在本报表内新建私有数据源。两者字段都能拖进格子,但名称不能冲突。

相关文档