全局API-FR

和 10.0 差別：

新增 servletURL、serverURL、server、fineServletURL、SessionMgr.getSessionID() API

補充 FVS 範本相關API說明

適用於安裝了「FineVis資料視覺化」插件 V1.8.0 及之後版本的使用者

showDialog 新增 padding、titleStyle、backgroundStyle 三個參數欄位，僅支援 FVS V2.0.0 及之後版本

• showDialog 新增 dialogType、line、coordinate 三個參數欄位，僅支援 FVS V2.0.1 及之後版本

• 新增 getCoordinate API，配合 showDialog 使用
  

獲取 fineServletURL，回傳值為字串，格式如：

/webroot/decision

普通報表、決策報表範例：

FR.fineServletURL;

FVS 企業戰情室範本範例：

duchamp.fineServletURL;

title:string

width:number

height:number

innerContent:iframe

padding: style

titleStyle:style

backgroundStyle: style

dialogType:string

line: style

coordinate: array

title：彈出框標題，字串

width：彈出框寬度

• 可填寫具體數值，數值單位為 px 。例如 width: 500

• 可使用百分比表示佔瀏覽器視窗的比例，例如 width:"50%"
  

height：彈出框高度

• 可填寫具體數值，數值單位為 px 。例如 height: 300

• 可使用百分比表示佔瀏覽器視窗的比例，例如 height:"50%"

innerContent：彈出框內容，iframe 標籤，如果要開啟工程下的報表，需先將報表定義為 iframe 標籤

padding：內邊距設定，例如 padding: "10px"

titleStyle：標題樣式設定

backgroundStyle：邊框背景樣式設定

注：titleStyle 和 backgroundStyle 較為靈活，css 能實現的寫法這裏均支援

dialogType：彈出框的形式，預設為置中顯示

• dialogType:"center" 代表彈出框置中顯示

• dialogType:"dynamic" 代表彈出框動態顯示，帶有引導線

line：引導線配置

• type 屬性僅支援 color ，即引導線的顏色

  例如 line: { type: "color", value:{ color: "red" }},

coordinate：引導線開始的座標，基於預覽模式下的座標系，座標為相對螢幕的座標。例如 coordinate: [200, 300]

注：coordinate 可結合 getCoordinate 獲取組件座標API使用，可使得引導線總是在組件位置開啟

string

範例1：開啟一個標題為“銷量彈窗”，寬 700、高 500 ，內邊距為 15px，字體粗體，字號 24px，背景色是綠色，內容為 “Hello World”的彈出框

duchamp.showDialog({
  title: "銷量彈窗",
  width: 700,
  height: 500,
  innerContent: "Hello World",
  padding: "15px",
  titleStyle: { fontSize: "24px", fontWeight: "bold" },
  backgroundStyle: { background:"green" },
  dialogType:"center",
});

範例2：開啟一個標題為“銷量彈窗”，寬 700，高 500 ，彈窗內容為內建範本 GettingStarted.cpt 且置中顯示的彈出框

"use document";
const iframe = document.createElement("iframe");
iframe.width = "100%";
iframe.height = "100%";
iframe.scrolling = "no";
iframe.style="border: none";
iframe.src = "/webroot/decision/view/report?viewlet=GettingStarted.cpt";

duchamp.showDialog(
        {
                title:"銷量彈窗",
                width: 700,
                height: 500,
                innerContent:iframe,
                dialogType:"center",
        }
);

範例3：開啟一個標題為“銷量彈窗”，寬 500，高 500 ，彈窗內容為內建範本 GettingStarted.cpt 的動態顯示彈出框

"use document"
const iframe = document.createElement("iframe");
iframe.width = "100%";
iframe.height = "100%";
iframe.scrolling = "no";
iframe.style="border: none";
iframe.src = "/webroot/decision/view/report?viewlet=GettingStarted.cpt";

duchamp.showDialog({
  title: "銷量彈窗",
  width: 500,
  height: 500,
  innerContent: iframe,
  padding: "15px",
  titleStyle: { fontSize: "24px",color:"white", fontWeight: "bold" },
  backgroundStyle: { background:"green" },
  dialogType:"dynamic",
  line: { type: "color", value: { color: "red" } },
  coordinate: [300, 240],
});

參考上述 範例2 和 範例3 製作範本，效果如下圖所示：

點選下載範本：JS實現點選開啟彈出框.fvs

參數 name 僅用於獲取三維組件模型mesh物件名稱，傳回物件座標。例如：

duchamp.getWidgetByName("三維組件名稱").getCoordinate("模型名稱");

不傳參時，獲取組件中心座標。例如：

duchamp.getWidgetByName("組件名稱").getCoordinate();

範例1：點選標題，獲取標題組件座標，在該座標位置開啟一個帶有引導線的彈出框

const coordinate = duchamp.getWidgetByName("標題1_頁面1").getCoordinate();
duchamp.showDialog({
  title: "銷量彈窗",
  width: 700,
  height: 500,
  innerContent: "Hello World",
  padding: "15px",
  titleStyle: { fontSize: "24px", fontWeight: "bold" },
  backgroundStyle: { background: "green" },
  coordinate:coordinate,
  dialogType: "dynamic",
});

範例2：獲取三維組件「停車場模型」中的「車輛002」模型物件的座標，在該座標位置開啟一個彈出框 注：此方法開啟的彈出框不會跟隨模型縮放或視角變化而行動位置

const coordinate = duchamp.getWidgetByName("停車場模型").getCoordinate("車輛002");
duchamp.showDialog({
  title: "車輛資訊彈出框",
  width: 500,
  height: 300,
  innerContent: "Hello World",
  padding: "15px",
  titleStyle: { fontSize: "24px", fontWeight: "bold" },
  backgroundStyle: { background: "green" },
  coordinate:coordinate,
  dialogType: "dynamic",
});

範例3：獲取三維組件「停車場模型」中的「車輛002」模型物件的座標，在該座標位置開啟一個彈出框 注：此方法開啟的彈出框會跟隨模型縮放或視角變化而行動位置

duchamp.getWidgetByName("停車場模型").showDialogByMesh({
  title: "車輛資訊彈出框",
  width: 500,
  height: 300,
  innerContent: "Hello World",
  padding: "15px",
  titleStyle: { fontSize: "24px", fontWeight: "bold" },
  backgroundStyle: { background:"green" },
  meshName:"車輛002",
});

參考上述 範例2 和 範例3 製作範本，效果如下圖所示：

點選下載範本：JS實現獲取組件座標後開啟彈出框.fvs

url:object

para:object

target:object

feature:object

URL：URL 或 Json 超連結定義，必填

支援的絕對路徑如：

http://192.168.100.1:8080/webroot/decision/view/report?viewlet=GettingStartedTW.cpt

相對路徑如：/webroot/decision/view/report?viewlet=GettingStartedTW.cpt

para：傳遞的參數，選填

target：超連結子頁的開啟位置，選填，預設為 _dialog

• _dialog：對話框
  

• ­_self：當前頁

• 某個 iframe 的 name，當前頁開啟，post 方式提交
  

feature：超連結開啟位置的屬性，選填

開啟內建範本 GettingStarted.cpt，一個為“銷售報表”，傳遞參數“華東”和是否顯示參數面板，開啟方式為對話框，對話框寬 700、高 500：

duchamp.doHyperlinkByGet({
//報表路徑
"url":"/webroot/decision/view/report?viewlet=GettingStartedTW.cpt",
//參數
"para":{
"地區":"華東"
		},
"target":"_dialog",    //對話框方式開啟
"feature":{
"width":700,
"height":500,
"title":"銷售報表"
		}
	})

點選按鈕，開啟標題為“銷售報表”，內容為華東地區銷量情況，寬 700、高 500對話框：

點選下載範本：Get 方法開啟對話框.fvs

URL ：object

config ：object

target ：object

feature ：object

URL：URL 或 Json 超連結定義，必填

支援的絕對路徑如：

http://192.168.100.1:8080/webroot/decision/view/report?viewlet=GettingStartedTW.cpt

相對路徑如：

/webroot/decision/view/report?viewlet=GettingStartedTW.cpt

config：傳遞的參數，選填

target：超連結子頁的開啟位置，選填，預設為 _dialog

• _dialog：對話框
  

• ­_self：當前頁

• 某個 iframe 的 name，當前頁開啟， post 方式提交

feature：超連結開啟位置的屬性，可以不寫

開啟內建範本 GettingStarted.cpt，一個為“銷售報表”，傳遞參數“華東”和是否顯示參數面板，開啟方式為對話框，對話框寬 700、高 500：

duchamp.doHyperlinkByPost({
//報表路徑
"url":"/webroot/decision/view/report?viewlet=GettingStartedTW.cpt",
//參數
"para":{
"地區":"華東"
		},
"target":"_dialog",    //對話框方式開啟
"feature":{
"width":700,
"height":500,
"title":"銷售報表"
		}
	})

點選按鈕，開啟標題為“銷售報表”，內容為華東地區銷量情況，寬 700、高 500對話框：

點選下載範本：Post 方法開啟對話框.fvs

物件

是否為空，布林型

• true ：是

• false：否
  

1）查看「正文框元件」text0 是否存在

普通報表、決策報表（參數面板中的元件）範例：

var a = FR.isEmpty(_g().getParameterContainer().getWidgetByName("text0"));
alert(a);

FVS 企業戰情室範本範例：

var a = duchamp.isEmpty(duchamp.getWidgetByName("text0"));
alert(a);

2）查看「正文框元件」text0 是否為空值

普通報表、決策報表（參數面板中的元件）範例：

var a = FR.isEmpty(_g().getParameterContainer().getWidgetByName("text0").getValue());
alert(a);

FVS 企業戰情室範本範例：

var a = duchamp.isEmpty(duchamp.getWidgetByName("text0").getValue());
alert(a);

物件

是否為空，布林型

• true ：是

• false：否

定義一個陣列，查看其是否為陣列

普通報表、決策報表範例：

var txt = new Array("I","love","FR");
FR.isArray(txt);

FVS 企業戰情室範本範例：

var txt = new Array("I","love","FR");
alert(duchamp.isArray(txt));