文件数据集常见问题

本文主要介绍了文件数据集在使用中经常出现的问题以及解决方案。

1.1 排查思路

文件数据集在遇到问题时的常见排查思路如下图所示：

2.1 文件上传读取异常

「数据决策系统>服务器数据集」中，可以将客户端本地的文件上传到服务器的 reportlets/excel、reportlets/xml、reportlets/txt 文件夹下。

网络问题会影响客户端文件上传到服务器，常见的是nginx上传文件大小的限制，需要调整 nginx.conf 文件配置。

2）文件夹没有读写权限

如果服务器文件夹没有读写权限，文件会上传失败，这时需要给服务器文件夹赋读写权限。

2.2 取数失败

1）文件加密

文件数据集如果进行了加密处理，FineReport 将无法加载数据从而导致预览空白，同时日志会报错：Package should contain a content type part [M1.13]。需要用户手动给文件进行解密处理。

2）数据量或文件体积过大触发限制

• 产品目前支持的文件数据集体积最大为 20M，若文件超过 20M将无法取数。

• 在「智能运维>内存管理>模板限制」中的导入 Excel 单元格限制设置会对文件数据集生效。这类原因导致取数失败，需要在数据决策平台中调整导入 Excel 单元格限制即可解决问题。

3）远程数据集网络不通

4）远程数据集 URL 地址类型不支持

FineReport 支持的是浏览器访问就能自动下载的或者直接预览内容的URL地址。如果文件数据集的URL地址用浏览器访问并不会直接下载，而是需要点击操作，这类 URL 地址是不支持的。此外，远程数据集地址不支持使用 ftp 协议或者谷歌云盘文件。

5）远程数据集 URL 地址或参数中包含中文，需要手动转码后再使用。

6）XML 数据不规范。

7）远程设计时 JAR 版本不一致也会导致取数失败，将服务器和设计器 JAR 版本统一即可解决问题。

8）远程设计时报表服务器没有启动好也会出现新建文件数据集选择 Excel 文件不能正常预览的情况，此时重启服务器即可。

2.3 取数缓慢

网络问题导致的取数缓慢，可以优化网络或将文件放到服务器磁盘上离线使用。

2.4 设计器取数与预期不符

1）服务器数据集中文件数据集不支持使用动态时间或公式作为参数。

2）目前 Finereport 的 Excel 数据集只能取到第一个 sheet。

3）设计器默认根据 Excel 第一行数据的格式，对整列数据进行标记处理，需要统一数据格式。

2.5 页面数据展示错误

1）当 Excel 里面字段的标题里面有多余空格时，字段在数据集中预览正常，拖入单元格后预览模板，该字段则不显示，需要用户只能手动处理删除多余空格。

2）Excel 的 HH:mm:ss 格式的时间类型数据不支持识别，会默认格式化成字符串。如果 Excel 中设置的格式日期控件能识别，就保留格式，否则转换为 yyyy-MM-dd HH:mm:ss 格式。

3）甘特图数据设置为无，不会去读取文件数据集中表头空白的列数据，此时将 JAR 包更新至 10.0.19.7 及之后版本即可