模板设置

作用域配置

全局作用域指的是在报表的执行过程中可以访问的作用域,可以在工具栏上进行配置,可配置的变量类型包括:「string」「number」「boolean」「object」「array」,配置完变量后会注入到数据源入参、单元格表达式、单元格公式这三个场景中,我们可以在这三个场景中访问到全局作用域中的变量。

类型 典型用途 默认值示例
string 姓名、编码、日期字符串 ""、"A001"
number 数量、页码、金额 0、10
boolean 开关条件 true、false
object 一组有名称的属性 { "id": 1 }
array 多选值、文件列表、普通数组 []、["A", "B"]
list/schema 动态增加控件行的结构化数组 按 Schema 定义子字段

变量名称应保持唯一。检索控件、数据集入参和单元格控件需要共享值时,必须绑定同一个作用域变量;仅仅使用相同的显示名称不会建立关联。

验证方法:给变量设置容易识别的临时默认值,在数据集预览或报表预览中确认能被正确读取,再替换为正式默认值。

作用域配置支持表格配置和JSON配置,可互相切换

数据源入参

在数据源入参右侧选择“注入”,并选中需要绑定的全局作用域变量。绑定后,入参类型由作用域变量决定;修改作用域值后重新查询,数据源会读取新值。

单元格表达式

在条件属性配置面板的编辑器中,注入了当前报表全局作用域中的变量,这些作用域上的变量可以参与表达式的计算。如下图所示,该表达式做了一个字符串的拼接,将全局作用域中的title变量跟单元格的值做拼接,在报表预览时会执行该表达式,并获得最终拼接后的值展示在页面上。