Web报表工具FineReport的JS API开发（一）

最新推荐文章于 2025-08-06 15:00:21 发布

nayun123

最新推荐文章于 2025-08-06 15:00:21 发布

阅读量2.9k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： js接口文章标签： Web JavaScript API 开发报表 ViewUI

本文链接：https://blog.youkuaiyun.com/nayun123/article/details/84771018

本文详细介绍了Web报表工具FineReport的JS API中的FR对象，包括FR.Msg的各种方法如alert、confirm、prompt和toast，以及FR.ajax的使用，帮助开发者更好地实现报表的交互与数据通信。

很多报表软件可以利用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

大家知道，预览报表时，报表servlet会将cpt模板转为html，在这个html的head头部中会引入FR的js，如下：

<script type="text/javascript" src="/WebReport/ReportServer?op=emb&resource=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=emb&resource=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方法，这里列了一张表