1. 概述
1.1 版本
服务器版本 | JAR 包 | 插件版本 |
|---|---|---|
| 11.0 | 2021-11-17 | 2.8.0 |
1.2 应用场景
本插件用于解决填报预览时 office 文件在线预览问题，功能设计时考虑禁用下载、预览显示水印等手段增加信息展现的安全性。
数据填报场景下，可以附上在线预览文档，起到填报操作提示的作用。文档管理场景中，提供文档在线预览功能，已适配新决策报表。
1.3 功能介绍
支持文件在线预览、文件转换为 pdf 后下载或打印、缩放展示。下载或打印 pdf 的方法见下面属性设置的截图。
支持预览显示水印功能。
支持 doc、docx、ppt、pptx、xls、xlsx 格式的 office\WPS 文档自动转化为 pdf 文件进行预览。
支持 png、bmp、jpg、jpeg格式的图片预览。
支持普通报表、决策报表。
文档地址和背景水印设置支持帆软公式。
提供 iframe 及超级链接模式。
支持加密ftp方式访问服务端文件，不支持匿名免密登录。
支持http/https方式访问服务端文件。
接入第三方文档转换接口（九云图文档格式转换API），提供在线高级转换功能，支持更多文档格式：.dwg, .dwt, .dws, .dxf, .rtf, .doc, .docx, .dot, .dotx, .xls, .xlsx, .ppt, .pptx, .pps, .ppsx, .dps, .wps, .wpt, .et, .wpp, .png, .jpg, .gif, .tif, .bmp, .pdf, .txt, .java, .js, .c, .cpp, .html, .htm, .jsp, .css, .xml, .properties, .log。（第三方接口需要收费，请谨慎使用！！！！！！）
注1：如果不启用高级文档转换功能，则该插件只支持 office 文件转换为 pdf 文件展示，其他类型的文件不支持。
注2：对于超过 15M 的 PPT 文件，加载时间较长，建议将 PPT 转化为 PDF 后挂载。
注3：使用 Adobe Acrobat typewriter tool 增加或者修改的文本在线预览时无法显示。
注4：不支持移动端及APP访问。
注5：目前仅支持使用wps或office软件修改预览文档
2. 示例
2.1 插件安装
帆软市场下载插件：文件在线预览控件
设计器插件安装方法参见 设计器插件管理
服务器安装插件方法参见 服务器插件管理
2.2 设置控件
2.2.1 选择控件
根据实际应用场景选择控件类型，控件类型有两种：
文档在线预览：在报表页以 iframe 的方式展现文件内容，也就是填报预览时，添加该控件的单元格处会直接显示文件内容。
[超链]文档在线预览：填报预览时，点击添加了该控件的单元格，文件内容会显示在新的标签页。
2.2.2 设置控件属性
1）启用高级文档转换（收费）：勾选该功能后，可以启用九云图在线转换 API，使得在线预览支持更多文件，例如 CAD 文档。不想用可以不设置。
注：如果不想使用高级文档转换功能，请不要在设置控件属性时勾选，否则会有如下报错：
2）允许下载：勾选后提供下载和打印按钮，可直接下载转换后的 pdf 文档。不勾选则不允许下载和打印，且禁用鼠标右键功能。
注：文档下载或打印的操作方法如下图所示：
3）背景水印：在线预览时给文件添加水印，根据自己的需要选填。
背景水印设置示例如下图所示：
4）文档地址：填写文档的绝对路径，这是必填项。
文档地址示例如下图所示：
注：文档地址的格式必须按如下图所示来写：
2.2.3 通过 $$$ 实现动态文件地址
动态获取数据集中存放的文件内容。
2.2.4 设置FTP服务地址
地址示例："ftp://username:password@ftpserverip:port/test/1111.pdf?charset=gbk&sftp=true"
如果用户名密码含有特殊字符时，需要对用户名或密码进行一次URI编码
username: ftp用户名
password: ftp密码
ftpserverip:port: ftp服务器地址及端口号
/test/1111.pdf：文件路径
charset:不传默认为utf-8,可通过修改此参数设置编码
sftp:不传默认使用ftp,传递true值时使用sftp
2.3 效果预览
3. 注意事项
3.1 插件安装报错
安装插件，禁用插件后重新启用插件，会出现如下图错误，重启设计器即可恢复：
3.2 IE 浏览器兼容视图不支持
IE 浏览器兼容视图下，如果安装了该插件，那么预览决策报表会有异常，会出现决策报表空白的情况。
IE 浏览器兼容视图设置如下图所示：
控制台报错信息如下：
