报表参数

概述

报表参数是报表的输入：用户在查询表单里填写的条件、外部系统通过链接传入的值，都要先在报表里声明，才会传进表达式和数据集。声明时指定参数名称、类型和默认值；用户没有提供值时，使用默认值。

声明参数

1. 在设计器工具栏点「查询参数设置」，打开「报表参数配置」对话框。
2. 新增一行，填写各列：

3. 点「确定」保存。

只有在这里声明过的参数才会传进报表；请求里多出的参数不会带入表达式和数据集。（交互排序、查询过滤使用的内部参数除外，由系统自动保留。）

参数类型

值传入后会转换成声明的类型。

集合参数

集合类型需要再指定元素类型：「文本元素」或「数值元素」。传入值的解析规则：

• 已是数组或 JSON 数组（如 ["内科","外科"]）：直接使用。
• 文本：按半角逗号 ,、全角逗号 ，、顿号 、 拆分，去掉每项首尾空格，丢弃空项；内科，外科、口腔 得到三个元素。
• 空文本：得到空列表。
• 元素无法转成声明的元素类型（如数值元素里出现 abc）时报错。

集合参数在 SQL 里作为 IN 条件的用法见 SQL 参数与动态语法。

默认值

固定值

直接填写值，按参数类型转换。日期类型按日期格式填写。

表达式

默认值模式选「表达式」，填写一段表达式，报表运行时计算得到默认值。表达式里可以使用其他参数（取的是请求传入的值，不是它们各自的默认值），也可以调用所有内置函数。

表达式出错时，整张报表报错「报表参数计算错误，名称：…」，请先在预览里确认表达式能算出值。

日期预设

日期和日期时间类型可以直接选预设，省去写表达式：

新建日期类型参数默认预设为「当天」，日期时间类型默认为「当前时间」。「月末」「季度末」「年末」的具体时分秒与日期函数 monthEnd、quarterEnd、yearEnd 一致，见 日期函数。预设的取值时间以服务器当前时间为准。

取值顺序

报表运行时，每个已声明的参数按下面的顺序取值：

1. 请求（查询表单、链接、嵌入调用）传入了非空的值，用传入值。
2. 否则用默认值：固定值、表达式的计算结果或日期预设。
3. 结果按参数类型转换（字符串、数值、日期、集合等）。

传入空值（null）与没有传入等同，都会落到默认值；传入空文本 '' 则不是 null，会作为空文本参与转换。

引用参数

引用没有声明的参数不会报错，值为 null。因此参数名拼写错误往往表现为「查不到数据」而不是报错，遇到条件不生效时先检查参数名。

与查询表单配合

查询表单的控件通过绑定参数名把用户输入传给报表，控件与参数的对应见 查询表单概述 和 参数类型、默认值与传参。表单里没有填写的条件，按上面的取值顺序落到默认值。

常见问题