报表参数

1. 功能概述

报表参数是报表中最常用的过滤来源，添加报表参数后，预览报表时会出现一个参数输入框，提示用户输入参数值。

本节为您介绍报表参数的添加过程及配置项。

另外，当我们使用带有参数的数据源或者数据集时，也会自动映射成报表参数。

2. 添加报表参数

2.1 在报表设计器的右侧，打开数据绑定面板后单击报表参数区域的添加，如下图所示。

2.2 单击报表参数列表中出现的新条目“ 报表参数1 ”，面板中将显示报表参数的详细设置信息。

这里我们将参数名称修改为“ 销售大区 ”，提示文本修改为“ 请输入销售大区： ”，数据类型设置为字符串型，然后单击设置面板左上角的返回箭头。

报表参数编辑面板中各设置项的含义如下：

参数名称：为报表参数设置名称，用于参数识别。
提示文本：预览报表时，在参数面板中的提示信息。如下图红框中提示文本。
数据类型：按照实际情况选择参数值的数据类型。支持布尔型、日期型、日期时间型、整型、浮点型、字符串型。当选择数据类型为日期型或日期时间型时，还可以设置参数的格式。

设置以后，预览时参数将根据设置的格式进行显示。下图仅列举了三个格式对应的效果。
多值数据：当报表参数值为多选时，需开启多值数据功能。有关多值数据的具体用法，请参见示例多选下拉列表。
隐藏：开启后将隐藏参数面板，一般用于参数自动传值等不需要用户输入的场景。开启隐藏功能时，必须要设定默认数据。相关用法，请参见隐藏参数。
允许空值：该参数可以为空值。可利用表达式 IsNothing() 来判断是否为空，进行动态数据过滤。
多行数据：字符串型参数特有属性，用户在参数上可以输入多行文本。
允许空白：字符串型参数特有属性，表示该文本可以为空字符串 “” ，可用来作判断进行动态数据过滤。
可用数据：实现参数下拉列表时使用。可用数据即用于下拉列表中的数据，可以来自于一个数据集也可以手动添加。
如果数据来自于数据集，则需要设定数据集、数据字段和标签字段。
其中，数据字段的值用来进行数据过滤；标签字段的值则用来显示在下拉列表框中；数据字段和标签字段可设置成同一字段，也即显示在下拉列表中的数据即最终用于数据过滤的数据。排序规则用来设定下拉列表中的数据排序规则，可以按照数据字段来排序也可以按照标签字段排序。
下图为可用数据的设置情况以及应用效果，相关应用示例请参见单选下拉列表。

如果数据来自于手动添加，则需要一个个添加下拉列表中的数据。

可拖动排序。

也可以使用排序规则表示为下拉列表中的数据排序。
默认数据：设定报表参数的默认值。默认值可以来自于数据集中的数据字段，也可以进行手动添加。如果为报表参数设定了默认数据，首次打开报表则不需要用户输入直接显示查询结果。