［平台］Excel数据集

1.1 版本

1.2 功能简介

Excel 数据集，就是指数据源是一系列的 Excel 文件。

管理员可以将这些文件作为数据来源，用 FineReport 来呈现这些数据，并做相应的数据分析。

超级管理员默认可从数据决策系统添加服务器数据集。普通用户如需添加，需要超管授予权限。

超级管理员登录数据决策系统，点击「管理系统>权限管理>全局设置」，打开「分级授权」和「数据连接控制」，点击「保存」。如下图所示：

超级管理员登录数据决策系统，点击「管理系统>权限管理>权限配置」，选择权限载体「部门/角色/用户」，选择具体项，打开「管理系统>数据连接>查看权限」。如下图所示：

服务器数据集支持两种 Excel 文件格式：xls 和 xlsx 。

服务器数据集支持三种方法调用 Excel 文件，用户可根据自身情况进行选择。

1）服务器文件：Excel 文件存储在报表工程的%FR_HOME%\webroot\WEB-INF\reportlets目录下。

2）本地文件：Excel 文件存储在用户电脑上，调用后自动存储至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets\excel目录下。

3）远程 URL 文件：Excel 文件存储在某个服务器端，调用该文件的访问 URL 即可。

3.1 服务器文件

将准备好的 Excel 文件上传至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets目录下。如下图所示：

拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 Excel。

3）文件来源选择「服务器文件」，选择 reportlets 目录下的 Excel 文件。

3.2 本地文件

拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 Excel。

3）文件来源选择「本地文件」，选择本地电脑准备好的 Excel 文件。上传成功后跳出提示框：Excel 上传成功！

已上传的文件自动存储至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets\excel目录下。如下图所示：

注：若该目录下存在同名文件，则无法成功上传。

3.3 远程 URL 文件

将 Excel 文件存储在某个服务器下，获得该文件的访问 URL。

注：请确保报表工程可成功访问该文件，否则将调用失败。

拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 Excel。

3）文件来源选择「URL」，输入 URL 地址，点击「测试连接」。连接成功后跳出提示框：连接成功！

注：URL地址中若包含中文，必须先进行 URL转码 ，在平台填写转码后的路径，方可正常访问。

1）用户可自定义设置数据集函数。

2）用户可选择调用的 Excel 文件第一行是否包含标题。

点击保存，即保存服务器数据集。

5.1 本地文件上传失败

问题描述：

本地文件上传失败，提示：XXX文件已经存在，但此时系统「服务器数据集>文件数据集」中未使用该文件。如下图所示：

原因分析：

用户曾经使用本地文件的方法调用过同名文件。

本地文件在调用后会自动存储至 BI 工程，并且在「管理系统>服务器数据集」页面中删除该文件数据集时，不会删除 BI 工程下的该文件。

因此，再次上传时，会因为同名文件的存在而导致上传失败。

解决方案：

前往 BI 工程%BI_HOME%\webroot\WEB-INF\reportlets\excel文件夹下找到原同名文件，删除/重命名原同名文件后，重新上传文件即可。