1. 概述编辑
1.1 版本
报表服务器版本 | JAR 包版本 | 插件版本 |
---|---|---|
10.0 | 2019-01-01 | 1.0 |
1.2 应用场景
用户通过报表对文件上传下载
1.3 功能介绍
报表填报属性界面,自定义提交中新增上传类型选择悦享版文件上传
超级链接新增一个链接类型 悦享版文件下载
支持多文件上传
支持按钮或者其他控件的事件进行文件上传
支持APP文件下载
支持H5文件下载
支持报表扩展单元格文件下载
支持填报动态计算文件下载
支持报表集群服务器
支持文件上传或下载的类型:
1).服务器本地目录
2).FTP
3).SFTP
4).AWS S3(亚马逊S3),包括阿里云OSS,腾讯云COS,华为云OBS等支持兼容AWS S3接口的存储服务
2. 插件介绍编辑
需要给出如下详细的模板设计步骤,如果不需要示例模板,需要改成详细的操作步骤
2.1 插件安装
点击下载插件:悦享版文件上传下载插件
设计器插件安装方法参照:设计器插件管理
服务器安装插件方法参照: 服务器插件管理
2.2 操作说明
需要给出 PC 端和移动端的预览截图,如果不支持移动端需要注明,H5 端和 App 端如果有区别要分开截图
2.2.1 连接设置
只针对非服务器本地目录设置。
在报表填报属性界面,点击如下图所示的按钮,选择菜单即可。或者在设计器的服务器菜单下点击悦享版上传下载连接信息菜单
1)FTP/SFTP配置界面
按标签说明,填写FTP/SFTP参数,填完后点击测试连接按钮,测试能否正常连接
2)S3协议配置界面
、
若存储空间(Bucket)存在多个,用逗号隔开填入即可
按标签说明,填写FTP/SFTP参数,填完后点击测试连接按钮,测试能否正常连接
2.2.2 文件上传
1)填报自定义提交
在普通报表编辑状态下,点击菜单 模板->报表填报属性 界面,如下图所示
位置1 添加自定义提交
位置2 选择提交类型选择悦享版文件上传
位置3 设置连接类型
位置4 设置是否对重复文件覆盖
位置5 设置上传文件参数,支持字符串和公式
上传目录为文件要上传的路径,为绝对路径
文件名为上传文件名,若为空,则默认为上传文件的原始文件名
文件为文件控件所在的位置,请参考文件控件简介
此功能目前只支持填报报表和决策报表(即能够使用文件控件的报表)。
选择控件的事件栏,添加事件,选择点击事件,位置2下拉列表中选择悦享版文件上传即可。
注意: 文件列中的公式必须是文件控件的参数或者是放置文件控件的单元格
2.2.3 文件下载
选择报表单元格的超级链接,添加链接选择悦享版文件下载
位置1 添加链接
位置2 设置连接类型
位置3 设置文件下载目录,为绝对路径,支持字符串和公式
位置4 设置下载文件名,支持字符串和公式
3. 注意事项编辑
文件上传支持多个文件一起上传
文件下载只支持单个文件下载,不支持目录下载
4. 使用场景说明编辑
1.针对文件上传文件名设置
(1).若文件名为空,则使用文件的原始文件名
(2).若文件名没有后缀,则会在文件名上添加原始文件名后缀
(3).文件名支持函数,用参数$delight_upload_original_file_name 表示原始文件名,参与函数计算
(4).对于多文件上传,文件名设置
(4.1).文件名为为空,使用原始文件名
(4.2).用函数动态生成文件名,比如UUID函数
(4.3).用数组,可以用函数SPLIT生成数组或者用函数FILENAME生成原始文件名的数组
这样,可以保证文件名是多个且不重复
2.文件上传的文件设置
文件用的公式必须是文件控件的参数或者放置文件控件的单元格,目前只有填报报表和决策报表支持文件上传
3.对于IIS搭建的FTP服务器,在设置服务器连接时,建议将编码设置为GBK