向分页报表添加级联参数(报表生成器)

适用于: Microsoft Report Builder (SSRS) Power BI Report Builder SQL Server Data Tools 中的 Report Designer

级联参数提供了一种管理分页报表中的大量数据的方法。 您可以定义一组相关参数,使一个参数的值列表取决于其他参数选取的值。 例如,第一个参数是独立的,并且可能提供产品类别列表。 当用户选中某个类别后,第二个参数则取决于第一个参数的值。 第二个参数的值根据所选类别中的子类别列表进行更新。 用户查看报表时,类别和子类别参数的值用于筛选报表数据。

注意

在 SQL Server Data Tools 中,你可以在 Microsoft 报表生成器、Power BI 报表生成器和报表设计器中创建和修改分页报表定义 (.rdl) 文件。

若要创建级联参数,请首先定义数据集查询,并为所需的每个级联参数包括一个查询参数。 您还必须为每个级联参数创建单独的数据集以提供可用值。 有关详细信息,请参阅“为报表参数添加、更改或删除可用值(报表生成器)”。

顺序对于级联参数来说很重要,因为对较晚出现在列表中的参数的数据集查询将包含对较早出现在列表中的每个参数的引用。 在运行时,参数在“报表数据”窗格中的顺序确定参数查询在报表中的显示顺序。 并由此确定用户选择每个连续参数值的顺序。

有关创建具有多个值的级联参数以及包括“全选”功能的信息,请参阅“如何创建“全选”多值级联参数”。

  1. 在“报表数据”窗格中,右键单击数据源,然后选择“添加数据集”。

  2. 在“名称”中,输入数据集的名称。

  3. 在“数据源”中,选择数据源的名称,或选择“新建”创建一个数据源。

  4. “查询类型” 中,选择所选数据源的查询类型。 在本文章中,假定查询类型为“文本”。

  5. 在“查询”中,输入检索该报表的数据所使用的查询。 查询必须包含以下部分:

    1. 数据源字段列表。 例如,在 Transact-SQL 语句中,SELECT 语句指定给定表或视图中数据库列名的列表。

    2. 每个级联参数的一个查询参数。 查询参数通过指定查询中要包含或排除的特定值来限制从数据源中检索的数据。 通常,查询参数出现在查询的限制子句中。 例如,在 Transact-SQL SELECT 语句中,查询参数出现在 WHERE 子句中。

  6. 选择“运行”(!)。 在包括查询参数并运行查询之后,将自动创建对应于查询参数的报表参数。

    注意

    首次运行查询时的查询参数顺序确定它们在报表中的创建顺序。 要更改顺序,请参阅“更改报表参数的顺序(报表生成器)

  7. 选择“确定”

接下来,将创建一个提供独立参数的值的数据集。

创建数据集以提供独立参数的值

  1. 在“报表数据”窗格中,右键单击数据源,然后选择“添加数据集”。

  2. 在“名称”中,输入数据集的名称。

  3. “数据源” 中,确保该名称是在第 1 步中选择的数据源的名称。

  4. “查询类型” 中,选择所选数据源的查询类型。 在本文章中,假定查询类型为“文本”。

  5. 在“查询”中,输入检索该参数的值所使用的查询。 对独立参数的查询通常不包含查询参数。 例如,要对提供所有类别值的参数创建查询,可以使用类似于以下代码段的 Transact-SQL 语句:

    SELECT DISTINCT <column name> FROM <table>  
    

    SELECT DISTINCT 命令从结果集删除重复值,以便从指定表的指定列中获取每个唯一值。

    选择“运行”(!)。 结果集显示以上第一个参数的可用值。

  6. 选择“确定”

接下来,设置第一个参数的属性,以便在运行时使用该数据集填充其可用值。

设置报表参数的可用值

  1. 在“报表数据”窗格的“参数”文件夹中,右键单击第一个参数,然后选择“参数属性”。

  2. “名称” 中,确保参数名称准确无误。

  3. 选择“可用值”

  4. 选择“从查询中获取值”。 随即将显示以下三个字段。

  5. 在“数据集”列表中,选择在前面过程中创建的数据集的名称。

  6. 在“值”字段中,选择提供参数值的字段的名称。

  7. 在“标签”字段中,选择提供参数标签的字段的名称。

  8. 选择“确定”

接下来,创建一个提供依赖参数的值的数据集。

创建数据集以提供独立参数的值

  1. 在“报表数据”窗格中,右键单击数据源,然后选择“添加数据集”。

  2. 在“名称”中,输入数据集的名称。

  3. “数据源” 中,确保该名称是在第 1 步中选择的数据源的名称。

  4. “查询类型” 中,选择所选数据源的查询类型。 在本文章中,假定查询类型为“文本”。

  5. 在“查询”中,输入检索该参数的值所使用的查询。 对依赖参数的查询通常包含该参数所依赖的每个参数的查询参数。 例如,可对提供某一类别(独立参数)的所有子类别(依赖参数)值的参数创建查询。 为此,可以使用类似于以下代码段的 Transact-SQL 语句:

    SELECT DISTINCT Subcategory FROM <table>   
    WHERE (Category = @Category)  
    

    WHERE 子句中,Category 是 <table> 的字段名称,@Category 是查询参数。 该语句生成在 @Category 中指定的类别的子类别列表。 在运行时,会使用用户为同名报表参数选择的值来填充该值。

  6. 选择“确定”

接下来,设置第二个参数的属性,以便在运行时使用该数据集填充其可用值。

设置第二个参数的可用值

  1. 在“报表数据”窗格的“参数”文件夹中,右键单击第一个参数,然后选择“参数属性”。

  2. “名称” 中,确保参数名称准确无误。

  3. 选择“可用值”

  4. 选择“从查询中获取值”。

  5. 在“数据集”列表中,选择在前面过程中创建的数据集的名称。

  6. 在“值”字段中,选择提供参数值的字段的名称。

  7. 在“标签”字段中,选择提供参数标签的字段的名称。

  8. 选择“确定”

测试级联参数

  1. 选择“运行”。

  2. 从第一个独立参数的列表中,选择一个值。

    报表处理器运行下一个参数的数据集查询,并向该参数传递为第一个参数选择的值。 使用基于第一个参数值的可用值来填充第二个参数的列表。

  3. 从第二个依赖参数的列表中,选择一个值。

    在选择最后一个参数之后,不会自动运行报表,这样,便可以更改自己的选择。

  4. 选择“查看报表”。 报表会根据选择的参数来更新显示内容。