HTML5 端的 JS 接口

1）CPT 中才有，FRM 中沒有  

2）Web 事件、單元格超鏈 JS 、填報中單元格控件事件、CPT 的參數界面控件事件，直接通過「contentPane」就可以獲取到對象

獲取 CPT 填報單元格控件： 

contentPane.getWidgetByCell("cell")

1）CPT 中，_g() 就是整個報表對象contentPane，支持contentPane下的所有支持的方法

2）FRM 中，_g() 就是整個表單對象globalForm，支持globalForm下的所有支持的方法

1）CPT／FRM 中參數界面控件事件中可以通過_g().parameterCommit()實現自動查詢

2）CPT 中填報單元格控件事件中可以通過_g().verifyAndWriteReport()及其它填報方法實現提交入庫

3）FRM 中報表塊、圖标塊事件中可以通過_g().options.form獲取表單主體中的對象

4）獲取 FRM 主體控件：

_g().options.form.getWidgetByName("name")

獲取參數面板控件：

parameterEl.getWidgetByName("name")

CPT 和 FRM 中的參數界面都是parameterEl：

1）CPT 中通過contentPane.parameterEl來獲取參數界面，主要應用在 CPT 中 Web 事件的加載起始和結束事件、CPT 單元格 JS 中

2）FRM 中通過_g().parameterEl來獲取參數界面，主要應用在 FRM 的 body 初始化事件、FRM 主體中的控件、FRM 主體報表塊單元格／圖表 JS、圖表塊 JS

CPT 加載結束事件中獲取參數界面控件的值：

var a = contentPane.parameterEl.
getWidgetByName("aa").getValue();
FR.Msg.alert("提示",a)

CPT 參數界面文件控件的編輯結束事件中獲取控件的值： 

var a = this.getValue();
FR.Msg.alert("提示",a)

2）CPT 和 FRM 中的參數界面都是表單，FRM 主體也是表單

2）每個控件的options裏都有當前的表單對象 FORM

因此可以在參數界面或者表單主體的控件的事件中，通過this.options.form來獲取當前的表單對象

獲取CPT/FRM參數面板控件、獲取FRM主體控件：

this.options.form.getWidgetByName("name")

1）contentPane報表對象下面的屬性，當前報表的總頁數 

2）只有分頁的時候該屬性才會有值，通過contentPane.reportTotalPage來進行調用

注：該函數不能在表單、參數界面、Web 事件中使用

在 CPT 單元格超鏈 JS 中獲取當前報表的總頁數：

FR.Msg.alert("提示",contentPane.reportTotalPage());

1）查詢操作，不管是 CPT 還是 FRM ，參數界面上會有内置查詢按鈕，用戶可以不用内置查詢，通過 JS 來觸發查詢操作 

2）通過 contentPane.parameterCommit()  或者_g().parameterCommit()兩種方式觸發，在表單中只能通過 _g().parameterCommit() 方式觸發

1）CPT 參數界面中自定義按鈕先校驗控件，然後根據條件再觸發查詢：

var a = this.options.form.getWidgetByName("a").getValue();
var b = this.options.form.getWidgetByName("b").getValue();
if (a > b) {
    FR.Msg.alert("警告","開始月不能大於結束月！")
} else {
    contentPane.parameterCommit();
    // or _g().parameterCommit();

2）FRM 參數界面中自定義按鈕的點擊事件中觸發查詢：

_g().parameterCommit();

 2）只有分頁的時候該方法才會有用，通過contentPane.gotoFirstPage()來進行調用

注：該函數不能在表單、參數界面、Web 事件中使用

在 CPT 單元格超鏈 JS 中跳轉到第一頁：

contentPane.gotoFirstPage();

 2）只有分頁的時候該方法才會有用，通過contentPane.gotoLastPage()來進行調用

注：該函數不能在表單、參數界面、Web 事件中使用

在 CPT 單元格超鏈 JS中 跳轉到報表的最後一頁：

contentPane.gotoLastPage();

 2）只有分頁的時候該方法才會有用，通過contentPane.gotoPreviousPage()來進行調用

3）如果當前是第一頁，觸發事件應該沒有響應，不能出現頁碼小於等於 0 的情況

注：該函數不能在表單、參數界面、Web 事件中使用

在 CPT 單元格超鏈 JS 中跳轉到當前頁的上一頁：

contentPane.gotoPreviousPage();

 只有分頁的時候該方法才會有用，通過contentPane.gotoNextPage()來進行調用

2）如果當前是最後一頁，觸發事件應該沒有響應，不能出現頁碼大於總頁數的情況

注：該函數不能在表單、參數界面、Web 事件中使用

在 CPT 單元格超鏈 JS 中跳轉到當前頁的上一頁：

contentPane.gotoNextPage();

1）控件的取值方法

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過Widget.getValue()來取控件的值

3）如果控件是下拉框等有顯示值和實際值區分，getValue()取的是實際值

1）CPT 參數界面下拉框的編輯結束事件中獲取當前下拉框的值以及其他控件的值：

var comboBox = this.getValue();
var textEditor = this.options.form.getWidgetByName
("textEditor").getValue();
FR.Msg.alert("提示",comboBox + " - "
+ textEditor)

2）CPT 填報單元格下拉框的編輯結束事件中獲取當前下拉框的值以及其他控件的值：

var comboBox = this.getValue();
var textEditor = contentPane.getWidgetByName
("textEditor").getValue();
FR.Msg.alert("提示",comboBox + " - " 
+ textEditor)

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過Widget.setValue(value)來設置控件的值。

3）如果控件是下拉框等有顯示值和實際值區分，setValue()設置的是實際值

4）參數說明如下所示：

參數：value

參數類型：Object

參數說明：值

CPT 參數界面按鈕點擊事件中給其他控件賦值：

this.options.form.getWidgetByName("textEditor")
.setValue("哈哈")

2）獲取到控件，例如獲取的控件變量爲Widget，可以通過Widget.getText()來取控件的顯示值

3）只有下拉框、下拉複選框、下拉樹、單選按鈕組、複選框組這 5 個控件有顯示值和實際值，這些控件用getValue()獲取到的是實際值，getText()獲取到的是顯示值

4）如果控件是下拉框等有顯示值和實際值區分，getValue()和getText()取的是實際值

CPT 參數界面下拉框的編輯結束事件中獲取當前下拉框的實際值和顯示值：

var shijizhi = this.getValue();
var xianshizhi = this.getText();
FR.Msg.alert("提示","實際值" + shijizhi + " ;
顯示值" + xianshizhi)

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過Widget.reset()來清空控件的數據

CPT 參數界面按鈕點擊後将參數界面上其他控件統一重置：

this.options.form.getWidgetByName("a").reset();
this.options.form.getWidgetByName("b").reset()

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過isVisible()來判斷控件是否可見。可見則返回true，不可見則返回false

CPT 參數界面按鈕點擊後判斷控件是否可見：

var a = this.options.form.
getWidgetByName("a").isVisible();
var b = this.options.form.
getWidgetByName("b").isVisible();
FR.Msg.alert("提示",a + " - " + b)

setEnable(enable)

注：不支持填報單元格使用

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過Widgeti.setEnable(enable)來設置控件是否可用

3）參數說明如下所示：

參數：enable

參數類型：Boolean

參數說明：參數爲 true 可用， false 不可用

CPT 參數界面下拉控件 a 的編輯結束事件中控制控件 b 是否可用，當 a 選擇江蘇的時候，控件 b 可用；當 a 的值爲上海的時候，控件b不可用：

var a = this.getValue();
var b = this.options.form.
getWidgetByName("b");
if(a == "江蘇"){
    b.setEnable(true);
}else if (a == "上海"){
    b.setEnable(false);
}

2）獲取到控件，例如我們獲取的控件變量爲Widget，那麽可以通過isEnabled()來判斷控件是否可用

3）可用則返回 true ，不可用則返回 false

CPT 參數界面按鈕點擊後判斷控件是否可見：

var a = this.options.form.getWidgetByName("a")
.isEnabled();
var b = this.options.form.getWidgetByName("b")
.isEnabled();
FR.Msg.alert("提示",a + " - " + b)

2）獲取到控件，例如獲取的控件變量爲Widget，那麽可以通過fireEvent(eventName)來觸發控件的事件

3）參數說明如下所示：

參數：eventName

參數類型：String

參數說明：要觸發的事件的名字

CPT 參數界面下拉框編輯結束事件中觸發内置查詢按鈕的點擊事件：

this.options.form.getWidgetByName("formSubmit0")
.fireEvent("click")

參數爲單元格名稱

超級鏈接，FR下的工具類方法可通過FR.doHyperlinkByGet(url,config,target,feature)在任何可以寫 JS 的地方進行調用

點擊 CPT 單元格超鏈，打開子模板并傳遞參數：

var url = "/WebReport/ReportServer?reportlet=
WorkBook2.cpt";
var a = "123";
FR.doHyperlinkByGet(url,{a:a, b:"456"}, 
"_self")

必填，url 或 Json 超鏈定義，url 支持

絕對路徑如http://192.168.100.1:8080/WebReport/ReportServer?reportlet=WorkBook2.cpt

相對路徑如/WebReport/ReportServer?reportlet=WorkBook2.cpt 或 ReportServer?reportlet=WorkBook2.cpt 

點擊 CPT 單元格超鏈，打開子模板并傳遞參數： 

var url = "/WebReport/ReportServer?reportlet=WorkBook2.cpt";
var a = "123";
FR.doHyperlinkByPost(url,{a:a, b:"456"},"_self")

絕對路徑如：http://192.168.100.1:8080/WebReport/ReportServer?reportlet=WorkBook2.cpt

相對路徑如： /WebReport/ReportServer?reportlet=WorkBook2.cpt或 ReportServer?reportlet=WorkBook2.cpt 

2）可通過window.parent.FS.tabPane.closeActiveTab()在報表中任何可以用 JS 的地方進行調用

注：不能在參數界面調用

CPT 單元格超鏈 JS 中關閉當前 Tab 選項頁：

window.parent.FS.tabPane.closeActiveTab();

2）可通過FR.logoutApp()在任何可以寫 JS 的地方進行調用

注：不能在參數界面調用

在 CPT 單元格超鏈 JS 中登出：

FR.logoutApp();

2）可通過window.parent.FS.tabPane.addItem(entry)在報表中任何可以用 JS 的地方進行調用

CPT 單元格超鏈 JS 中将超鏈的子報表在決策平台的新 Tab 中打開：

window.parent.FS.tabPane.addItem({title:"子報表",
src:"/WebReport/ReportServer?reportlet=模板1.cpt"})

注：「title」僅支持在 App 中使用，浏覽器中不支持。

1）通過setTabVisible(tabName String, isVisible Boolean)可以實現隐藏部分 Tab 标題

2）參數 1 說明如下所示：

參數1：tabName

參數1類型：String

參數1說明：必填，Tab的控件名稱，如 Tab0

3）參數 2 說明如下圖所示：參數2：isVisible

參數2類型：Boolean

參數2說明：必填，tab 是否可見，ture可見／false隐藏

注：不能在 tablayout 的初始化事件和參數界面中使用

不同用戶可以看到不同的 Tab：

var user = this.options.form.getWidgetByName("user")
.getValue();
if(user=='a'){
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab0", true);
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab1", true);
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab2", true);
}else{
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab0", false);
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab1", true);
    this.options.form.getWidgetByName("tabpane0")
    .setTabVisible("Tab2", false);
}
顯示代碼

showCardByIndex(Number:cardID);

效果：可以實現跳轉到指定 Tab 塊

參數：cardID

說明：必填，顯示的 Tab 序号，從 0 開始

showCardByIndex(Number: cardID, Boolean: animated);

效果：新增 animated 參數，控制切換Tab頁是否有動畫效果，

          僅在移動端标題欄樣式允許橫向滾動切換時生效

參數：animated

說明：非必填，animated 爲 1 開啓動畫，爲 0 關閉動畫

給 body 添加初始化後事件，實現固定時間間隔内自動循環跳轉 Tab：

setInterval(function(){   
    var aa=_g().getWidgetByName("tabpane0")
    .getShowIndex(); 
    if(aa==2){ 
      _g().getWidgetByName('tabpane0')
      .showCardByIndex(0); 
    }
    else { 
      _g().getWidgetByName('tabpane0')
      .showCardByIndex(aa+1); 
    } 
},2000)

注：具體示例可參考 JS 實現點擊查詢後停留在當前查詢的 Tab 頁、JS實現點擊超鏈切換TAB頁

一些請求或者方法返回是 JSON數據，

可以通過json.name來獲取 name 屬性的值

在單元格 JS 中通過FR.Mobile.getDeviceInfo獲取設備信息，并且取出其中的Model 設備型号：

var a = FR.Mobile.getDeviceInfo();
FR.Msg.alert(a.Model)

2）參數說明如下所示：

參數：text

參數類型：Object

參數說明：必填，需要做編碼的字符串

在 CPT 單元格超鏈 JS 中超鏈到中文名字模板：

var url = FR.cjkEncode("/WebReport/ReportServer
?reportlet=模板1.cpt");
var a = "123";
FR.doHyperlinkByGet(url, {a:a, b:"456"}, "_self")

2）參數說明如下所示：

參數：text

參數類型：Object

參數說明：必填，需要做解碼的字符串

在 CPT 單元格超鏈 JS 中先用FR.cjkEncode對中文進行編碼，然後再用FR.cjkDecode進行解碼：

var a = "哈哈";
var b = FR.cjkEncode(a);
var c = FR.cjkDecode(b);
FR.Msg.alert("提示",b + ":" + c)

2）參數說明見 12.1 章節

在 CPT 的單元格超鏈 JS 中發 ajax 請求，且在不同的回調函數中處理不同的情況：

var username = "1";
var password = "1";
FR.ajax({   
   url:"http://env.finedevelop.com:59204/Test
/ReportServer?op=fs_load&cmd=sso",
   data:{
        fr_username:username,
        fr_password:password
   },
   dataType:"jsonp",//跨域采用jsonp方式     
   timeout:5000,//超時時間（單位：毫秒）
   //success:function(data){//data參數視返回值情況而定
        //FR.Msg.alert("success",data.status);
   //},   
   //error:function(errorThrown){   
        //FR.Msg.alert("error",errorThrown);
   //},
   complete: function(res,textStatus){ 
        FR.Msg.alert("complete",textStatus); 
   }  
})
顯示代碼

2）setInterval() 方法會不停地調用函數，直到 clearInterval() 被調用或窗口被關閉。由setInterval()返回的 ID 值可用作clearInterval() 方法的參數

3）通過setInterval(code,millisec)進行調用

4）參數說明詳見本文 12.2 章節

在報表加載結束時間中定義每 3s 刷新一次報表：

setInterval("self.location.reload();",3000);

1）用於在指定的毫秒數後調用函數或計算表達式。

通過setTimeout(code,millisec)進行調用

2）參數說明詳見本文 12.3 章節

注：JS 代碼爲setTimeout(function(){})格式時，「this」需放在聲明外使用

1）在報表加載結束時間中 3s 後彈出提示：

setTimeout("FR.Msg.alert('提示','我是延遲提示')",3000);

2）在報表加載結束時間中 3s 後彈出提示：

setTimeout(function() {
    FR.Msg.alert('提示','我是延遲提示');
}, 3000)

2）如果報表有多頁，刷新後返回第一頁；如果報表有參數界面，刷新後直接顯示上次的參數條件查詢後的結果

在填報成功事件中寫入刷新 JS ，實現填報成功後刷新當前頁：

location.reload();

在填報成功事件中寫入 JS ，實現填報成功後關閉模板返回目錄：

window.close();

返回公式計算的結果

注1：版本爲 10.4.46 之後的 App 支持

注2：使用該接口需要關閉腳本調用公式限制

2 個參數，分别表示：

1）formula：必填，具體公式

2）callback：必填，具體回調方法,可以獲取公式計算後的值

1）使用場景

FR.location 用於實現定位功能，獲取經緯度，可以在https、企業微信、釘釘中使用

2）函數用法

FR.location(function(status, message){...})

3）注意事項

想要在企業微信、釘釘中使用需要将 HTML5 移動端展現插件和微信或釘釘管理插件更新到 10.4.975 版本

在單元格 JS 中獲取當前經緯度：

FR.location(function(status, message){ 
//獲取地理位置 
if(status=="success") { 
    //定位成功，message返回經緯度值 
    FR.Msg.alert("當前位置是" + message);   
} else { 
    //定位失敗，message返回對應的錯誤信息 
    FR.Msg.alert(message); //定位失敗 
} 
})

可以将單元格轉換爲行列号

知道具體的單元格，能夠定位該單元格的行列号

FR.cellStr2ColumnRow('B1') 

返回值爲 {"col":1,"row":0}

值必須是Key/Value格式，可以是字符串如p1=pavalue&p2=p2value，或者是對象如{p1:p1value,p2:p2value}

預期服務器返回的數據類型。如果不指定，将自動根據 HTTP 包 MIME 信息來智能判斷。可用值有：

Json：返回 JSON 數據

text：返回純文本字符串

jsonp": 跨域采用 jsonp 方式

success: function(data, textStatus){  
//data爲服務器返回的，并根據dataType參數
//進行處理後的數據。textStatus爲狀态值success
}

error: function(XMLHttpRequest, textStatus, errorThrown){ 
//參數分别爲XMLHttpRequest 對象、錯誤信息、捕獲的異常對象
//通常textStatus和errorThrown之中只有一個會包含信息
 }

complete: function(XMLHttpRequest, textStatus){  
//參數分别爲XMLHttpRequest
//對象和一個描述成功請求是否成功的字符串
 }

可以通過FR.Msg.alert(Object title, Object message[, Object callback])在任何可以寫 JS 的地方進行調用

2）參數說明詳見本文 13.1 章節

1）點擊填報單元格按鈕後彈出提示：

FR.Msg.alert("提示","我是第一個提示");

2）點擊填報單元格按鈕後彈出提示，且 2s 後自動關閉：

FR.Msg.alert("提示","我是第二個提示",2000);

3）點擊填報單元格按鈕後彈出提示，點擊提示框的确定按鈕，觸發回調事件并提示：

FR.Msg.alert("提示","我是第三個提示",function(value){
    FR.Msg.alert("提示",value);
});

2）參數說明如下所示：

參數：message

參數類型：Object

參數說明：要顯示的消息

點擊填報單元格按鈕後彈出懸浮提示：

FR.Msg.toast("提示","我是第一個懸浮提示");

可通過FR.Msg.confirm(Object title, Object message[,Object callback, Object min_width ])在任何可以寫 JS 的地方進行調用

2）參數說明見本文 13.2 章節

1）點擊填報單元格按鈕後彈出确認框：

FR.Msg.confirm("提示","我是第一個确認");

2）點擊填報單元格按鈕後彈出彈出确認框，且在點擊确定和取消按鈕的時候，彈出不同的回調提示：

FR.Msg.confirm("提示","我是第二個确認",function(value){
    FR.Msg.alert("提示",value);
});

可以通過FR.Msg.confirm(Object title, Object message, Object value, Object callback, Object min_width)在任何可以寫js的地方進行調用

2）參數說明詳見 本文 13.3 章節

1）點擊填報單元格按鈕後彈出輸入框：

FR.Msg.prompt("提示","我是第一個輸入框");

FR.Msg.prompt("提示","我是第二個輸入",
null,function(value){
    FR.Msg.alert("提示",value);
});