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:"http://www.baidu.com"})
在决策平台中打开新标签页
1.4示例
前面两个接口很简单，这里不再举例说明，下面详细介绍一下第三个接口，即在数据决策系统中打开一个新tab。
1.4.1 描述
数据钻取是使用超级链接实现，打开方式有三种，当前窗口，对话框，新窗口。前面2种方式很好理解，第三种在新窗口中打开，即在浏览器端打开一个新的tab页面，如果是在数据决策系统中使用，希望实现在决策系统框架下新增一个tab页签，而不是在浏览器端重新打开一个窗口，这个该怎么实现呢？
1.4.2 模板
下面以%FR_HOME%demoasicDetailedDrillA.cpt为例，该模板中实现了在当前窗口的钻取功能，下面将在当前窗口打开换成在新的tab页面中打开。
1.4.3 超级链接

打开模板，进入A4单元格的超级链接设置界面，如下图：

将订单明细的钻取修改成在数据决策中打开一个新的tab页面，新tab页面的标题为订单明细。

新增一个JavaScript的超级链接，添加参数ID，参数值为当前单元格的值，即ID=$$$，如下图：

通过
Js代码
window.parent.FS.tabPane.addItem({title:"baidu",src:"http://www.baidu.com"})
实现在新的tab中打开页面。
title：订单明细
src：订单明细模板的路径

具体如下图：

这里要注意，src最后的&符号为参数的传递，即将当前单元格的值传递给参数ID，然后再src的路径后面拼接字符串，将ID参数的值传递给需要打开的新模板中的订单号参数。
代码如下：
Js代码
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引用contentPane
在普通模板的JS脚本中直接使用contentPane就能获取到该对象。

如果报表嵌在网页的iframe中，首先在iframe中获取contentWindow，然后获取属性contentPane对象，如下：

var contentPane = document.getElementById("reportFrame").contentWindow.contentPane;  

比如，需要在网页中获取报表填报页面的一个按钮，并执行点击事件：

document.getElementById("reportFrame").contentWindow.contentPane.getWidgetByName("控件名").fireEvent("click") 

2.2.1 contentPane常用属性
parameterEl
返回对象参数界面
curLGP
返回curLGP对象，只有填报预览及表单预览下才有
currentPageIndex
当前所在页，只有分页预览才有
reportTotalPage
总页数，只有分页预览报表才有
zoom
缩放比例
2.2.2 contentPane常用方法
方法
说明
appendReportRC(num)
在选中行后面插入num行，只有填报表才可以用
deleteReportRC()
删除指定行，只有填报表才可以用
deleteRows(param)
批量删除param所在记录，param为一窜单元格坐标的字符串数组
emailReport()
邮件发送
exportReportToExcel("指定格式")
参数为page时分页导出；simple原样导出；sheet分页分sheet导出
exportReportToImage()
输出图片
exportReportToPDF()
输出pdf
exportReportToWord()
输出word
fireEvent()
触发事件
appletPrint()
applet打印
flashPrint()
flash打印
getWidgetByName()
获取填报页面的控件
getCellValue(cell)/getCellValue(col,row)
获取单元格值，只有填报下有
gotoFirstPage()
跳转到第一页，只有分页预览报表有
gotoLastPage()
跳转到最后一页，只有分页预览报表有
gotoPreviousPage()
跳转到上一页，只有分页预览报表有
gotoNextPage()
跳转到下一页，只有分页预览报表有
gotoPage(num)
跳转到指定num页，只有分页预览报表有
importExcelData()
在线导入excel，只有填报表才可以用
on()
监听
pdfPrint()
pdf打印
printPreview()
打印预览，只有数据分析时才有
pageSetup()
页面设置，只有数据分析才有
scale(str)
缩放，str为"+"时放大，为"-"时缩小
setCellValue(cell,null,value)/setCellValue(col,row,value)
给单元格赋值，只有填报表才有
verifyReport()
数据校验，只有填报表才可以用
writeReport()
校验并提交报表，只有填报表才可以用

FineReport的填报预览及表单预览下contentPane下都会有一个curLGP对象，即current logicpane。
2.3 引用curLGP
在cpt模板的JS脚本中可以使用contentPane.curLGP来获取该对象。
如果报表嵌在网页的iframe中，在iframe外获取curLGP对象如下：

var contentPane = document.getElementById("reportFrame").contentWindow.contentPane.curLGP;

2.3.1 curLGP常用属性：
属性
说明
currentTDCell
填报预览，当前焦点所在单元格
dirtyCell
填报预览，编辑过的单元格
write
填报预览，返回write对象
form
表单预览或参数界面，返回form对象

2.3.2 curLGP常用方法
方法
说明
getCellValue(cell)/getCellValue(col, row)
获取指定格子的值，只有填报下有
setCellValue(cell, null, value)/setCellValue(col, row, value)
设置指定格子的值，只有填报下有

2.4 write
填报预览时，curLGP下有一个write对象。
2.4.1 引用write
在cpt模板的JS脚本中可以使用contentPane.curLGP.write来获取该对象。
如果报表嵌在网页的iframe中，在iframe外获取write对象如下：

var contentPane = document.getElementByID("reportFrame").contentWindow.contentPane.curLGP.write; 

2.4.2 write常用方法
方法
说明
getWidgetByCell(cell)
获取指定单元格中的控件
getWidgetByName(name)
获取指定名字的控件
getWidgetsByName(name)
获取指定名称的扩展控件，返回一个数组

2.5 form
表单预览或参数界面，都有一个form对象。
2.5.1引用form
在cpt模板的JS脚本中可以使用this.options.form来获取该对象，如获取参数界面下拉框p1这个控件：
Js代码
var widget=this.options.form.getWidgetByName(p1)
如果报表嵌在网页的iframe中，在iframe外获取form对象如下：

var contentPane = document.getElementByID("reportFrame").contentWindow.contentPane.curLGP.form; 

2.5.2 form常用属性及方法：
属性或方法
说明
name_widgets
form中的所有控件集合
getValueByName(name)
获取指定名字控件的值
getWidgetByName(name)
获取指定名字的控件