应用报表工具Finereport的开发人员会发现其移动端app 同样也推出了很多js接口，那这些接口到底有多少，其移动端又有哪些地方支持调用js，这些接口具体又该如何调用呢。根据我平时的开发经验，给大家做个归纳整理，包括接口列表，相关的脚本函数及具体的演示实例，希望大家可以更有效地利用这些js接口来便利相关工作。

1. FineReport移动端哪些地方支持调用js

web事件	分页预览	填报预览
加载结束事件	√	X
填报成功事件	--	√

报表内部js	单元格	图表
超级链接js	√	√

控件事件	参数控件	填报控件	表单控件
初始化后事件	√	X	X
编辑前	√	√	X
编辑后	√	√	X
编辑结束	√	√	X
点击	√	√	X
状态改变	√	√	√

2. 控件支持的脚本函数

函数名	函数描述	填报控件	参数控件	表单控件
setEnable	设置控件的可用性	√	√	√
isEnable	判断控件是否可用	√	√	√
setVisible	设置控件的可见性	√	√	√
isVisible	判断控件的可见性	√	√	√
setValue	设置控件值	√	√	√
getValue	获取控件的值	√	√	√
setText	设置控件的显示值	√	√	√
getText	获取控件的显示值	√	√	√
reset	重置控件	√	√	√
fireEvent	触发指定名字的事件	√	√	√

3. 分页预览报表支持的脚本函数

函数名	函数描述	补充说明	实现
contentPane	当前报表对象	无	√
currentPageIndex	当前所在页	contentPane常用属性只有分页预览报表才有	√
reportTotalPage	总页数	contentPane常用属性只有分页预览报表才有	√
gotoFirstPage	首页	无	√
gotoPreviousPage	上一页	无	√
gotoNextPage	下一页	无	√
gotoLastPage	末页	无	√
gotoPage(n)	跳转到某一页	包含1个参数，表示跳转到第几页	√

4. 填报预览报表支持的脚本函数

函数名	函数描述	补充说明	实现
contentPane	当前报表对象	无	√
verifyReport	数据校验	只有填报表才可以用，contentPane常用方法	√
writeReport	提交报表	只有填报表才可以用，contentPane常用方法	√
verifyAndWriteReport	数据校验后提交报表	只有填报表才可以用，contentPane常用方法	√
curLGP	current logicpane	contentPane常用属性，只有填报预览及表单预览下才有	√
getCellValue(cell)	获取指定格子的值	包含1个参数，单元格，只有填报下有，curLGP常用方法	√
getCellValue(col, row)	获取指定格子的值	包含2个参数，列和行，只有填报下有，curLGP常用方法	√
setCellValue(cell, null, value)	设置指定格子的值	包含3个参数，单元格，空和值，只有填报下有，curLGP常用方法	√
setCellValue(col, row, value)	设置指定格子的值	包含3个参数，列，行和值，只有填报下有，curLGP常用方法	√
getWidgetByCell	获取指定单元格中的控件	包含1个参数，单元格，contentPane常用方法	√
getWidgetByName	获取指定名字的控件	包含1个参数，控件名，contentPane常用方法	√
getWidgetsByName	获取指定名称的扩展控件，返回一个数组	包含1个参数，控件名，contentPane常用方法	√

5. 常用的工具类脚本函数

函数名	函数描述	补充说明	实现
FR.Msg.alert	弹出消息框函数	包含3个参数，分别表示：标题，内容，回调函数	√
FR.Msg.confirm	值确认弹出框函数	包含3个参数，分别表示：标题，值，回调函数	√
FR.Msg.prompt	可修改值的值确认弹出框函数	包含4个参数，分别表示：标题，说明，值，回调函数	√
FR.Msg.toast	在页面边缘出现的消息提示块，一小段时间后自动消失	包含1个参数，表示要提示的信息	√
FR.cjkEncode	进行cjk编码	包含1个参数，字符串	√
FR.cjkDecode	进行cjk解码	包含1个参数，字符串	√
FR.location	地理位置获取	包含一个回掉函数返回获取状态及信息	√
FR.doHyperlinkByGet /FR.doHyperlinkByPost	超级连接	包含2个参数，分别表示：超链的url，传递的参数	√
FR.ajax	异步请求函数	/	√
_g().parameterCommit()	分页预览及填报预览自动查询	/	√
contentPane.setAppearRefresh()	页面再现的时候自动刷新	/	√

6. 具体使用示例

6.1获取控件的一系列方法

1. this.options.form.getWidgetByName("控件名"); //参数界面及表单中获取控件

1. contentPane.getWidgetByCell("单元格"); //填报界面获取控件

1. contentPane.getWidgetByName("控件名"); //填报界面获取控件

6.2填报成功后刷新当前页

1. var url = "/WebReport/ReportServer?reportlet=js/shauxindangqian.cpt&op=write&__replaceview__=true";

2. FR.doHyperlinkByGet(url,{para:paravalue}); //刷新当前页面

6.3 js获取表单图表组件并刷新数据

1. var c=FR.Chart.WebUtils.getChart("chart0");

2. c.dataRefresh()；

6.4延时函数

1. setTimeout(function() { }, 500);

6.5 A超链至B填报，B提交数据后返回A时，A自动刷新显示新的数据

1. contentPane.setAppearRefresh(); //在A的加载结束后事件中添加js

ITPub博客

报表开发工具Finereport移动端app js接口列表【全】