近期对移动端的报表开发颇有研究,细磨精算了好久,尽管到如今还是”囊中羞涩”,但决定还是先抛砖引玉,拿点小干货出来和大家分享。
研究的工具是比較有代表性的FineReport。
1、 移动端哪些地方支持调用js
web事件 | 分页预览 | 填报预览 |
载入结束事件 | √ | X |
填报成功事件 | -- | √ |
报表内部js | 单元格 | 图表 |
超级链接js | √ | √ |
控件事件 | 參数控件 | 填报控件 | 表单控件 |
初始化后事件 | √ | √ | 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() | 页面再现的时候自己主动刷新 | / | √ |
以上相应着报表的功能大致罗列了以下框架。以下先举一些小演示样例
获取控件的一系列方法
this.options.form.getWidgetByName("控件名"); //參数界面及表单中获取控件
contentPane.getWidgetByCell("单元格"); //填报界面获取控件
contentPane.getWidgetByName("控件名"); //填报界面获取控件
填报成功后刷新当前页
var url = "/WebReport/ReportServer?reportlet=js/shauxindangqian.cpt&op=write&__replaceview__=true"; FR.doHyperlinkByGet(url,{para:paravalue}); //刷新当前页面
js获取表单图表组件并刷新数据
var c=FR.Chart.WebUtils.getChart("chart0"); c.dataRefresh();
延时函数
setTimeout(function() { }, 500);
A超链至B填报,B提交数据后返回A时。A自己主动刷新显示新的数据
contentPane.setAppearRefresh(); //在A的载入结束后事件中加入js
以后会陆续分享一些移动端有用功能的应用实例啦,还有HTML5。