【基础教程】BI自助分析工具-事件库

[liujf]

一、代码编辑

一个操作器可以有多个版本，不同的版本对应不同的脚本。

1. 脚本格式

function fun(params) {
    return {
        /**
         * 返回操作器的描述信息。
         * @param {object} params 参数
         * @param {object} vbi vbi对象
         * @returns {string}
         */
        format: function(params, { vbi }) {
            return "操作器的描述信息"
        },
        /**
         * 操作器实际执行的函数
         * @param {object} params 参数                 
         */
        execute: function(params) {
            console.log("执行操作器，参数：", params);
        }
    }
}

2. 参数格式

{
    "p1":{
        "type":"text",
        "value":"1"
    }
}

p1：参数名称
type：参数类型
value：参数值

当类型为radio或select时，可以设置参数的options属性，如下所示：

{
  "p1": {
    "type": "radio",
    "value": "1",
    "options": [
      {
        "label": "真",
        "value": "1"
      },
      {
        "label": "假",
        "value": "0"
      }
    ]
  }
}

参数类型(type)说明，目前仅支持如下类型：

• text 输入框
• radio 单选框
• select 下拉框
• componentSelect 页面组件下拉框
• methodSelect 组件方法下拉框
• propertySelect 组件属性下拉框
• parameterSelect 画面参数下拉框
• systemVarSelect 系统变量下拉框
• multiParameterSelect 画面参数多选下拉框

二、版本管理

可以设置一个版本为默认版本，在绑定事件操作器的时候，会使用默认版本的操作器。

三、使用上一个事件操作器的执行结果

这里的args参数就是上一次事件操作器的执行结果。

示例：
我们在BI分析页面上使用【版本3的这个执行组件动作操作器】

1. 我们现在页面上托3个按钮：第一个按钮有个setValue方法，第二个按钮有个getValue方法。

方法很简单，如下所示：

// 按钮1的setValue方法
function setValue() {
  return '123';
}

//按钮2的getValue方法
function getValue(val) {
  console.log('获取到的值：', val);
}

2. 按钮3添加两个执行组件动作操作器，注意这里操作器版本，选版本3。第一个操作器调用按钮1的setValue方法，第二个操作器调用按钮2的getValue方法。

3. 打开控制台看输出日志。