历史版本68 :Excel导入简介 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 学习视频

本文学习视频:Excel导入简介

1.2 功能简介

FineReport支持填报时,将Excel中的数据直接导入到填报页面,适用于批量填报的场景。

2. 导入方式编辑

目前支持的导入方式及适用场景如下:

a.png

下表列出每种方式的说明和详细文档链接:

导入方式说明
Excel标记导入
(官方推荐导入方式)整合了原有的Excel导入逻辑和导入方式,可以智能识别Excel进行导入,适用于90%以上的导入场景。
自定义导入
可以自由设置导入的列和行,支持对每个sheet设置不同的导入属性。
批量导入
通过决策平台导入 Excel,去除了预览的过程,在导入的同时实现提交数据。适用于大数据量的导入场景。
普通导入
默认的导入按钮功能,会按照设置的导入逻辑执行导入,等同于覆盖导入。

3. 导入逻辑编辑

导入方式导入逻辑
Excel标记导入

默认按照标题匹配。只有标题匹配成功的列/行会被导入。

“内容区域外”的内容可以按照位置

自定义导入
如果标题行设置为0,则默认按照标题匹配;否则以Excel中的顺序为准导入
批量导入
默认按照标题匹配,可以通过excel导入逻辑插件修改逻辑
普通导入
默认按照标题匹配,可以通过excel导入逻辑插件修改逻辑

注:Excel标记导入,不受excel导入逻辑插件的影响。

4. 导入支持场景编辑

4.1 支持场景

说明:以下场景都可以通过Excel标记导入实现,需要下载Excel标记导入插件


场景图示
1单行表头,表头部分无横向扩展
2单行表头,表头部分存在一个横向扩展
3导入内容区域外的部分9.png
4
自由报表,不存在扩展单元格
5
多层表头
6
表头部分有多个横向扩展的数据集
7
内容区域由多个数据集组成
8
内容区域有多行扩展行
9
横向导入,即内容区域为横向
pageId 301343546attachmentId 306447891.png
10
Excel有多个sheet页需要导入

4.2 不支持场景

序号场景图示
1
存在斜线的单元格无法识别

2
多数据区域无法导入

3Excel内容区域存在分组合并时,导入后会自动拆成列表


5. 配置规范(重要)编辑

针对常见的一些Excel导入问题,以下总结几条模板配置的基础规范。

1)建议优先使用Excel标记导入

2)导入区域存在数据字段时,需要设置成列表展示。当前导入只支持列表。

3)导入区域的单元格,需设置成可扩展。其他部分则不建议设置为扩展,可能会干扰后台程序判断。

4)尽可能使用Microsoft Excel 2007及以上版本,对于WPS Excel和Microsoft Excel低版本不保证兼容。

5)建议模板的导入区域表头部分,设计成和Excel表头部分一致,通过标题匹配。


6. 注意事项编辑

1. 导入Excel时不会触发控件自身设置的校验规则,可以使用报表填报属性设置中的数据校验功能来设置。

2. 模板中设置了公式的单元格,如果在导入Excel时被Excel中的数据覆盖了,则无法再触发公式联动计算的效果。

3. 数据量(行*列)超过10w的导入,可以考虑使用批量导入功能。

4. 10.0.19.2版本(2021.10.15jar)后,导入模板中如果存在汇总类计算公式(max,sum等),且涉及到的数据量较多的话,可能会触发智能运维的智能释放功能,造成Excel导入终止。此时可以简化公式,避免将公式放在扩展行中,或者联系技术支持协助优化。

5. 如果遇到所有Excel都无法导入的问题,可以检查下是否是因为网络限制,导致上传文件请求阻塞了。例如nginx的client_max_body_size设置,默认为1M,就会影响到文件上传和Excel导入,使得超过1M的文件无法上传。

6. 不支持导入图片。