决策报表导出插件

1.1 版本

1.2 应用场景

用户有时需要将决策报表以 Excel、PDF 、Word 格式导出进行预览时，可下载安装「决策报表导出插件」进行实现。

1.3 功能简介

「决策报表导出插件」支持将决策报表整体导出为 Excel、PDF 、Word、图片（png、jpg、gif、bmp）格式。

注：如需导出决策报表为 PPT、image 格式，请参见 决策报表导出 Plus 插件 。

不支持的功能项如下：

1）JAR 包为 2018-12-27 及之后版本，需要将插件升级为 3.0 及以上版本，否则无法导出。

2）不支持导出控件。

3）不支持导出 body 背景；不支持导出组件在「样式」处设置的背景和边框。

4）不支持决策报表存在重叠的图表块或报表块。

5）Tab 组件只导出第一个 Tab 页；翻页只导出当前页。

6）JAR 包为 2020-08-31 之前版本导出 Word 不支持图表组件，只支持单元格元素的图表。

7）不可与同类型插件同时启用，如：决策报表导出 Plus 插件、决策报表多标签页导出插件。

8）不支持移动端。

点击下载插件：决策报表导出

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

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

将决策报表整体导出为 Excel、PDF 、Word 格式，只需要在「PC端预览」时的 URL 链接添加后缀&op=export&format=xxx，回车即可导出。xxx 代表导出的格式， 如下表所示：

注：修改文件名可添加参数&__filename__=文件名

注：若安装了 新自适应插件 ，导出的接口略有不同，请参见 决策报表导出新方案 

例如导出决策报表为 Excel ，如下图所示：

决策报表中含有参数时，决策报表或决策报表内的组件内容，会因为参数（例如参数查询，主子报表等）变化而改变。那么使用 URL 导出决策报表时，需要添加 sessionID 来导出当前查询结果，否则导出内容会与参数查询内容不一致。

注：浏览器请求 Web 服务，在创建会话时，服务器会为每一个会话生成一个单独的会话标识，这个会话标识就是 sessionID，以长整形数据类型返回。sessionID 就等于本次会话的 ID 记录。

4.1 添加初始化后事件

打开内置的模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\frm\决策报表入门.frm，选中参数面板「para」，添加「初始化事件」，设置一个参数「aaa」，值选择 F(x) 类型后输入公式：sessionID。步骤如下图所示：

JS 代码如下所示：

alert(aaa);

4.2 获取sessionID导出

1）保存表单，点击「PC端预览」，弹出当前 sessionID，复制当前 sessionID 后，点击确定。如下图所示：

注：sessionID 每次刷新都会变化。

2）导出时，后缀加上&op=export&format=xxx&sessionID=***，xxx 代表导出的文件格式，*** 代表复制的当前 sessionID ，回车即可导出当前的查询结果。

4.3 效果预览

视频演示效果如下：

4.4 模板下载

点击下载模板：带参决策报表导出.frm

通过在参数面板添加「按钮控件」（也可以在 body 直接添加按钮控件），设置参数「aaa」获取当前sessionID  ，添加「点击事件」导出。

5.1 添加按钮

打开内置的模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\frm\决策报表入门.frm，在参数面板中添加「按钮控件」，按钮名称为「导出 Excel」，如下图所示：

5.2 添加点击事件

选中「按钮控件」，添加一个「点击事件」，设置一个参数「aaa」，值选择 F(x) 类型后输入公式：sessionID。如下图所示：

JavaScript 代码如下：

var REPORT_URL = '${servletURL}?viewlet=doc/frm/决策报表入门.frm&op=export&format=excel&sessionID=' + aaa;
window.location = encodeURI(REPORT_URL);

注：将「&format=excel」中的 excel 修改为 pdf 或者 word 即为导出 PDF 或 Word。

5.3 效果预览

保存表单，点击「PC端预览」，点击「查询」按钮后再点击「导出 Excel」按钮。效果如下所示：

注：用户必须先预览查询，得到查询后的界面再导出，若不查询直接导出，导出文件的数据与效果无法保证。

5.4 模板下载

点击下载模板：JS 实现点击按钮导出带参决策报表.frm