在 URL 内传递报表参数

在报表 URL 中包含报表参数,可以将其传递到 SQL Server Reporting Services (SSRS) 报表服务器。 所有查询参数都可具有对应的报表参数。 通过传递相应报表参数将查询参数传递给报表。 有关详细信息,请参阅在关系查询设计器中生成查询(报表生成器和 SSRS)

基本参数语法

  • 报表参数区分大小写。
  • 对于特殊字符:
    • 将 URL 字符串中的任何空格字符替换为字符 %20
    • 将 URL 的参数部分中的空格字符替换为加号字符 +
    • 将字符串的任何部分中的分号将被替换为字符 %3A
  • 浏览器通常自动处理 URL 编码,因此无需手动对字符进行编码。
  • 非常重要的一点是,URL 包括用于通过 SharePoint 和 Reporting Services HTTP 代理路由请求的 _vti_bin 代理语法。 该代理会向 HTTP 请求中添加某一上下文,该上下文是确保为 SharePoint 模式报表服务器正确执行报表所需要的。 如果不包含代理语法,则需要给参数加上前缀 rp:

示例

注意

自 SQL Server 2016 之后,不再提供 SSRS 与 SharePoint 的集成这一功能。

  • 在 URL 内传递报表参数。
    • 语法:parameter=value
  • 指定在报表中定义的两个参数。
    • SSRS SharePoint 模式服务器的示例:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008
    • SSRS 本机模式服务器的示例:https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008
  • 传递参数的 null 值。
    • 语法: parameter:isnull=true
    • 示例: SalesOrderNumber:isnull=true
  • 传递布尔值。 可能的值为 0(代表 False)和 1(代表 True)。
    • 示例: https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
  • 传递浮点值。 包含服务器区域设置的小数分隔符。