项目
04/01/2012

教程：向报表添加参数 (Report Builder 3.0)

通过向报表添加参数，用户可以筛选来自数据源的报表数据或报表中的报表数据。报表参数是针对您在数据集查询中包含的每个查询参数自动创建的。参数的数据类型确定了参数在报表视图工具栏上显示的方式。

参数化销售报表

学习内容

在本教程中，您将了解如何执行下列操作：

使用表或矩阵向导创建矩阵报表和数据集
使用表或矩阵向导组织数据并选择布局和样式
添加查询参数以创建报表参数
更改报表参数的默认数据类型和其他属性
1. 添加数据集以提供可用值和显示名称
2. 指定可用值以创建值的下拉列表
3. 指定默认值，以便自动运行报表
4. 从具有名称/值对的数据集查找值
在报表中显示所选参数值
在筛选器中使用报表参数
更改报表参数以接受多个值
为条件可见性添加布尔参数
添加报表标题
保存报表

注意
在本教程中，将向导的多个步骤合并为一个过程。有关如何浏览到报表服务器、选择数据源和创建数据集的分步说明，请参阅这一系列教程中的第一个教程：教程：创建基本表报表 (Report Builder 3.0)。

本教程的预计学时：25 分钟。

要求

有关要求的信息，请参阅教程先决条件 (Report Builder 3.0)。

1. 使用表或矩阵向导创建矩阵报表和数据集

创建矩阵报表、数据源和数据集。

注意
在本教程中，由于查询包含了数据值，因此它不需要外部数据源。这样，查询就会非常长。在业务环境中，查询不会包含数据。本教程中的查询仅供学习使用。

创建新的矩阵报表

单击**“开始”，依次指向“程序”和“Microsoft SQL Server 2008 R2 Report Builder 3.0”，再单击“Report Builder 3.0”**。

此时将显示**“入门”**对话框。

注意

如果不显示“入门”对话框，则从“报表生成器”按钮中单击“新建”。
在左窗格中，确认已选中**“报表”**。
在右窗格中，单击**“表或矩阵向导”**。
单击**“创建”**。
在**“选择数据集”页上，单击“创建数据集”**。
单击**“下一步”**。
在**“选择数据源的连接”页上，选择类型为“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-SQLWHERE 子句添加到查询的最后一行：
```
WHERE StoreID = (@StoreID)
```
WHERE 子句将检索的数据限制为由查询参数 @StoreID 指定的商店标识符。
在查询设计器工具栏中，单击**“运行”(!)。此时将打开“定义查询参数”**对话框，提示您为查询参数 @StoreID 输入值。
在**“参数值”**中，键入 200。
单击“确定”。

结果集显示了标识符为 200 的商店销售的附件、摄像机和数码 SLR 相机数量。
单击“确定”。
在“报表数据”窗格中，展开**“参数”**文件夹。

请注意，现在有一个名为 @StoreID 的报表参数。默认情况下，此参数的数据类型为 Text。由于商店标识符是一个整数，因此在下一个过程中将数据类型更改为 Integer。

4. 更改报表参数的默认数据类型和其他属性

创建报表参数之后，可以调整属性的默认值。

更改报表参数的默认数据类型

在“报表数据”窗格的**“参数”**节点中，右键单击 @StoreID，然后单击**“参数属性”**。
在提示符下，键入 Store identifier?当您运行报表时，此文本出现在报表查看器工具栏上。
在**“数据类型”**中，从下拉列表选择 Integer。
接受对话框中的其他默认值。
单击“确定”。
预览报表。报表查看器显示 @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。标签字段指定值的显示名称。
单击**“常规”**。
在提示符下，键入 Store name?

用户现在将从商店名称列表而非商店标识符列表中进行选择。请注意，参数数据类型保持为 Integer，因为参数是基于商店标识符而不是商店名称。
单击“确定”。
预览报表。

在报表查看器工具栏中，参数文本框现在为显示**“<选择一个值>”**的下拉列表。
从下拉列表中，选择 Contoso Catalog Store，然后单击**“查看报表”**。

报表显示了标识符为 200 的商店销售的附件、摄像机和数码 SLR 相机数量。

4c.指定默认值，以便自动运行报表

可以为每个参数指定默认值，以便自动运行报表。

从数据集中指定默认值

切换到设计视图。
在“报表数据”窗格中，右键单击 @StoreID，然后单击**“参数属性”**。
单击**“默认值”，然后单击“从查询中获取值”**。
在**“数据集”**中，从下拉列表单击 Stores。
在**“值字段”**中，从下拉列表单击 StoreID。
单击“确定”。
预览报表。

对于 @StoreID，报表查看器显示值“Contoso North America Online Store”。这是数据集 Stores 的结果集中的第一个值。报表显示了标识符为 199 的商店销售的数码相机数量。

指定自定义默认值

切换到设计视图。
在“报表数据”窗格中，右键单击 @StoreID，然后单击**“参数属性”**。
依次单击**“默认值”、“指定值”和“添加”**。此时将添加一个新的值行。
在**“值”**中，键入 200。
单击“确定”。
预览报表。

对于 @StoreID，报表查看器显示值“Contoso Catalog Store”。这是标识符为 200 的商店的显示名称。报表显示了标识符为 200 的商店销售的附件、摄像机和数码 SLR 相机数量。

4d.从具有名称/值对的数据集查找值

数据集可以同时包含标识符和对应的名称字段。若只有一个标识符，则可以在创建的包含名称/值对的数据集中查找对应的名称。

从数据集查找值

切换到设计视图。
在设计图面上，在矩阵中的第一个行的列标题中，右键单击 [StoreID]，然后单击**“表达式”**。
在表达式窗格中，删除除开头的 equals (=) 之外的所有文本。
在**“类别”中，展开“常见函数”，然后单击“杂项”**。“项”窗格将显示一组函数。
在“项”中，双击**“查找”**。表达式窗格将显示 =Lookup(。“示例”窗格将显示一个 Lookup 语法示例。
键入以下表达式：=Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")

Lookup 函数将采用 StoreID 的值，在“Stores”数据集中查找该值，并返回 StoreName 值。
单击“确定”。

Store 列标题将包含复杂表达式的显示文本：<<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-SQLWHERE 子句中，将 equals (=) 更改为 IN：
```
WHERE 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?
在**“数据类型”**中，从下拉列表单击 Boolean。
单击**“默认值”**。
单击**“指定值”，然后单击“添加”**。
在**“值”**中，键入 False。
单击“确定”。

基于布尔参数设置可见性

在设计图面上，右键单击页脚中用于显示参数值的文本框，然后单击**“文本框属性”**。
单击**“可见性”**。
选择选项**“基于表达式显示或隐藏”，然后单击表达式按钮“Fx”**。
键入以下表达式：=Not Parameters!ShowSelections.Value

文本框的“可见性”选项由属性 Hidden 控制。应用 Not 运算符，以便在选择参数时，Hidden 属性为 false 并显示文本框。
单击“确定”。
单击“确定”。
预览报表。

显示参数选项的文本框未出现。
在报表查看器工具栏上，单击 Show selections 旁边的 True。
预览报表。

页脚中的文本框将显示所选的所有商店名称。

9. 添加报表标题

添加报表标题

在设计图面上，单击**“单击以添加标题”**。
键入 Parameterized Product Sales，然后在文本框外部单击。

10. 保存报表

将报表保存到报表服务器

从**“报表生成器”按钮，单击“另存为”**。
单击**“最近使用的站点和服务器”**。
选择或键入您拥有保存报表权限的报表服务器的名称。

此时将显示消息**“正在连接到报表服务器”**。当连接完成时，您将看到报表服务器管理员指定为报表默认位置的报表文件夹的内容。
在**“名称”**中，用 Parameterized Sales Report 替换默认名称。
单击**“保存”**。

报表即已保存至报表服务器。您连接的报表服务器将显示在窗口底部的状态栏中。

后续步骤

到此为止，我们结束了有关如何向报表添加参数的演练。有关参数的详细信息，请参阅参数（Report Builder 3.0 和 SSRS）。

通过