上传下载文件插件

1.1 应用场景

有时候用户需要将文件上传到服务器或者FTP进行保存，并且可以提供文件下载。以前 FineReport 实现此功能需要自定义函数实现，但代码实现会比较麻烦。该插件将此功能封装，安装后可以通过可视化界面操作，方便快捷。

1.2 功能限制

• 请确保您的工程可以支持远程设计，不然插件可能无法正常使用

• 同一文件控件上传多个文件时，不支持自定义文件名，会重叠显示

• 上传和下载的路径不支持网络路径
  

• 文件下载重命名功能不支持读取扩展单元格值

• 文件下载路径不支持动态计算公式

• 文件下载不支持「决策报表」

• 不支持删除文件

• 除了FTP外，不支持其他类型的远程服务器上传和下载文件

• 不支持集群环境

• 移动端只支持上传图片类型的文件，不支持上传其他文件和下载功能

• 容器化环境上传文件给主机，需要做容器和主机之间的上传路径文件映射

• 出于安全考虑，需要登录决策平台账号后才可以下载文件

• 不支持在模板 Web 属性中设置文件上传事件

注：如果实际场景受到以上功能限制影响，可以考虑使用悦享版文件上传下载插件解决，其功能和覆盖的场景更多。

2.1 插件安装

插件下载请点击：上传下载文件插件

设计器插件安装方法参照 设计器插件管理

服务器安装插件方法参照 服务器插件管理

2.2 插件功能

2.2.1 上传至服务器

报表填报属性界面，自定义提交中新增了上传类型选择，可选择「上传至服务器」。

同名文件覆盖：默认不勾选。不勾选时，同名文件会自动重命名；勾选后，同名文件会直接覆盖。

2.2.2 上传至 FTP

报表填报属性界面，自定义提交中新增上传类型选择，可选择「上传至 FTP」。

同名文件覆盖：默认不勾选。不勾选时，同名文件会自动重命名；勾选后，同名文件会直接覆盖。

2.2.3 文件下载

超级链接新增一个选项「文件下载」，可以通过设置超级链接，实现从服务器端下载文件，如下图所示：

2.3 设置项格式

注1：文件名如果为空，会默认获取上传的文件名，支持多文件上传。如果不为空，则不支持多文件上传，文件名会重叠。

注2：下载重命名功能不支持读取扩展单元格值。文件下载路径不支持动态计算公式。

3.1 报表设计

1）在FineReport设计器中点击「文件>新建普通报表」。

2）选中A1单元格，为 A1 单元格添加「文件控件」，文件类型选择「全部文件」。如下图所示：

3.2 上传至服务器

1）菜单栏点击「模板>报表填报属性」，添加「自定义提交」，提交类型选择「上传至服务器」，根据实际情况输入磁盘路径、文件、文件名。如下图所示：

具体设置项说明如下表所示：

2）保存报表，点击「填报预览」，上传文件点击提交，查看文件保存位置即可看到刚上传的文件。如下图所示：

3.3 上传至 FTP

1）菜单栏点击「模板>报表填报属性」，添加「自定义提交」，提交类型选择「上传至FTP」，点击「FTP设置」，弹出「FTP设置页」。

2）点击「FTP设置页」左上角新增按钮，新建一个 FTP 连接，用户需根据实际场景填写连接信息。用户名和密码如没有可以不设置，如下图所示：

注：该配置为服务器级别配置，保存位置为finedb，因此远程环境下直接复制模板无法继承ftp配置，需要使用远程设计功能。

3）设置文件信息，如下图所示：

各设置项说明如下表所示：

4）保存报表，点击「填报预览」，上传文件并提交，查看文件保存位置即可看到刚上传的文件。如下图所示：

3.4 下载文件

1）A2 单元格插入公式=filename(A1)，表示获取 A1 单元格上传的文件名。除了使用公式外，也可以使用数据集字段，手写文件名等方式来设置。

2）选中A2单元格，右边属性面板新增一个「文件下载」类型的「超级链接」，具体设置如下：

4）保存报表，点击「填报预览」，点击下载超链，即可下载文件，如下图所示：

点击下载模板：上传下载文件.cpt