Web报表工具FineReport的JS API（一）.pdfVIP

Web 报表工具FineReport 的JS API 开发 （一） 很多报表软件可以利用JS 接口来实现更多更复杂的功能。以FineReport 为例，开放了大量 的JS API 给用户，根据执行JS 的主体不同可以将分为三大类：FR、FS 和contentWindow 。 在js 语句中执行可以使用FR 的方法或者属性，比如说FR.Msg.alert，FR 中的方法比如引入 finereport.js 。FS 的方法可以用于数据决策系统中的js 接口，比如说FS.tabPane.addItem。而 contentWindow 是在web 页面集成的时候，将F 报表嵌入在 iframe 中，调用报表对象时使 用的接口，比如说：document.getElementById(reportFrame).contentWindow ，其中 document.getElementById(reportFrame)是获取iframe 对象，contentWindow 是报表对象，相 当于html 中的window 对象。 由于篇幅，这里先介绍FR FR 大家知道，预览报表时，报表servlet 会将cpt 模板转为 html，在这个html 的head 头部中 会引入FR 的js ，如下： script type=text/javascript src=/WebReport/ReportServer?op=embresource=finereport.js/script 这个finereport.js 中包含了许多内置的function 以及一些公有的属性，不管在模板中还是其 他网页中，只要引入了finereport.js ，就能够通过FR.xxx 的形式调用公有的属性与方法 比如，在模板中使用，访问模板时会自动引入finereport.js ，因此在模板的js 脚本中可以直 接使用FR.xxx 来调用方法，如下图： 或者需要在自己的网页如某个jsp 页面中调用FR 的方法，要先引入finereport.js ，再通过 FR.xxx 来调用，如下： html head script type=text/javascript src=/WebReport/ReportServer?op=embresource=finereport.js/script script type=text/javascript var url = FR.cjkEncode(/WebReport/ReportServer?reportlet=Gettingstarted.cpt地区=华 东); window.open(url); /script /head body /body /html 对于常用的FR 方法，这里列了一张表 方法 返回值 说明 ajax void ajax 请求 对 cjkEncode 过的字符串进行反 cjkDecode(cjkEncode String) String 编码 cjkEncode(String) String 对字符串进行 cjkEncode 编码 closeDialog() void 关闭对话框 超级链接，get 传递 config 参数 doHyperlinkByGet(url,config,target,feature) void 到 target 中，并在feature 里面 设置窗口属性 超级链接，post 传递 config 参 doHyperlinkByPost(url,config,target,feature) void 数，