历史版本16 :刷新报表页面的方法总结 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
目录:
1. 概述编辑
1.1 版本
报表服务器版本 |
---|
11.0 |
1.2 应用场景
在报表应用中,我们经常会用到报表页面的刷新,比如报表中有数据更新时需要定时刷新,填报报表中填报成功后需要刷新,决策报表中某个报表块需要定时的刷新等等,都会用到刷新。下面对这些刷新方法进行总结。
1.3 实现思路
对于报表进行刷新的方式较多主要有以下几种:
手动刷新:手动点击浏览器刷新按钮,此方法适用于所有报表,但重新加载速度可能较慢,参数栏参数会初始化,需要重新填写。
使用 location.reload() ,刷新整个报表页面,和手动点击浏览器的刷新功能是一样的,适用于所有报表但重新加载速度较慢,相关示例可参见 填报成功自动刷新 。
使用官方的 JS 接口,具有刷新功能的接口较多,将在第 2 节详细讲解。
决策报表和图表刷新可使用插件,详情请参见 决策报表内报表块刷新插件 。
2. 官方接口刷新总结编辑
接口 | 适用范围 | 示例效果 |
---|---|---|
_g().parameterCommit() | 具有参数栏的所有报表中(包括使用了参数栏隐藏),支持移动端。 | 示例:自动查询 效果:提交参数后重新查询,刷新报表 |
注:此方法可以使用三个参数 gotoPage(pn, para, noCache),跳转到指定页,重新提交参数,有无缓存,使用较灵活 | 适用于分页报表,填报报表,支持移动端。 | 示例:自定义翻页按钮 效果:跳转到指定页数后重新加载刷新,参数栏不刷新 |
_g().getWidgetByName().gotoPage() | 仅适用于决策报表,支持移动端。 | 效果:获取决策报表中的报表块,跳转到指定页 |
_g().refreshAllSheets() | 仅适用于填报报表,支持移动端。 | 示例:S实现当前页刷新 效果:刷新填报报表中所有的 sheet ,刷新后会停留在上次查看的 sheet ,不会刷新参数栏 |
_g().loadSheetByIndex() | 仅适用于填报报表,不支持移动端。 | 效果:切换到指定 sheet 序号的页面并刷新 |
_g().loadSheetByName() | 仅适用于填报报表,不支持移动端。 | 效果:切换到指定 sheet 名称的页面并刷新 |
_g().loadContentPane() | 适用于分页报表,填报报表,数据分析报表、决策报表,支持移动端。 | 效果:重新加载,刷新报表,如果参数栏有参数,会提交参数栏参数 注:在填报报表或数据分析报表中,会刷新所有的 sheet 数据 |