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=$$$，以下圖：

經過
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下面的最經常使用的一個屬性，爲存放報表內容的容器。

1. 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_widgetsform中的全部控件集合getValueByName(name)獲取指定名字控件的值getWidgetByName(name)獲取指定名字的控件