1. 概述
1.1 版本
报表服务器版本 | 功能变更 |
---|---|
11.0 | - |
11.0.10 | 单元格值获取接口 getCellValue() 变更为 getValue() 原接口仍可以使用,推荐升级使用新接口 |
1.2 预期效果
有时我们也需要获取分页预览的报表中的某些单元格的类型和值,如下图所示:
1.3 实现思路
通过添加「加载结束」事件,利用 JS 代码获取到单元格中的值。
11.0.10 之前版本单元格值 JS 接口可参考:获取和设置单元格值接口,此接口只能获取单元格的值。
11.0.10 及之后版本单元格值 JS 接口可参考:单元格对象接口
注1:暂不支持与「重复与冻结」同时使用。
注2:移动端只返回值,不返回类型。
2. 示例
2.1 准备模板
打开模板:%FR_HOME%\webroot\WEB-INF\reportlets\demo\NewbieGuide\行式报表.cpt
2.2 添加事件
打开模板,点击「模板>模板 Web 属性>分页预览设置」,选择「为该模板单独设置」,添加一个「加载结束」事件。如下图所示:
JavaScript 代码如下:
var a = _g().getCell(1,1).getValue();
FR.Msg.alert("提示","A1单元格的值是"+a);
2.3 效果预览
2.3.1 PC端
保存模板,点击「分页预览」,效果如 1.2 节所示。
2.3.2 移动端
App 与 HTML5 端效果相同,如下图所示:
注1:H5插件需要更新至 11.0.7 及之后版本。
注2:不支持填报预览。如需填报,可参考文档第四章使用其他接口达成。
注3:移动端只返回值,不返回类型。
3. 模板下载
已完成模板可参考:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\JS\分页预览JS实例\JS获取分页预览下单元格的值.cpt
点击下载模板:JS获取分页预览下单元格的值.cpt
4. 示例拓展
若需要获取单元格值同时修改单元格的值,可以使用 setCellValue() 接口,例如获取A1单元格的值,同时将其修改为:订单号,如下图所示:
注:移动端仅在普通报表「填报预览」下支持。
JavaScript 代码如下:
_g().setCellValue(1,1,"订单号");
FR.Msg.alert("提示", "A1单元格的值修改为订单号");