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

提示:本文档的示例代码仅适用于本文档中的示例报表/场景。若实际报表/场景与示例代码无法完全适配(如报表使用冻结,或多个宏代码冲突等),需根据实际需求开发代码。

示例说明

我们对电子表格报表进行回写时,经常会遇到如下这些需求。当某个单元格值变化时,要求与之相关的几个单元格自动填入对应值。比如下表中,输入了“产品名称”,要求从数据库中查询该产品的相关信息,填入产品类型、单价等列中。类似上述需求,皆可以参照如下方法进行设置。

参考示例:

版本及客户端说明

1.smartbi版本:最新版本

2.客户端:PC

3.浏览器:IE11、谷歌浏览器(Chrome)、火狐浏览器(Firefox)

设置方法

1、首先在电子表格设计器(Microsoft Office Excel)中,创建电子表格报表。

2、其中回写规则设置如下:

3、被联动出来的单元格设置属性 

4、在浏览器的“分析展现”节点下,选中电子表格,右键选择 编辑宏 进入报表宏界面

5、在报表宏界面新建客户端模块。在弹出的新建模块对话框中,选择对象为spreadSheetReport、事件为onWriteBackCellValueChanged、并把下面宏代码复制到代码编辑区域。

宏类型

类型

对象

事件

ClientSide

spreadsheetReport

onWriteBackCellValueChanged


宏代码

function main(spreadsheetReport, editingCellPosition, oldValue, newValue, newDisplayValue) {
    if (editingCellPosition.column == 2) { //判断当前编辑单元格是不是用户名称所在列,从0开始计数,也就C是列
        var c = spreadsheetReport.getCell(editingCellPosition.row, editingCellPosition.column);
        if (c) {
            var v = c.innerText;
            //var v=newValue;  //若单元格是绑定参数且参数有真实值和显示值之分,可以用此方法获取到参数的真实值(填报属性那里没有勾选"使用显示值"的情况下)
            var sqlValue = getSqlResult(v);
            if (sqlValue) {
                //为D列和E列相应的单元格填入从数据库中查询出的数据
                setWriteBackCellValue(spreadsheetReport, editingCellPosition.row, 3, sqlValue[0].value);
                setWriteBackCellValue(spreadsheetReport, editingCellPosition.row, 4, sqlValue[1].value);
                setWriteBackCellValue(spreadsheetReport, editingCellPosition.row, 5, sqlValue[2].value);
            }
        }
    }
}
/**
 * 执行SQL语句,获取结果集
 */
function getSqlResult(curCellValue) {
    var sql = "select type,price,stock from product where name='" + curCellValue + "'";
    var util = jsloader.resolve("freequery.common.util");
    var ret = util.remoteInvoke("DataSourceService", "getDataByQuerySql", ["DS.writeback", sql, 0, 1000]);
    if (ret.succeeded && ret.result) {
        var data = ret.result.data;
        return data[0];
    }
}
/**
 * 设置回写单元格值
 */
function setWriteBackCellValue(spreadsheetReport, row, column, value, displayValue) {
    var dv = displayValue || value;
    spreadsheetReport.spreadsheetReportWriteBack.setWriteBackCellData(row, column, value, dv);
}

关键对象总结

  • 将数据值插入到指定位置的回写单元格中:setWriteBackCellData(row, column, value, displayValue)。
  • 根据事件参数,获取到当前正在的编辑单元格位置:editingCellPosition: {row, column}。
  • 通过 SQL 语句获取插入值,请参考:宏代码中如何执行SQL语句

资源下载

报表资源:回写单元格一对多联动.xml

SQL表:writeback.sql