反馈已提交

网络繁忙

上传下载文件插件

  • 文档创建者:lu123
  • 编辑次数:78次
  • 最近更新:Carly 于 2021-10-26
  • 1. 概述

    1.1 应用场景

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

    1.2 功能限制

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

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

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

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

    • 不支持删除文件

    • 不支持集群环境

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

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


    2. 插件介绍

    2.1 插件安装

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

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

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

    2.2 插件功能

    2.2.1 上传至服务器

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

    同名文件覆盖:默认不勾选。不勾选时,同名文件会自动重命名;勾选后,同名文件会直接覆盖。

    1614847670210710.png

    2.2.2 上传至 FTP

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

    同名文件覆盖:默认不勾选。不勾选时,同名文件会自动重命名;勾选后,同名文件会直接覆盖。

    1614847752799060.png

    2.2.3 文件下载

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

    4.png

    2.3 设置项格式

    设置项内容示例
    上传路径/文件路径
    公式、固定值
    • A1

    • "D:/photo"(windows)

    • "/data/tomcat/"(linux)

    • "ftp://192.168.1.201/"(FTP

    文件
    公式
    • A1

    文件名空、公式固定值
    • A1

    • "test2"

    • 空(为空时会自动获取文件名)

    重命名 空、公式固定值
    • A1

    • "test2"

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

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

    3. 示例

    3.1 报表设计

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

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

    3.png

    3.2 上传至服务器

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

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

    设置项本次示例说明
    磁盘路径"C:/Users/Leo.Tsai/Desktop/Document/"文件保存位置
    文件A1文件控件所在单元格编号
    文件名

    选填

    • 如果为空,会默认获取上传的文件名,支持多文件上传。

    • 如果不为空,可以自定义或者使用公式生成文件名,但不支持多文件上传,文件名会重叠。

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

    1574826271507574.png

    3.3 上传至 FTP

    1)菜单栏点击「模板>报表填报属性」,添加「自定义提交」,提交类型选择「上传至 FTP」,点击 FTP 设置,添加一个 FTP 连接。

    1574835673588206.png

    2)新建一个 FTP 连接,用户需根据实际场景填写连接信息。用户名和密码如没有可以不设置,如下图所示:

    注:有时候测试连接会失败,但不影响文件上传和下载。

    3)设置文件信息,如下图所示:

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

    设置项本次示例说明
    上传路径"/FineReport Document"

    文件保存位置的相对路径。

    也可以使用绝对路径:"ftp://192.168.1.201/FineReport Document"

    文件A1文件控件所在单元格编号
    文件名

    选填

    • 如果为空,会默认获取上传的文件名,支持多文件上传。

    • 如果不为空,可以自定义或者使用公式生成文件名,但不支持多文件上传,文件名会重叠。

    FTP 站点Test本文 3.3 节第二步骤中的 FTP 连接名称

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

    1574834747508971.png

    3.4 下载文件

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

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

    设置项
    本次示例说明
    文件服务Default支持从服务器或者FTP 下载,如果是FTP的话需要选择对应的FTP连接名
    文件路径"C:/Users/Leo.Tsai/Desktop/Document/Test.xlsx"文件所在磁盘或者FTP位置,不支持动态计算公式
    重命名空 选填,可以对下载的文件进行重命名,不支持读取扩展单元格值
    编码类型UTF-8可以设置编码,以匹配不同编码的环境

    Snag_663251b.png

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

    39FCB2ED-9599-4D14-A4A1-74840E36CC2A.GIF


    4. 模板下载

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


    附件列表


    主题: 填报应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭