Web报表工具FineReport的JS API开发(二).pdfVIP

Web 报表工具FineReport 的JS API 开发（二） 上次介绍FineReport 的JS API 中的第一类开发--FR，这次就来介绍一下FS 和contentWindow 类的开发。 1 FS FS 是数据决策系统中的js 接口，比如说FS.tabPane.addItem，先介绍几类操作: 1.1 FS.Trans.signOut() 退出决策平台系统 1.2 FS.tabPane._doCloseTab(FS.tabPane._getSelectedTab()) 关闭当前决策平台的标签 1.3 FS.tabPane.addItem({title:baidu,src:}) 在决策平台中打开新标签页 1.4 示例 前面两个接口很简单，这里不再举例说明，下面详细介绍一下第三个接口，即在数据决策系 统中打开一个新tab 。 1.4.1 描述 数据钻取是使用超级链接实现，打开方式有三种，当前窗口，对话框，新窗口。前面2 种方 式很好理解，第三种在新窗口中打开，即在浏览器端打开一个新的tab 页面，如果是在数据 决策系统中使用，希望实现在决策系统框架下新增一个tab 页签，而不是在浏览器端重新打 开一个窗口，这个该怎么实现呢？ 1.4.2 模板 下面以%FR_HOME%\demo\basic\ DetailedDrillA.cpt 为例，该模板中实现了在当前窗口的钻取 功能，下面将在当前窗口打开换成在新的tab 页面中打开。 1.4.3 超级链接 打开模板，进入A4 单元格的超级链接设置界面，如下图： 将订单明细的钻取修改成在数据决策中打开一个新的tab 页面，新tab 页面的标题为订单明 细。 新增一个JavaScript 的超级链接，添加参数ID，参数值为当前单元格的值，即ID=$$$，如下 图： 通过 window.parent.FS.tabPane.addItem({title:baidu,src:}) 实现在新 的tab 中打开页面。 title ：订单明细 src ：订单明细模板的路径 具体如下图： 这里要注意，src 最后的符号为参数的传递，即将当前单元格的值传递给参数 ID，然后再 src 的路径后面拼接字符串，将ID 参数的值传递给需要打开的新模板中的订单号参数。 代码如下： window.parent.FS.tabPane.addItem({title: 订 单 明 细 ,src:${servletURL}?reportlet=demo/basic/DetailedDrillB.cpt订单号=+ID}) 1.4.4 效果查看 2 contentWindow 2.1 介绍： contentWindow 是在web 页面集成的时候，将FineReport 报表嵌入在 iframe 中，调用报表 对象时使用的接口，比如说：document.getElementById(reportFrame).contentWindow ，其中 document.getElementById(reportFrame)是获取iframe 对象，contentWindow 是报表对象，相 当于html 中的window 对象。 在普通模板的JS 脚本中可以直接使用contentWindow 下的属性，如直接使用contentWindow 中的contentPane ，而不用写contentWindow ，这是因为js 脚本本身就在FR 模板中执行。 网页中使用iframe 嵌入报表，如果文档包含框架（frame 或iframe 标签），框架中嵌入了FR 报表，则会创建一个contentWindow 对象先获取iframe，再调用contentWindow ，然后使用 contentWindow 下面的属性: var contentWindow = document.getElementById(reportFrame).contentWindow.XXX; 不论是web 页面集成里面还是直接在FR 模板之中，contentWindow 下面最常用的属性当属 contentPane ，所以下面将详细介绍contentPane 。 contentPane 是contentWidow 下面的最常用的一个属性，为存放报表内容的容器。 2. 2 引用contentPane 在普通模板的JS 脚本中直接使用contentPane 就能获取到该对象。 如果报表嵌在网页的 iframe 中，首先在 iframe 中获