全局API-FR

和 10.0 区别：

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

补充 FVS 模板相关接口说明

适用于安装了「FineVis数据可视化」插件 V1.8.0 及之后版本的用户

showDialog 新增 padding、titleStyle、backgroundStyle 三个参数字段，仅支持 FVS V2.0.0 及之后版本

• showDialog 新增 dialogType、line、coordinate 三个参数字段，仅支持 FVS V2.0.1 及之后版本

• 新增 getCoordinate 接口，配合 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 获取组件坐标接口使用，可使得引导线总是在组件位置打开

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));