1. 概述
1.1 版本
FineReport版本 | JAR 包日期 | 功能变动 |
---|---|---|
10.0 | - | - |
10.0.19 | - | 数据集预览界面支持复制,详情请参见本文第三章内容 |
2022-08-03 | 数据表搜索框位置移动到上方,用户可在该搜索框中搜索数据表。详情请参见本文第四章内容 |
1.2 功能简介
数据集是指从数据库中将数据取出来,可直接应用于模板设计的数据展现集合。
按使用范围数据集可以分为「服务器数据集」,「模板数据集 」两种。
按其来源范围数据集可以分为 数据库查询 , 内置数据集 , 文件数据集 , SAP 数据集, 存储过程 , 多维数据库 、关联数据集 以及 树数据集。
注:数据集的名称中不能包含英文标点「.」
2. 数据集分类
2.1 服务器数据集
服务器数据集是对应于整个报表工程的,更换一个模板或新建一个工作簿,仍然可以用服务器数据集中的数据。
点击「菜单>服务器>服务器数据集」,会弹出「服务器数据集」界面,所有定义的服务器数据集信息都保存在 FineDB 的 fine_conf_entity 表中。
点击「+」,服务器数据集可以从「数据库、程序数据集、内置数据集、文件数据集、存储过程、关联数据集、树数据集」中提取数据,如下图所示:
2.2 模板数据集
模板数据集是对应于当前模板的,保存在这个模板的 cpt 文件中,不能与其他模板公用,是私有的。
点击「菜单模板>模板数据集」,会出现如下界面:
拖拽表至语句输入区域,可快速创建 SQL 查询语句,如下图所示:
2.3 数据集类型
根据数据来源,数据集类型分为: 数据库查询 , 内置数据集 , 文件数据集 , SAP 数据集, 存储过程 , 多维数据库 、关联数据集 以及 树数据集。
数据集类型 | 定义 |
---|---|
数据库查询 | 对数据源中的数据库表,直接使用 SQL 语句,来选择所需要的数据字段 |
内置数据集 | 新建一个类似数据库表的原表,可作为模板的数据源来设计报表 |
文件数据集 | 是指以 TXT 文本文件、Excel 文件和 XML 文件中的数据为数据集,并以二维表的结构展示在数据集当中 |
SAP 数据集 | 先建立一个 SAP 数据连接,通过该数据连接建立 SAP 数据集 |
存储过程 | 存储过程,就是直接将存储过程作为数据集,不需要在数据库查询而是去调用存储过程 |
多维数据库 | 在XMLA 数据连接的基础上,新建多维数据库 XMLA 数据集 |
关联数据集 | 在不同的数据源进行筛选取数;访问不同的数据库;利用来自不同的数据源形成一个数据集 |
树数据集 | 为控件绑定树数据集, Web 端查看时就会自动生成树形层级结构 |
3. 数据集窗口
在设计器左侧的数据集面板中,会显示添加的所有数据集,包括模板数据集和服务器数据集,如下图所示:
注:数据集窗口可以对模板数据集进行增、删、编辑、预览,但是对服务器数据集及存储过程数据集只能进行预览。
用户可在数据集窗口和添加数据集时,都可以对数据集进行预览,如下图所示:
2)在预览界面,用户可以直接使用鼠标框选,也可以通过 shift 键来多选单元格。然后使用 control+c (ios: command+c),就可以复制预览界面的数据。如下图所示:
3)选中表头后拖拽,可以移动该列位置;单击表头单元格可以对该列进行排序。如下图所示:
4)将数据列拉宽,即可看到字段类型。
4. 功能变动
数据表搜索框位置移动到上方,用户可在该搜索框中搜索数据表。如下图所示:
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 端查看时就会自动生成树形层级结构 | 树数据集 |