示例说明
我们对电子表格报表进行回写时，经常会遇到如下这些需求。当某个单元格值变化时，要求与之相关的几个单元格自动填入对应值。比如下表中，输入了“产品名称”，要求从数据库中查询该产品的相关信息，填入产品类型、单价等列中。类似上述需求，皆可以参照如下方法进行设置。
参考示例：
版本及客户端说明
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 + "'"; //此处sql需要根据实际场景修改
var util = jsloader.resolve("freequery.common.util");
var ret = util.remoteInvoke("DataSourceService", "getDataByQuerySql", ["DS.writeback", sql, 0, 1000]); //此处数据源id(DS.writeback)需要根据实际场景修改
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,'真实值','显示值',"PARAM_DISPLAY");
}
关键对象总结
- 将数据值插入到指定位置的回写单元格中：setWriteBackCellData(row, column, value, displayValue)。
- 根据事件参数，获取到当前正在的编辑单元格位置：editingCellPosition: {row, column}。
- 通过 SQL 语句获取插入值，请参考：宏代码中如何执行SQL语句。
资源下载
报表资源：回写单元格一对多联动.xml
SQL表：writeback.sql
