wuxiren123

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%\demo\basic\DetailedDrillA.cpt为例,该模板中实现了在当前窗口的钻取功能,下面将在当前窗口打开换成在新的tab页面中打开。

1.4.3 超级链接

 

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


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

 

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




通过

window.parent.FS.tabPane.addItem({title:"baidu",src:"http://www.baidu.com"})  

 实现在新的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中获取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这个控件:

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)

获取指定名字的控件

posted on 2016-03-23 15:00 喝水居然长肉 阅读(223) 评论(0)  编辑  收藏


只有注册用户登录后才能发表评论。


网站导航: