页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 20 下一个 »

脚本查询是数据模型的数据的来源之一。它支持用户编写JavaScript代码,将任意一个含有数据的资源通过解析后获取自定义数据结构的数据。相比其他私有查询,它更自由,无需依赖系统连接的关系数据源,能够从一些特殊的资源中获取到数据,比如文本文件和非结构化的数据。

目前“脚本查询”支持的语言只有JavaScript,因此适用于熟悉JavaScript的技术人员。相关接口文档可参考IJavaQueryData

1. 操作入口

单击“数据模型”定制界面下方的“私有查询分页区”的“+”号,选择 脚本查询(如下图所示),进入脚本查询的定制界面。


2. 界面介绍

脚本查询定制界面如下图所示:

“脚本查询”界面主要分为以下几个区域:

  • 功能按钮区:列出了可操作脚本查询的工具按钮;
  • 脚本编辑区:编辑脚本代码;
  • 参数设置/预览数据区:设置脚本的参数,查看输出的数据;

2.1 功能按钮区

功能按钮区的按钮具体说明如下表:

按钮名称图标说明
执行

执行脚本。若脚本的结果集中包含参数且未设置默认值,则会提示用户输入参数默认值。
保存

将当前脚本查询保存到“数据模型”定制界面的表关系区内,如果是第一次创建,则会在表关系区创建对应的节点,节点名称默认为“脚本查询”。
格式化脚本

对脚本编辑区内的代码进行格式化操作,使其符合代码规范

校验

  • 校验脚本编辑区中的代码,如果有语法错误则提示具体的错误

  • 如果正确则提示校验成功。

示例

在脚本编辑区生成内置的JavaScript示例代码
回到数据集

返回到数据模型主页面


2.2 脚本编辑区

用户可在此区域进行脚本代码的编写

  • 在方法init()内可以自定义结果集,自定义私有参数和输出字段。私有参数,用于过滤数据。

  • 代码编辑完成后,鼠标点击编辑区域以外的区域,则会校验脚本语法,并识别所编写脚本的结果集中的参数,在“参数设置”区域生成对应的参数。

2.3 参数设置/数据预览区

用于显示执行脚本查询后的数据结果,主要分为参数设置界面数据预览区

(1)参数设置界面

  • 若在脚本代码的结果集中定义了参数,点击按钮“参数设置”切换至“参数设置”页面,“参数设置”页面会显示对应的参数。参数的默认值一般为空,可在“默认值”的输入框中设置参数的默认值;

(2)数据预览区

点击“数据预览”按钮可切换至数据预览区,查看输出数据;

数据预览前需在“参数设置”页面设置默认值后,点击功能按钮区中的“执行”按钮,数据预览页面才会输出相关数据。

(3)展开或收缩 数据结果展示区

  • 点击符号“”可将该区域展开,点击符号“”可将开区域收起。

3. 示例

本示例以数据源“northwind”中的"产品表”为目标资源,展示了如何通过编写JavaScript脚本获取指定节点ID的数据源表数据,具体操作如下:

3.1 获取资源节点ID

  • 左侧 “系统导航栏”中的“数据连接” ,选择  “数据连接” > “northwind” > “产品表” ,右键打开扩展菜单,点击“属性”。

  • 记录下该资源的节点ID

3.2 新建“脚本查询”节点

  • 点击“数据模型”界面下方的TAB页签中的符号“+”,选择“脚本查询”;

3.3 编写脚本

  • 复制代码到“脚本编辑区,并修改目标资源的节点id。

示例代码·读取指定节点资源的表数据
importPackage(Packages.smartbi.freequery.client.datasource);

var datasourceService = DataSourceService.getInstance();
var tableId = "TAB.northwind.null.products";   //目标资源的节点ID
var table = datasourceService.getTable(tableId);
var sql = "select";
var data;

function init() {
    var fieldList = table.getFields();
    var fields = [];
    for (var i = 0; i < fieldList.size(); i++) {
        var field = fieldList.get(i);
        sql = sql + " " + field.getName();
        fields[i] = {
            id: field.getId(), //字段ID
            name: field.getName(), //字段名称
            alias: field.getAlias(), //字段别名
            desc: field.getDesc(), //字段描述
            valueType: parseValueType(field.getDataType().getSQLType()) //字段数据类型:INTEGER | DOUBLE | LONG | STRING | DATETIME
        }
        if (i < fieldList.size() - 1) {
            sql = sql + ",";
        }
    }
    sql = sql + " from " + table.getName();
    return {
		// //参数列表
		// params: [{
			// id: 'Param.northwind.null.products', //参数ID
			// name: 'ParamName', //参数名称
			// alias: 'ParamAlias', //参数别名
			// desc: 'ParamDesc', //参数描述
			// nullable: true, //参数是否允许是空
			// valueType: 'STRING' //参数数据类型:INTEGER | DOUBLE | LONG | STRING | DATETIME
		// }],
		//输出字段
        fields: fields
    };
}

function getGridData(paramValues, from, count) {
    data = datasourceService.executeNoCacheable(table.getDataSource().getId(), sql);
    return data;
}


function getRowCount() {
    return data.getRowsCount();
}


/**
  关闭查询对象
*/
function close() {}

function parseValueType(type) {
    switch ("" + type) {
        case "LONG":
            return "LONG";
        case "BIGINT":
        case "INTEGER":
            return "INTEGER";
        case "BIGDECIMAL":
        case "DOUBLE":
            return "DOUBLE";
        case "TIME":
        case "DATE":
        case "DATETIME":
            return "DATETIME";
        default:
            return "STRING";
    }
}

3.4 校验语法

  • 点击功能按钮区内的“校验脚本”,校验脚本语法。

3.5 执行脚本

  • 点击功能按钮区内的“执行”按钮,执行脚本。执行完毕后,数据预览区便会显示输出的数据。

3.6 保存节点到数据模型页面

  • 点击功能按钮区内的“保存”按钮,则当前脚本查询会以表的输出节点方式保存在数据模型的”表关系区“中。

  • 无标签