参数入门

1 概述

参数指在设置或赋值不同的数值来实现一个目标结果，这些数值就是参数。为满足不同客户的使用需求，设计器中引入了参数的概念，可以使用参数动态地过滤数据，实现用户与数据的实时交互。

1.1 参数的作用

参数的作用主要包括：
1）利用参数，影响数据的获取范围，具体示例请参见：参数查询报表示例；
2）利用参数，影响模板执行的业务逻辑；
3）利用参数，传递关键信息；
4）定义模板的变量，根据变量的值去影响逻辑。

1.2 获得参数值的时机

获取参数值的时机归纳如下：
1）参数区域交互界面中，用户对参数的填写或选择；
2）模板执行过程中的链接过程传递参数值；
3）参数的默认值；
4）引擎中对参数或变量的重新赋值。

2 参数创建

创建参数有两种方式，具体参考文档：参数创建。
常见的创建方法是在“模板资源”根节点右键选择[新建]菜单，如下图：

3 参数设置

点击[新建]菜单将弹出参数设置窗口，公共属性包括：基本、高级、校验规则和自动填充参数。如下图：

3.1 基本

1）参数名称：参数没有显示名称和内部名称之类的区分，只有这个参数名称，如果参数区域显示则就是这个名称；如果被引用成为变量，即按照此名称并前缀以“@”符号；
2）报表查看时在参数区域显示：是否需要在参数区域显示，供用户查看或交互。如果不显示，则相当于把参数定义成为了一个隐藏的变量了；
3）默认值：参数的初始化值。如果在默认值栏里填写表达式，那么，需要勾选下面的“默认值脚本解析”选项；显示格式栏用以为默认值规定一个显示格式，较多地是在参数为日期类型的时候使用。

3.2 高级

1）参数允许为空
（1）如果勾选（默认），则在参数区域可以不为该参数填写或选择任何内容；在链接传递参数的时候可以不启用该参数；
（2）如果不勾选，则确保在模板运行的时候该参数必需要有具体的值，否则系统会提示出错信息。
2）参数值为空时使用默认值
（1）如果勾选，模板运行的时候，如果发现该参数为空，则会把默认值赋予该参数；
（2）默认为不勾选。
3）参数值允许编辑
指的是，在模板执行的时候，在参数区域界面中出现的该参数，是否允许用户进行修改交互？
如果参数的基本属性中的“报表查看时在参数区域显示”没有被勾选，那么，参数是否允许编辑就没有意义了。
4）参数联动
用来设置参数联动，具体请参见文档：参数联动。

3.3 校验规则

用来设置参数的校验，具体使用请参见文档：参数校验。

3.4 自动填充参数

包括是否自动获取参数值以及更新间隔、取数来源等配置，如下图：

4 调整参数顺序

配置多个参数时，需要调整参数顺序，则拖拽需要调整的参数到要显示的某个参数后面即可，如下图：

5 参数面板设置

5.1 PC端

PC端可以设置常用参数个数和查询后是否隐藏参数面板，如下图：

常用参数个数：默认为0，即所有参数均作为常用参数显示在参数面板中，具体使用请参见文档：常用参数设置；
查看后隐藏：默认不勾选，勾选后则点击参数面板的“查询”按钮后自动隐藏参数面板。

5.2 移动端

移动端可以设置常用参数个数，如下图：