控件默认值

1.1 版本

1.2 功能简介

在使用控件时，有时需要给控件一个默认值，如筛选查询报表，初始化时需要有默认查询结果；填报的时候，需要默认写入一个值。那如何给控件设置默认值呢？

给控件赋默认值，可以直接给控件赋值；当参数和控件绑定的情况下，可以直接给参数赋值，因为两者绑定，给参数赋值也就意味着给控件赋了默认值。

2.1 控件默认值

用户可以直接在控件的属性面板中给控件设置默认值，如下图所示：

如果是填报控件，则可以直接在控件单元格中写入值，如下图所示：

2.2 参数默认值

当参数和控件绑定的情况下，给参数赋值也就意味着给控件赋了默认值。用户可以在定义的参数的时候赋默认值，也可以在URL 中给参数赋默认值。如下表所示：

注：参数默认值格式必须要和控件要求的默认值格式一样，如下拉框复选框默认值为 华北;华东，则参数默认值也要是 华北;华东

赋值方法	说明	图示
定义参数时赋值	定义 模板参数 的时候赋的初始值
	定义 全局参数 的时候赋的初始值
	定义 数据集参数 的时候赋的初始值
URL 传参	Web 端预览模板时，在 URL 后面附上参数默认值，如 http://localhost:8075/webroot/decision/view/report?viewlet=test.cpt&p1=a
	数据决策系统内挂载模板时设置的参数默认值，详情可参考 管理目录 对应章节

2.3 优先级原则

当模板中通过多种方法对控件或者参数赋值后，最终显示和生效的是 优先级最高 方式设置的默认值。

优先级依次为：URL 传参>控件的属性面板中控件值>模板参数默认值>全局参数默认值>数据集参数默认值

例如：当 URL 传递参数p1的值为 a，模板参数 p1 的默认值为 b。则预览模板时，参数的默认值为优先级高的 a。

3.1 填报控件

3.1.1 应用场景

我们常常希望填报界面进行填报前，控件中已有初始值，这个初值其实就是填报控件的默认值。如下图所示：

3.1.2 实现思路

在控件所在单元格中直接输入默认值。如下图所示：

3.2 参数控件

3.2.1 应用场景

我们常常希望点击 查询按钮前能够根据参数界面上的默认值来显示报表内容。如下图所示：

3.2.2 实现思路

在定义模板参数的时候，设置默认值，如下图所示：

在参数界面选中参数控件，在控件的「属性表>高级>控件值」中进行设置。如下图所示：

预览报表时，在URL 后面跟上参数的初始值，参数界面即会显示url中的值。例如访问报表http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt&地区=华北，参数界面上的控件值即为 URL 中的值，如下图所示：