参数入门

1 概述

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

1.1 参数的作用

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

1.2 获得参数值的时机

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

2 参数创建

创建参数有两种方式，具体参考文档：参数创建。
常见的创建方法是在模板设计界面的左侧资源区“参数”Tab下点击[+]按钮，如下图：

3 参数设置

点击[+]按钮将弹出参数设置窗口，公共属性包括：基本、校验规则和高级。如下图：

3.1 基本

主要包含配置，不同控件支持的配置会有所不同。
1）参数名称：参数没有显示名称和内部名称之类的区分，只有这个参数名称，如果参数区域显示则就是这个名称；如果被引用成为变量，即按照此名称并前缀以“@”符号；
2）报表查看时在参数区域显示：是否需要在参数区域显示，供用户查看或交互。如果不显示，则相当于把参数定义成为了一个隐藏的变量了；
3）控件类型：参数需要使用什么控件进行前端交互；
4）默认值：参数的初始化值，支持使用表达式；显示风格用于默认值规定一个显示格式，较多地是在参数为日期类型的时候使用。

3.3 校验规则

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

3.4 高级

参数的不常用配置，包括：报表查看时在参数区域显示、提示信息、控件宽度等。

4 调整参数顺序

配置多个参数时，需要调整参数顺序，可通过拖拽方式进行调整，如下图：

5 参数面板设置

5.1 PC端

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

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

5.2 移动端

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