1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.0.5 | V1.0 |
1.2 应用场景
通过安装「控件自定义提交」插件，支持将数据提交到后台自定义类中。
1.3 注意事项
1）支持在普通报表的「填报预览」、和决策报表中使用
2）支持在单元格控件、参数面板控件、工具栏控件、表单控件中使用
3）自定义类更新后，需要重启报表服务器，方可生效
4）如需在fanruan.log中查看数据输出，需要将帆软应用的日志级别设定为INFO
2. 插件介绍
2.1 安装插件
点击下载插件：控件自定义提交
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 操作方法
1）插件安装成功后，编辑控件事件，新增「自定义提交」类型。
支持普通报表和决策报表
支持在单元格控件、参数面板控件、工具栏控件、表单控件中使用
2）在「类名」中，选择填报处理类class文件
自定义class文件需要存放在工程/webroot/WEB-INF/classes目录下
自定义类需要继承com.fr.data.TotalSubmitJob 或 com.fr.data.DefinedSubmitJob
自定义类更新后，需要重启报表服务器，方可生效
也可点击「编辑」按钮，直接编译新类，编译成功才能正确保存
3）在「属性」中，添加需要上报的属性值
单元格是普通报表特有类型，控件是决策报表特有类型
4）点击「设置回调函数」，支持设置提交完成后的JavaScript代码
插件默认内置了一个回调函数：FR.Msg.toast(fr_submitinfo.success ? "成功" : "失败");
参数fr_submitinfo是提交返回的结果，结构如下：
fr_submitinfo = { success: true failinfo: err_msg } success: boolean类型，表示提交是否成功 failinfo: 包含自定义处理类抛出的异常信息（exception.getMessage()） |
5）最后，保存并运行报表。触发控件事件，后台自定义类就会收到提交的信息
如需在fanruan.log中查看数据输出，需要将帆软应用的日志级别设定为INFO
仅支持在普通报表填报预览、决策报表中使用
3. 示例
3.1 设计报表
新建普通报表，添加模板参数：
新建模板数据集：
设置单元格数据，在E1新建一个单元格按钮控件
添加按钮的点击事件，选择自定义提交：
编辑、编译、保存自定义类：
设置填报属性：
3.2 效果预览
PC端效果：
移动端效果：
服务器端日志效果：
