1. 概述
1.1 版本
| BI 服务器版本 | JAR 包 | 功能变更 |
|---|---|---|
| 5.1 | 2020-01-15 | - |
| 5.1.9 | 2021-01-06 | 新增支持从平台添加文件数据集 |
| 5.1.17 | - | 直连版本开始支持服务器数据集 |
1.2 功能简介
抽取数据下，BI 工程支持添加 3 种服务器数据集：SQL 数据集、树数据集、文件数据集。
服务器数据集主要为了方便企业管理员工信息，管理员可从服务器数据集中 同步用户 。
服务器数据集作用于整个 BI 工程，用户可以使用服务器数据集添加数据库表。
2. 添加权限
超级管理员默认可从 BI 工程添加服务器数据集。普通用户如需添加，需要超管授予权限。
超级管理员登录数据决策系统，点击「管理系统>权限管理>全局设置」，打开「分级授权」和「数据连接控制」，点击「保存」。如下图所示：
超级管理员登录数据决策系统，点击「管理系统>权限管理」，选择权限载体「部门/角色/用户」，选择具体项，打开「管理系统>数据连接>查看权限」。如下图所示：
注：如需创建 SQL 数据集，需要额外获得数据连接的使用权限。
超级管理员登录数据决策系统，点击「管理系统>权限管理>权限配置」，选择权限载体「部门/角色/用户」，选择具体项，打开「数据连接>使用权限」。如下图所示：
3. 服务器数据集添加方式
3.1 在 BI 中直接添
拥有权限的用户登录 BI 工程，点击「管理系统>数据连接>服务器数据集」，点击「创建数据集」。
支持在数据决策系统添加 SQL 数据集、树数据集、文件数据集。如下图所示：
注：2021-01-06 之后的 BI 工程，支持创建文件数据集。
各种数据集的具体设置方式如下表所示：
| 数据集类型 | 简介 | 文档教程 | |
|---|---|---|---|
| SQL 数据集 | 数据源是数据连接的数据库中的表数据 | SQL 数据集 | |
| 树数据集 | 数据源是有层级关系的 SQL 数据集 | 树数据集 | |
| 文件数据集 | 文本数据集 | 数据源是一系列的 TXT 文本文件 | 文本数据集 |
| Excel 数据集 | 数据源是一系列的 XLS 文件 | Excel 数据集 | |
| XML 数据集 | 数据源是一系列的 XML 文件 | XML 数据集 | |
3.2 通过 FineReport 远程设计添加
FineReport 设计器中还可以添加更多服务器数据集类型：程序数据集、内置数据集、存储过程、关联数据集、JSON 数据集、JSON 程序数据集
用户如需在 BI 工中添加上述类型的服务器数据集，可以通过 FineReport 设计器远程连接 FineBI 工程 ，在 FineReport 设计器中创建服务器数据集 ，BI 工程中即可出现该服务器数据集。
| 数据集 | 数据集简介 |
|---|---|
| 程序数据集 | 通过 AbstractTableData 抽象类来读取用户自定义的数据源 |
| 内置数据集 | 使用 FineReport 自身做的类似数据库表的原表 |
| 存储过程数据集 | 将数据库的存储过程查询为数据集 |
| 关联数据集 | 参见<关联数据集>的第 1 节 |
| 树数据集 | 添加有层级关系的数据集 |
| MongoDB 数据连接 | BI 暂不可以直接连接 MongoDB 数据库，使用 FineReport 连接 MongoDB 实现数据集，然后 BI 调用 |
3.2.1 直连版本注意事项
1. 服务器数据集的数据受缓存参数「缓存设置」和「缓存时间」限制，详细可参见：常规
2. 服务器数据集不支持和「数据库表」和「SQL数据集」联合查询（包括：上下合并、左右合并、关联），若进行了联合查询，系统会报错：不支持服务器数据集和DB表，SQL表联合查询
3. 服务器数据集支持和「Excel数据集」联合查询。
4. 效果预览
该页面列出所有数据集，包含 FineReport 设计器远程连接 BI 工程时创建的服务器数据集数据集。
平台支持添加的服务器数据集类型：SQL 数据集、树数据集、文件数据集
FineReport 设计器支持添加的服务器数据集类型：SQL 数据集、程序数据集、内置数据集、文件数据集、存储过程、关联数据集、树数据集、JSON 数据集、JSON 程序数据集
注：所有定义的服务器数据集信息都保存在 FineDB 的 fine_conf_entity 表中。
1）若服务器数据集类型非 SQL 数据集、树数据集、文件数据集
不支持在平台预览数据集内容。提示：该数据集类型仅支持在设计器中预览。如下图所示：
鼠标悬浮在数据集上，可删除数据集。如下图所示：
2）若服务器数据集类型为 SQL 数据集、树数据集、文件数据集
选中数据集，点击「预览」，可预览数据集内容。如下图所示：
选中数据集，点击「编辑」，可修改数据集，点击「保存」即可。如下图所示：
鼠标悬浮在数据集上，可删除/重命名数据集。如下图所示：
5. 服务器数据集的使用
5.1 在同步数据集中使用
详情请参见：同步用户
5.2 使用服务器数据集创建组件
1）进入「数据准备>添加表>数据库表」，如下图所示：
2）选择「服务器数据集」，便可以将服务器数据集添加到数据准备列表中。
3）如下图，即可使用服务器数据集创建组件。
