1. 参数查询

1.1 参数组件

编辑框
编辑框输入文本查询数据,支持模糊查询,默认值包含:公式、内置变量
勾选模糊查询,匹配模式为:任意匹配、左匹配、右匹配

下拉框
下拉框数据一般较少,指定参数值与显示值
参数值:查询数据库对应的字段的值, 显示值:页面下拉框显示的可选择的值

数据集下拉框
数据下拉框数据来源数据集,预先定义下拉框的数据
参数值数据列:查询数据库对应的字段的值,显示值数据列:页面下拉框显示的可选择的值
搜索可选值:当下拉框值比较多的情况下,可勾选搜索可选值,下拉框则带有搜索功能
值改变触发查询:勾选选择下拉框值时查询报表

下拉日期
下拉框日期框可以选择日期、时间等作为参数查询报表,日期可以设置格式,日期类型为日期类型、日期格式化类型(字符串),如日期类型为:Sun Oct 23 20:39:14 CST 2022(可与数据库日期字段做比较),日期字符串类型为:2022-10-23

日期范围:勾选日期范围,需要填写开始名称(开始时间)、结束名称(结束时间)如(startDate,endDate),查询报表会传startDate,endDate参数

下拉树形
以树形结构展示参数数据,定义树形结构数据数据集,数据集名称为area,选择子级标识、父级标识、显示值、参数值。
父级标识:关联子级标识的上级节点标识,子级标识:关联父级标识的下级节点标识

参数值:查询数据库对应的字段的值,显示值:页面下拉框显示的可选择的值

展开:勾选,进入报表默认展开树形结构选项
仅显示根节点:勾选,选中树形结构选项,仅使用根节点选项作为参数查询报表
默认全选:勾选,参数页面树形下拉框默认显示全选
勾选不影响下级节点:勾选,参数页面树形下拉框勾选父级节点,下级节点不自动选中

单选框
多个单选框只能选择一个选项作为参数查询,指定参数值与显示值
参数值:查询数据库对应的字段的值, 显示值:页面单选框显示的可选择的标签

复选框
复选框用于一些可多选的内容,指定参数值与显示值
参数值:查询数据库对应的字段的值, 显示值:页面单选框显示的可选择的标签,参数值与显示值也可以来源数据集

显示全选:勾选显示全选,可对所有的选项进行选中或取消选中

弹窗选择
当下拉框数据量比较大的情况下,使用弹窗选择,弹窗选择是指以弹窗的形式打开一个报表,然后查询并选择对应的数据。
弹窗报表:可以查询选择的报表
参数值单元格:弹窗报表的单元格地址值作为参数查询
显示值单元格:弹窗报表的单元格地址值作为显示标签

输入框点“查询”图标或是点击输入框,弹窗报表页面,报表设计器页面需要插入一个单选框,插入》组件》单选框,单选框参数属性设置如下:

弹窗参数选择显示效果

文本域
文本域可输入单个数据,或多条数据查询报表,多条数据需要指定分隔规则,如以逗号(,)分隔填写多条数据作为查询条件

查询、重置按钮
拖动“查询按钮”到参数页面,点击“查询“,则会根据参数页面查询报表,拖动“重置按钮”到参数页面,点击”重置“则将参数页面组件重置为空值

1.2 隐藏域

隐藏域就是一个普通的表单,只是不可见而已,用于向后台提交表单数据,在网页表面上是不会显示出来的,具体形式<input type="hidden" name="name" value="值"/>,可见type=”hidden”就表示它是隐藏域,在value中保存一些值集,通过name或其他方式进行获取和修改。

隐藏域默认值可支持公式,如从URL接受参数为=$参数名称

1.3 参数模板

参数模板作用是定义一些通用的参数页面设置,再新建报表时可以使用该参数模板
保存模板:将该报表参数页面定义的参数组件进行保存
模板管理:删除保存的模板
引用模板:新增报表时可以使用定义好的参数模板

1.4 参数校验

为了保证信息的有效性和正确性,防止数据的错误和无效,在使用数据之前,通常要对客户端输入的数据进行验证。

必填:验证输入组件必须存在值,消息:该组件验证错误时的错误提示信息。
最大长度:验证输入文本的不能超过最大长度,消息:超过最大长度时的错误提示信息。
最小长度:验证输入文本的不能小于最小长度,消息:小于最小长度时的错误提示信息。
最大值:验证输入的数值不能超过最大值,消息:超过最大数值时的错误提示信息。
最小值:验证输入的数值不能小于最小值,消息:小于最小数值时的错误提示信息。
正则表达式:验证email、url等的固定格式的表达式,消息:不符合表达式时的错误提示信息。