教程：向报表添加参数（报表生成器）
通过向报表添加参数，用户可以筛选来自数据源的报表数据或报表中的报表数据。 报表参数是针对您在数据集查询中包含的每个查询参数自动创建的。 参数的数据类型确定了参数在报表视图工具栏上显示的方式。
学习内容
在本教程中，您将学习如何执行下列操作：
注意
在本教程中，将向导的多个步骤合并为一个过程。 有关如何浏览到报表服务器、选择数据源和创建数据集的分步说明，请参阅本系列中的第一个教程：教程：创建基本表报表（报表生成器）。
完成本教程的估计时间：25 分钟。
要求
有关要求的信息，请参阅教程先决条件（报表生成器）。
1. 通过表或矩阵向导创建矩阵报表和数据集
创建矩阵报表、数据源和数据集。
注意
在本教程中，由于查询包含了数据值，因此它不需要外部数据源。 这样，查询就会非常长。 在业务环境中，查询不会包含数据。 本教程中的查询仅供学习使用。
创建新的矩阵报表
单击“开始”，指向“程序”，指向“Microsoft SQL Server 2014Report Builder”，然后单击“Report Builder”。
此时将显示 “入门” 对话框。
注意
如果未显示“入门”对话框，请在“Report Builder”按钮中单击“新建”。
在左窗格中，验证是否已选择 “报表 ”。
在右窗格中，单击“表或矩阵向导”。
单击创建。
在“选择数据集”页上，单击“创建数据集” 。
单击“下一步”。
在“选择数据源的连接”页上，选择类型为“SQL Server”的数据源。 从列表中选择一个数据源或浏览到报表服务器以选择一个数据源。
单击“下一步”。
在“设计查询”页上，单击“编辑为文本” 。
将以下查询粘贴到查询窗格中：
;WITH CTE (StoreID, Subcategory, Quantity) AS ( SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity UNION SELECT 200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity UNION SELECT 200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity UNION SELECT 199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity UNION SELECT 306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity UNION SELECT 306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity UNION SELECT 306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity UNION SELECT 306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity) SELECT StoreID, Subcategory, Quantity FROM CTE此查询将多个 Transact-SQL SELECT 语句的结果合并到公用表表达式中，以指定基于 Contoso 示例数据库中简化数据的值。 Contoso 销售数据表示消费品的国际销售数据。 本教程使用相机的销售数据。 子类别表示数码相机、数码单反 (SLR) 相机、摄像机和附件。
此查询指定了列名称，包括一个商店标识符、一个销售物品子类别以及三个商店的销售订单的订购数量。 在此查询中，商店名称不是结果集的一部分。 接下来，您将在本教程中从单独的数据集查找与商店标识符对应的商店名称。
此查询不包含查询参数。 稍后，您将在本教程中添加查询参数。
在查询设计器工具栏中，单击“运行”( ! )。 结果集显示 11 行数据，这些数据显示针对四个商店的每个子类别销售的物品数量，并且结果集包含以下列：StoreID、Subcategory、Quantity。
单击“下一步”。
2. 从表或矩阵向导中组织数据、选择布局和样式
使用此向导可提供用于显示数据的起始设计。 此向导中的预览窗格可帮助您在完成表或矩阵设计之前将对数据进行分组的结果可视化。
将数据组织到组中
在“排列字段”页上，将 Subcategory 拖到“行组”中 。
将 StoreID 拖到“列组”中。
将 Quantity 拖到“值”中。
已将销售量的值组织到按子类别分组的行中。 每个商店将对应一个列。
单击“下一步”。
在 “选择布局” 页上的 “选项”下，验证是否已选中 “显示小计和总计 ”。
当您运行报表时，最后一列将显示所有商店的每个子类别的总数量，而最后一行将显示每个商店的所有子类别的总数量。
单击“下一步”。
在 “选择样式 ”页上的“样式”窗格中，选择一种样式。
单击“完成”。
矩阵将添加到设计图面中。 矩阵将显示 3 列和 3 行。 第一行中的单元格内容是 Subcategory、[StoreID] 和“总计”。 第二行中的单元格内容包含的表达式表示子类别、每个商店销售的物品数量以及所有商店每个子类别的总数量。 最后一行中的单元格显示每个商店的总计。
在矩阵中单击，将光标悬停在第一个列的边缘并抓住句柄，然后扩展列宽。
单击 “运行” 以预览报表。
报表将在报表服务器上运行并显示标题以及进行报表处理的时间。
在此方案中，列标题显示的是商店标识符而不是商店名称。 接下来，您将添加表达式以便在包含商店标识符/商店名称对的数据集中查找商店名称。
3.添加查询参数以创建报表参数
当向查询添加查询参数时，报表生成器将自动创建单值报表参数，其中名称、提示符和数据类型使用默认属性。
添加查询参数
切换到“设计”视图。
在“报表数据”窗格中，展开“数据集”文件夹，右键单击“DataSet1”，然后单击“查询” 。
将以下 Transact-SQL
WHERE子句添加为查询中的最后一行：WHERE StoreID = (@StoreID)子
WHERE句将检索到的数据限制为查询参数 @StoreID指定的存储标识符。在查询设计器工具栏中，单击“运行”( ! )。 此时将打开“定义查询参数”对话框，提示为查询参数 @StoreID 输入值。
在“参数值”中，键入 200。
单击 “确定” 。
结果集显示了标识符为 200的商店销售的附件、摄像机和数码 SLR 相机数量。
单击 “确定” 。
在“报表数据”窗格中，展开“参数”文件夹。
请注意，现在有一个名为 @StoreID 的报表参数。 默认情况下， 参数的数据类型为 Text。 由于商店标识符是一个整数，因此在下一个过程中将数据类型更改为 Integer。
4.更改报表参数的默认数据类型和其他属性
创建报表参数之后，可以调整属性的默认值。
更改报表参数的默认数据类型
在“报表数据”窗格中的“ 参数 ”节点下，右键单击“ @StoreID”，然后单击“ 参数属性”。
在“提示”中，键入 “应用商店标识符？” 运行报表时，此文本将显示在报表查看器工具栏上。
在“数据类型”的下拉列表中，选择“整数” 。
接受对话框中的其他默认值。
单击“确定”。
预览报表。 报表查看器显示 @StoreID提示。
在报表查看器工具栏上，在 Store ID 的旁边键入 200，然后单击“查看报表”。
4a. 添加数据集以提供可用值和显示名称
若要确保用户只能为参数键入有效值，可以创建一个从中选择值的值下拉列表。 值可以来自于您指定的数据集或列表。 可用值必须由具有不包含对参数的引用的查询的数据集提供。
为参数创建有效值数据集
切换到“设计”视图。
在“报表数据”窗格中，右键单击“数据集”文件夹，然后单击“添加数据集” 。
在“名称”中，键入“Stores” 。
选择“ 使用嵌入在我的报表中的数据集 ”选项。
在 “数据源”的下拉列表中，选择在第一个过程中创建的数据源。
在“查询类型”中，确保已选中“文本” 。
在“查询”中，粘贴以下文本：
SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName单击 “确定” 。
“报表数据”窗格在 Stores 数据集节点下显示字段 StoreID 和 StoreName。
4b. 指定可用值以创建值的下拉列表
在创建数据集以提供可用值之后，必须更改报表属性，以指定将哪个数据集和哪个字段用于填充报表查看器工具栏上的有效值下拉列表。
为参数提供数据集中的可用值
在“报表数据”窗格中，右键单击 参数@StoreID，然后单击“ 参数属性”。
单击“可用值”，然后单击“从查询中获取值”。
在“数据集”的下拉列表中，单击“Stores” 。
在“值字段”的下拉列表中，单击“StoreID”。
在“标签字段”的下拉列表中，单击“StoreName”。 标签字段指定值的显示名称。
单击 “常规” 。
在“提示”中，键入 “应用商店名称？”
用户现在将从商店名称列表而非商店标识符列表中进行选择。 请注意，参数数据类型保持为 Integer ，因为参数是基于商店标识符而不是商店名称。
单击 “确定” 。
预览报表。
在报表查看器工具栏中，参数文本框现在是显示“<选择值>”的下拉列表。
从下拉列表中选择“Contoso 目录存储”，然后单击“ 查看报表”。
报表显示了标识符为 200的商店销售的附件、摄像机和数码 SLR 相机数量。
4c. 指定默认值，以便自动运行报表
可以为每个参数指定默认值，以便自动运行报表。
从数据集中指定默认值
切换到“设计”视图。
在“报表数据”窗格中，右键单击“@StoreID”，然后单击“参数属性”。
单击 “默认值”，然后单击“ 从查询中获取值”。
在“数据集”的下拉列表中，单击“Stores” 。
在“值字段”的下拉列表中，单击“StoreID”。
单击 “确定” 。
预览报表。
对于@StoreID，报表查看器显示值“Contoso 北美 Online Store”。 这是数据集 存储区的结果集中的第一个值。 报表显示了标识符为 199的商店销售的数码相机数量。
指定自定义默认值
切换到“设计”视图。
在“报表数据”窗格中，右键单击“@StoreID”，然后单击“参数属性”。
单击 “默认值”，单击“ 指定值”，然后单击“ 添加”。 此时将添加一个新的值行。
在“值”中，键入“200” 。
单击 “确定” 。
预览报表。
对于 @StoreID，报表查看器显示值“Contoso 目录存储”。 这是存储标识符 200 的显示名称。 报表显示了标识符为 200的商店销售的附件、摄像机和数码 SLR 相机数量。
4d. 从具有名称/值对的数据集查找值
数据集可以同时包含标识符和对应的名称字段。 若只有一个标识符，则可以在创建的包含名称/值对的数据集中查找对应的名称。
从数据集查找值
切换到“设计”视图。
在设计图面上，在矩阵的第一行的列标题中，右键单击
[StoreID]，然后单击“表达式”。在表达式窗格中，删除除开头的
equals(=) 之外的所有文本。在“类别”中，展开“常见函数”，然后单击“杂项” 。 “项”窗格将显示一组函数。
在“项”中，双击“查找”。 表达式窗格将显示
=Lookup(。 “示例”窗格将显示一个 Lookup 语法示例。键入以下表达式：
=Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")Lookup 函数将采用 StoreID 的值，在“Stores”数据集中查找该值，并返回 StoreName 值。
单击 “确定” 。
存储列标题包含复杂表达式的显示文本： <<Expr>>。
预览报表。
每个页顶部的文本框显示商店名称而不是商店标识符。
5.在报表中显示所选参数值
当用户对报表有疑问时，此操作可帮助用户获知他们选择的参数值。 可以在报表中保留用户为每个参数的选定的值。 实现这一点的一种方式是在页脚的文本框中显示参数。
在页脚中显示所选参数值和标签
切换到“设计”视图。
右键单击页脚，指向 “插入”，然后单击“ 文本框”。 拖动带时间戳的文本框旁边的文本框。 抓住该文本框的侧手柄并扩展宽度。
从“报表数据”窗格中，将参数 @StoreID 拖到文本框。 文本框显示
[@StoreID]。若要显示参数标签，请在文本框中单击，直到插入游标出现在现有表达式之后，键入一个空格，然后从“报表数据”窗格将参数的另一个副本拖到文本框。 文本框显示
[@StoreID] [@StoreID]。右键单击第一个表达式，然后单击“ 表达式”。 此时将打开 “表达式” 对话框。 文本
Value已由Label代替。单击 “确定” 。
文本显示：
[@StoreID.Label] [@StoreID]。预览报表。
6.在筛选器中使用报表参数
筛选器可帮助控制在从外部数据源检索到数据后在报表中使用哪些数据。 为了让用户能够帮助控制他们要看到的数据，可以在矩阵的筛选器中包含报表参数。
在矩阵筛选器中指定参数
切换到“设计”视图。
右键单击矩阵中的某个行或列标题句柄，然后单击“Tablix 属性”。
单击“筛选器”，然后单击“添加” 。 此时将显示一个新的筛选器行。
在“表达式”的下拉列表中，选择数据集字段 StoreID。 数据类型显示 Integer。 当表达式值为数据集字段时，将自动设置数据类型。
在 “运算符”中，验证
equals是否选择了“ (=) ”。在“值”中，键入
[@StoreID]。[@StoreID]是一个简单表达式语法，它表示=Parameters!StoreID.Value。单击 “确定” 。
预览报表。
矩阵仅显示“Contoso Catalog Store”的数据。
在报表查看器工具栏上，对于“Store name?”，选择“Contoso Asia Online Store”，然后单击“查看报表” 。
矩阵将显示与所选商店对应的数据。
7.更改报表参数以接受多个值
若要将一个参数从单值参数更改为多值参数，则必须更改查询和包含对该参数的引用的所有表达式（包括筛选器）。 多值参数是一个值数组。 在数据集查询中，查询语法必须一个值是否包含在一组值中。 在报表表达式中，表达式语法必须访问一个值数组而不是单个值。
将一个参数从单值参数更改为多值参数
切换到“设计”视图。
在“报表数据”窗格中，右键单击“@StoreID”，然后单击“参数属性”。
选择“允许多个值”。
单击 “确定” 。
在“报表数据”窗格中，展开“数据集”文件夹，右键单击“DataSet1”，然后单击“查询” 。
将查询最后一行的 Transact-SQL
WHERE子句中的 (=) 更改为 ：equalsINWHERE StoreID IN (@StoreID)IN运算符测试一个值是否包含在一组值中。单击 “确定” 。
右键单击矩阵中的某个行或列标题句柄，然后单击“Tablix 属性”。
单击 “筛选器” 。
在“运算符”中，选择“In” 。
单击 “确定” 。
从页脚中用于显示参数的文本框中删除所有文本。
右键单击该文本框，然后单击“表达式”。 键入以下表达式：
=Join(Parameters!StoreID.Label, ", ")此表达式将连接用户所选的所有商店名称。
单击“确定”。
在刚创建的表达式的前面的文本框中单击，然后键入以下内容：Parameter Values Selected:。
预览报表。
单击 Store Name? 旁边的下拉列表
每个复选框旁边都会显示一个有效值。
单击“全选”，再单击“查看报表” 。
报表将显示所有商店销售的所有子类别的数量。
从下拉列表中，单击“全选”清除列表，再单击“Contoso Catalog Store”和“Contoso Asia Online Store”，然后单击“查看报表”。
8.为条件可见性添加布尔参数
添加布尔参数
在设计图面上的“报表数据”窗格中，右键单击“参数”，再单击“添加参数” 。
在“名称”中，键入“ShowSelections”。
在“提示符”，键入“Show selections?”
在 “数据类型”的下拉列表中，单击“ 布尔值”。
单击 “默认值” 。
单击“指定值”，然后单击“添加” 。
在“值”中，键入“False” 。
单击 “确定” 。
基于布尔参数设置可见性
在设计图面上，右键单击页脚中用于显示参数值的文本框，然后单击“文本框属性”。
单击 “可见性” 。
选择选项“基于表达式显示或隐藏”，然后单击表达式按钮“Fx”。
键入以下表达式：
=Not Parameters!ShowSelections.Value文本框的“可见性”选项由属性 Hidden 控制。 应用
Not运算符，以便在选择参数时，Hidden 属性为 false 并显示文本框。单击“确定”。
单击“确定”。
预览报表。
显示参数选项的文本框未出现。
在报表查看器工具栏的“显示选择”旁边，单击 。
True预览报表。
页脚中的文本框将显示所选的所有商店名称。
9.添加报表标题
添加报表标题
在设计图面上，单击“单击以添加标题”。
键入 Parameterized Product Sales，然后在文本框外部单击。
10.保存报表
将报表保存到报表服务器
从 “报表生成器” 按钮，单击 “另存为” 。
单击 “最近使用的站点和服务器” 。
选择或键入您拥有保存报表权限的报表服务器的名称。
此时将显示“正在连接到报表服务器”消息。 当连接完成时，您将看到报表服务器管理员指定为报表默认位置的报表文件夹的内容。
在“名称”中，用 Parameterized Sales Report 替换默认名称。
单击“ 保存”。
报表即已保存至报表服务器。 您连接的报表服务器将显示在窗口底部的状态栏中。
后续步骤
到此为止，我们结束了有关如何向报表添加参数的演练。 要了解有关参数的详细信息，请参阅报表参数（报表生成器和报表设计器）。