1. 概述
1.1 版本
| FineReport版本 | 功能变动 |
|---|---|
| 11.0 | - |
| 11.0.4 | 优化数据集管理，新增「搜索」、「复制」、「批量选择数据集」功能。具体请参见本文第三章内容 |
| 11.0.7 | 数据表搜索框位置移动到上方，用户可在该搜索框中搜索数据表。具体请参见本文第四章内容 |
1.2 功能简介
数据集是指可直接应用于模板设计的数据展现集合。
按其来源范围数据集可以分为 数据库查询 ， 内置数据集 ， 文件数据集 ， SAP 数据集， 存储过程 ， 多维数据库 、关联数据集 以及 树数据集。
注：数据集的名称中不能包含英文标点「 . 」
2. 添加数据集
在 FineReport 中用户可以添加「服务器数据集」或「模板数据集」两种，可根据自己的需要进行添加。
2.1 服务器数据集
服务器数据集是对应于整个报表工程的，更换一个模板或新建一个工作簿，仍然可以用服务器数据集中的数据。
具体的添加方式可参见：服务器数据集
2.2 模板数据集
模板数据集是对应于当前模板的，保存在这个模板的 cpt 文件中，不能与其他模板公用，是私有的。
添加方式一 A 删除； B 复制；C 上移数据集；D 下移数据集；E 数据集排序
添加方式二
2.3 数据集类型
根据数据来源，数据集类型分为： 数据库查询 ， 内置数据集 ， 文件数据集 ， SAP 数据集， 存储过程 ， 多维数据库 、关联数据集 以及 树数据集
| 数据集类型 | 定义 |
|---|---|
| 数据库查询 | 对数据源中的数据库表，直接使用 SQL 语句，来选择所需要的数据字段 |
| 内置数据集 | 新建一个类似数据库表的原表，可作为模板的数据源来设计报表 |
| 文件数据集 | 是指以 TXT 文本文件、Excel 文件和 XML 文件中的数据为数据集，并以二维表的结构展示在数据集当中 |
| SAP 数据集 | 先建立一个 SAP 数据连接，通过该数据连接建立 SAP 数据集 |
| 存储过程 | 存储过程，就是直接将存储过程作为数据集，不需要在数据库查询而是去调用存储过程 |
| 多维数据库 | 在XMLA 数据连接的基础上，新建多维数据库 XMLA 数据集 |
| 关联数据集 | 在不同的数据源进行筛选取数；访问不同的数据库；利用来自不同的数据源形成一个数据集 |
| 树数据集 | 为控件绑定树数据集， Web 端查看时就会自动生成树形层级结构 |
2.4 慢数据集
当一个数据集执行时间超过 2 s 时，那么它在设计器中的数据会比实际数据慢。系统会给该数据集加上慢数据集标志图，如下图所示：
3. 管理数据集
用户可以通过界面左下角对已添加的数据集进行管理，如下图所示：
| 功能 | 介绍 |
|---|---|
| A：编辑 | 右击数据集选择「编辑」，或在工具栏直接点击「编辑」按钮，即可对数据集进行编辑修改 |
| B：删除 | 右击数据集选择「删除」，或在工具栏直接点击「删除」按钮，即可删除所选数据集 |
| C：预览 | 右击数据集选择「预览」，或在工具栏直接点击「预览」按钮，即可预览所选数据集。
|
| D：定义数据连接 | 进入「数据连接」配置页面，方便修改对应的数据库连接信息 |
E：开启全部数据缓存 F：关闭全部数据缓存 | 对于报表执行速度而言，数据源取数性能是存在较大影响的一环 如果对于数据的实时性要求不高能接受半小时左右的更新频率，使用缓存是一种既能降低服务器和数据库压力，又能提升报表执行速度的方案 详细请参见：抽数缓存介绍 |
| G：搜索 | 点击「搜索」，用户可以输入关键字后「回车」，可匹配查找「模板数据集」「服务器数据集」和「数据列名称」，如下图所示： 注：若数据集报错，则该数据集的 数据列 与 其数据集名称 均不参与检索
|
H：复制 I：粘贴 | 选中目标「数据集」或「字段名」，右击选择「复制」键，然后在需要粘贴的地方右击选择「粘贴」键
注：关联数据集、树数据集这类数据集在复制粘贴时，需要先把用到的依赖数据集先复制粘贴到目标位置，然后再复制粘贴关联数据集、树数据集才可以成功。
支持模板块级复用，当用户复制了图表或控件等时，这些图表控件使用的数据集也会被一同复制过来
|
| 批量选择数据集 | 支持 ctrl 与 shift 键多选数据集进行批量管理
|
4. 功能变动
4.1 11.0.7 及之后版本
数据表搜索框位置移动到上方，用户可在该搜索框中搜索数据表。如下图所示：
5. 索引
| 序号 | 内容 | 简介 | 文档教程 |
|---|---|---|---|
| 1 | 数据库查询 | 对数据源中的数据库表，直接使用 SQL 语句，来选择所需要的数据字段 | 数据库查询 |
| 2 | 内置数据集 | 新建一个类似数据库表的原表，可作为模板的数据源来设计报表 | 内置数据集 |
| 3 | 文件数据集 | 是指以 TXT 文本文件、Excel 文件和 XML 文件中的数据为数据集，并以二维表的结构展示在数据集当中 | 文件数据集 |
| 3.1 | 文本数据集：就是指数据源是一系列的 TXT 文本文件 | 文本数据集 | |
| 3.2 | Excel 数据集：就是指数据源是一系列的 XLS 文件 | Excel 数据集 | |
| 3.3 | 远程 Excel 数据集：通过 URL 方式访问 JSP 页面，将对应的 Excel 文件作为数据集 | 远程 Excel 数据集 | |
| 3.4 | XML 数据集：就是指数据源是一系列的 XML 文件 | XML 数据集 | |
| 4 | SAP 数据集 | 先建立一个 SAP 数据连接，通过该数据连接建立 SAP 数据集 | SAP 数据集 |
| 4.1 | 自定义取数：就是直接调用 ABAP Function 获取数据 | 自定义取数 | |
| 4.2 | 简单通用查询取数：通过 open SQL 语句，从某张表中读取出某些列，并列出数据需要满足的一些条件 | 简单通用查询取数 | |
| 4.3 | 通用查询取数：通用查询较之简单通用查询，增加了表间关联的能力，支持多表查询 | 通用查询取数 | |
| 4.4 | 通用查询取数中的函数：对 EXTRACT_TABLE_DATA 的创建过程及出现的问题解决进行详细说明 | 通用查询取数中的函数 | |
| 5 | 存储过程 | 存储过程，就是直接将存储过程作为数据集，不需要在数据库查询而是去调用存储过程 | 存储过程 |
| 6 | 多维数据库 | 在XMLA 数据连接的基础上，新建多维数据库 XMLA 数据集 | 多维数据库 |
| 6.1 | 简单通用查询：指 FineReport 通过 XMLA 连接上多维数据库之后，直接展示多维 CUBE 结构 | 简单通用查询 | |
| 6.2 | 自定义 MDX 查询：指用户直接在 MDX 语句输入框中输入 MDX 查询语句，FineReport 再通过该语句去多维数据库取数 | 自定义MDX查询 | |
| 7 | 关联数据集 | 在不同的数据源进行筛选取数；访问不同的数据库；利用来自不同的数据源形成一个数据集 | 关联数据集 |
| 8 | 树数据集 | 为控件绑定树数据集， Web 端查看时就会自动生成树形层级结构 | 树数据集 |
