1. 内容概述
报表参数是报表中最常用的数据过滤来源,我们添加了报表参数后,预览报表时会出现一个参数输入框,提示用户输入参数值。
本节就为您介绍报表参数的添加过程(含参数配置项介绍)。
另外,当我们使用带有参数的数据源或者数据集时,也会自动映射报表参数。
2. 添加报表参数
(1) 在报表设计器的右侧,打开数据绑定面板后单击报表参数区域的“+添加”,如下图所示。
![](/download/attachments/71031300/image2020-6-9_16-6-17.png?version=1&modificationDate=1647595157000&api=v2)
(2) 单击报表参数列表中出现的新条目“报表参数1”,面板中将显示报表参数的详细设置信息。
这里我们将参数名称修改为“销售大区”,提示文本修改为“请输入销售大区:”,数据类型设置为“字符串类型”,然后单击设置面板左上角的返回箭头。
![](/download/attachments/71031300/image2020-6-9_16-7-3.png?version=1&modificationDate=1647595157000&api=v2)
报表参数编辑面板中各设置项的含义如下:
- 参数名称:为报表参数设置名称,用于参数识别。
- 提示文本:预览报表时,在参数面板中的提示信息。如下图红框中提示文本。
![](/download/attachments/71031300/image2020-6-9_16-7-45.png?version=1&modificationDate=1647595157000&api=v2)
- 数据类型:按照实际情况选择参数值的数据类型。支持布尔型、日期型、日期时间型、整型、浮点型、字符串型。
当选择数据类型为日期型或日期时间型时,单击参数面板输入框会自动加载日历控件,更方便用户输入使用。
![](/download/attachments/71031300/image2020-6-9_16-10-22.png?version=1&modificationDate=1647595157000&api=v2)
- 默认数据:设定报表参数的默认值。默认值可以来自于数据集中的数据字段,也可以进行手动添加。如果为报表参数设定了默认数据,首次打开报表则不需要用户输入直接显示查询结果。
(3) 至此,报表参数就添加完成了。您可以通过小叉号删除查询参数,当查询参数较多时,可以单击查询参数右侧的上下箭头来调整查询参数的显示顺序。
![](/download/attachments/71031300/image2020-6-9_16-8-43.png?version=1&modificationDate=1647595157000&api=v2)
(4) 预览报表即可见出现了一个参数输入框。但此时我们并没有将报表参数用于实际的数据过滤中。
您可以将它用于数据集过滤或组件数据过滤,也可以直接将报表参数拖拽到报表中直接显示参数值(可参见显示过滤条件)。
![](/download/attachments/71031300/image2020-6-9_16-9-28.png?version=1&modificationDate=1647595157000&api=v2)