数据集- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：天玑科技-叶然

历史版本：53

最近更新：yzmcskkk8262071 于 2022-09-14

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：预览	右击数据集选择「预览」，或在工具栏直接点击「预览」按钮，即可预览所选数据集。预览界面复制数据集：进入预览界面后，用户可以直接使用鼠标框选，也可以通过 shift 键来多选单元格。然后使用 control/command+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 端查看时就会自动生成树形层级结构	树数据集