参数介绍

1.概述

1.1 支持版本
报表设计器版本
since 7.8.0
1.2 功能介绍

参数是一个变量,通过定义参数,并且在运行时赋值给参数不同的值,来达到动态过滤数据的目的,使报表设计更灵活。参数应用场景如下:

根据参数的作用域不同,VeryReport支持的参数分为全局参数、模版参数、数据集参数。

2.参数分类

2.1 全局参数

全局参数,作用域为全部模版,即为定义一个全局参数,所有模版都可以使用。

2.1.1 功能入口

依此点击菜单「工作台」、「全局参数」,点击「新增」,则为添加全局参数界面。

2.2 模版参数

模版参数,作用域仅适用于当前模版,即为定义一个模版参数,只有当前模版可以使用。

2.2.1 功能入口

在报表设计器中,依此点击上侧菜单「设置」、「模版参数」,点击「添加」,则为添加模版参数界面,如下图所示:

模版参数新增页面
2.3 数据集参数

数据集参数,作用域仅适用于当前数据集,即为定义一个数据集,只有当前数据集可以使用。由于数据集分为全局数据集和模版数据集,当全局数据集参数和模版数据集参数为同一个名称时,则系统会默认使用模版数据集参数。

2.3.1 功能入口

在报表设计器中,这里以数据库查询数据集为例,依此点击左侧数据集区域「+」、「数据库查询」,即可定义数据集参数,如下图所示:

数据集参数新增页面

3.参数优先级

3.1 参数优先级

当在不同作用域定义相同名字的参数时,根据优先级不同,默认会使用优先级高的参数。不同作用域参数优先级为:

数据集参数 > 模版参数 > 全局参数

3.2 参数赋值优先级

参数赋值方式可以通过参数控件、url、参数默认值传递。当同时赋值同一个参数时,默认会使用优先级高的赋值方式,优先级如下:

参数控件赋值 > url赋值 > 参数默认值