FR.ajax

報表伺服器版本	功能變動
11.0.7	補充 FVS 視覺化看板相關API說明 適用於安裝了「FineVis資料視覺化」插件 V1.8.0 及之後版本的使用者
11.0	-

ajax 是一種與伺服器交換資料的技術，可以在不重新載入整個頁面的情況下更新網頁的一部分。

FR.ajax 是封裝過的 jQuery.ajax() 函式，在報表中對特定網頁進行 ajax 請求， data 參數做了中日韓文編碼處理。

options 是 ajax 參數，如下表說明：

［options］以 json 格式提供，屬性如下表所示：

success: function(data, textStatus){  
 // data 為伺服器傳回的，並根據 dataType 參數進行處理後的資料。
//textStatus 為狀態值 success
}

FR.ajax({
	url: "/webapps/webroot/a.html",
	success: function(data, textStatus) {
		alert(this.url);
	}
});

error: function(XMLHttpRequest, textStatus, errorThrown){ 
//參數分別為 XMLHttpRequest 物件、錯誤資訊、擷取的異常物件。
//通常 textStatus 和errorThrown 之中只有一個會包含資訊
 }

FR.ajax({
	url: "some.jsp",
	error: function(XMLHttpRequest, textStatus, errorThrown) {
		alert(this.url);
	}
});

complete: function(XMLHttpRequest, textStatus){  
//參數分別為 XMLHttpRequest 物件和一個描述成功請求是否成功的字串
 }

FR.ajax({
	url: "some.jsp",
	complete: function(XMLHttpRequest, textStatus) {
		alert(this.url);
	}
});

在 cpt 的儲存格超連結 JavaScript 腳本中發 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); 
   }  
})
隱藏程式碼

某些應用場景下，如果只允許在登入狀態下執行一些操作，不登入就不能執行，要先判斷當前的登入狀態。如下圖所示：

就可以透過 FR.ajax 在不重新整理頁面的情況下，請求登入狀態並傳回，如下實現方式。

1）建立範本，新增一個按鈕，按鈕名稱修改為「查看登入狀態」。如下圖所示：

2）點選按鈕，為按鈕新增一個「點選」事件，事件內容為在不重新整理頁面的情況下，請求登入狀態並傳回。如下圖所示：

JavaScript 程式碼如下：

FR.ajax({
url: "/webroot/decision/login/info",
async: true,
complete: function (res, status) {
if (status == 'success') {
var u = FR.jsonDecode(res.responseText);
if (u != null && u.data) {
FR.Msg.alert("通知","登入狀態");
//u.data.ip u.data.time u.data.city 分別可傳回上次登入ip、時間、城市
}else{
FR.Msg.alert("通知","登出狀態");
}
}
}});

3）儲存範本，點選「分頁預覽」，效果如應用場景中所示。

點選可下載範本：實時獲取登入狀態.cpt

注：需安裝「FineVis資料視覺化」插件 V1.8.0 及之後的版本。

FVS 視覺化看板中給 標題組件 新增一個「JavaScript」互動點選事件，步驟如下圖所示：

JavaScript 程式碼如下：

注：FVS 中使用程式碼時需注意將 FR.xxx 換成 duchamp.xxx ，且參數格式均為 json 格式。

duchamp.ajax({
  url: "/webroot/decision/login/info",
  async: true,
  complete: function (res, status) {
     if (status == 'success') {
       var u = duchamp.jsonDecode(res.responseText);
       if (u != null && u.data) {
         duchamp.Msg.alert({
         title: "通知",
         message: "登入狀態",
         });
//u.data.ip u.data.time u.data.city 分別可傳回上次登入ip、時間、城市
         } else {
          duchamp.Msg.alert({
          title: "通知",
          message: "登出狀態",
          });
          }
     }
  }
});

預覽效果如下圖所示：

點選下載範本：JS實現查看平台登入狀態.fvs