第 2 课：添加按日期进行筛选的参数

项目
12/15/2008

新建日期： 2006 年 7 月 17 日

通过在报表查询中包含开始日期参数和结束日期参数，可以指定用来限定从数据源检索的数据所处的日期范围。您可以创建其他参数，以便对从数据源检索到的数据进行筛选。

在本课中，您将添加查询参数 @StartDate 和 @EndDate。您将看到系统会为您自动创建区分大小写的报表参数 StartDate 和 EndDate（不带查询参数指示器 @）。注意，不同的数据访问接口使用不同的查询参数指示器。例如，Oracle 数据访问接口使用冒号 (:) 而不使用 @ 符号。

您将把这些参数的数据类型设置为 DateTime，并将看到工具栏中会显示一个带有参数文本框的日历控件。您还将设置这些参数的默认值，以便报表可以自动运行。最后，您将创建未绑定到查询参数的报表参数 DayofWeek，并使用该报表参数对从数据源检索到的数据进行筛选。

将日期参数添加至查询

在“数据”视图中，选择 AdventureWorks 数据集。

用以下查询替换现有的查询：

SELECT S.OrderDate, S.SalesOrderNumber, S.TotalDue, C.FirstName, 
    C.LastName
FROM  HumanResources.Employee E INNER JOIN
      Person.Contact C ON E.ContactID = C.ContactID INNER JOIN
      Sales.SalesOrderHeader S ON E.EmployeeID = S.SalesPersonID
WHERE (S.OrderDate BETWEEN (@StartDate) AND (@EndDate))
-- Accurate Enddate would be '20020228 23:59:59.997'

注意：
SQL Server 存储 DATETIME 数据精确到 3% 秒。有关详细信息，请参阅日期和时间 (Transact-SQL)。如果使用 DateTime 变量未得到预期的筛选结果，则可能需要在查询参数中使用更精确的时间。

在本教程中，您将使用近似的日期时间值。

在工具栏上单击**“运行”(!)。将打开“定义查询参数”**对话框。
在**“参数值”**列中，为 @StartDate 输入值。例如，20010101。
在**“参数值”**列中，为 @EndDate 输入值。例如，20030101。
单击**“确定”**。系统会自动创建报表参数 StartDate 和 EndDate，并将数据类型默认设置为 String。在接下来的三个步骤中，将把这些参数设置为数据类型 DateTime。
在**“报表”菜单中，单击“报表参数”。将打开“报表参数”**对话框。
在**“参数”列表框中，确保突出显示 StartDate。在“数据类型”**下拉列表中，选择 DateTime。
在**“参数”列表框中，选择 EndDate。在“数据类型”**下拉列表中，选择 DateTime。
单击**“确定”**。
单击**“预览”**。StartDate 和 EndDate 参数将分别随一个日历控件显示在工具栏中。参数的数据类型是 DateTime 并且未定义可用值列表时，日历控件便会自动显示。定义可用值列表将创建一个值下拉列表，而不是日历控件。

在本教程中，您将为参数输入值，而并不使用日历控件。
在 StartDate 参数文本框中，输入日期 2001-01-01。
在 EndDate 参数文本框中，输入日期 2003-01-01。
单击**“查看报表”**。报表将仅显示位于报表参数值范围中的数据记录。

为报表创建查询参数后，可以为这些参数添加默认值。默认参数可以让报表自动运行；否则，用户必须输入参数值，报表才能运行。

为日期参数设置默认值

在“布局”视图中，单击**“报表”菜单中的“报表参数”。将打开“报表参数”**对话框。
在**“参数”**列表框中，确保突出显示 StartDate。
在默认值部分中，选择**“无查询”**并键入 2001-01-01。按 Tab 键退出该文本框。
在**“参数”**列表框中，选择 EndDate。
在默认值部分中，选择**“无查询”**并键入 2003-01-01。按 Tab 键退出该文本框。
单击**“确定”**。
单击**“预览”**。由于为所有参数定义了默认值，因此报表会立即运行。

报表用户运行报表时，可以使用位于查询参数作用域范围中的参数值来设置默认值。例如，您可以提供将所呈现数据限定为一个月的报表参数值。

将新字段添加至查询以用于筛选

在“数据”视图中，选择 AdventureWorks 数据集。

在查询中，将以下命令添加至 SELECT 语句，以便为发生销售业务的工作日另外定义一个计算列：DATENAME(weekday, S.OrderDate) as Weekday。

用以下文本替换现有的查询：

SELECT S.OrderDate, DATENAME(weekday, S.OrderDate) as Weekday,
      S.SalesOrderNumber, S.TotalDue, C.FirstName, C.LastName
FROM  HumanResources.Employee E INNER JOIN
      Person.Contact C ON E.ContactID = C.ContactID INNER JOIN
      Sales.SalesOrderHeader S ON E.EmployeeID = S.SalesPersonID
WHERE (S.OrderDate BETWEEN (@StartDate) AND (@EndDate))

单击“运行”(!)。您应该看到一个标有 Weekday 的新列以及每个工作日的名称。
在“数据集”窗口中，确保 Weekday 是字段。

注意：

如果“数据集”窗口不可见，则在“视图”菜单中，选择“数据集”。

现在已添加另外一个数据集字段 Weekday。手动创建报表参数并将其绑定到该字段时，用户可以按每周工作日筛选报表数据。

注意：
如果“数据集”窗口不可见，则在“视图”菜单中，选择“数据集”。

添加新的报表参数

单击**“布局”**选项卡。
从**“报表”菜单中，选择“报表参数”。将打开“报表参数”**对话框。
单击**“添加”**。新参数 Report_Parameter_2 会显示默认值。
在**“属性”部分的“名称”**文本框中，用 DayoftheWeek 替换 Report_Parameter_2。确保数据类型是 String。
在**“提示”**中，键入“筛选每周工作日：”。
清除**“允许空白值”**选项。
在**“可用值”部分中，单击“无查询”**。将这些项保留为空。
在**“默认值”部分中，单击“无查询”**。在文本框中，键入 Sunday。
单击**“确定”**。

使用参数表达式设置表筛选器

在“布局”视图中，选择该表。该表会显示一个灰色轮廓。
右键单击表轮廓并选择**“属性”。将打开“表属性”**对话框。
单击**“筛选器”**选项卡。
在**“表达式”**列中，从下拉列表选择 =Fields!Weekday.Value。
确保**“运算符”**是等号 (=)。
单击**“值”文本框，并从下拉列表中选择 <表达式>。将打开“编辑表达式”**对话框。
在全局变量窗格中，单击**“参数”**。当前参数列表将显示在对应的窗格中。
双击 DayoftheWeek。该参数表达式便会添加至表达式文本框中。现在以下表达式显示在表达式文本框中： =Parameters!DayoftheWeek.Value。
单击**“确定”**。
单击**“确定”**。

表的筛选器现在被设置为将字段 Weekday 中的值与 DayoftheWeek 的参数值进行比较。例如，在报表工具栏中为 DayoftheWeek 输入值“星期日”时，报表处理器将仅处理表中字段 Weekday 的值是 Sunday 的行。
单击**“预览”**。由于所有参数都有默认值，因此报表会自动运行。该表将仅显示由 StartDate 和 EndDate 定义的日期范围中的值，以及有关 Sunday 的值。
在下一可选步骤中，将格式设置添加至表格表头。

（可选）为表格表头行设置背景色和字体颜色

单击**“布局”**选项卡。
单击表。将显示表控点。
单击表格表头行。单击布局工具栏中的**“背景色”按钮。将打开“选择颜色”**对话框。
从 Web 选项卡中，选择**“深红色”**。
单击**“确定”**。

接下来，选择字体颜色。
单击布局工具栏中的**“前景色”按钮。将打开“选择颜色”**对话框。
从 Web 选项卡中，选择**“白色”**。
单击**“确定”**。
单击“预览”。该表会呈现为表格表头行选择的颜色。

后续步骤

您已成功地定义了查询参数和报表参数、为这些参数设置了默认值并将报表参数绑定到计算字段。在下一课中，您将学习为参数创建可用值，即有效值（参数列表）。请参阅第 3 课：添加具有可用值列表的单值参数。

请参阅

通过