在 URL 内传递报表参数
在报表 URL 中包含报表参数,可以将其传递到 SQL Server Reporting Services (SSRS) 报表服务器。 所有查询参数都可具有对应的报表参数。 通过传递相应报表参数将查询参数传递给报表。 有关详细信息,请参阅在关系查询设计器中生成查询(报表生成器和 SSRS)。
基本参数语法
- 报表参数区分大小写。
- 对于特殊字符:
- 将 URL 字符串中的任何空格字符替换为字符
%20
。 - 将 URL 的参数部分中的空格字符替换为加号字符
+
。 - 将字符串的任何部分中的分号将被替换为字符
%3A
。
- 将 URL 字符串中的任何空格字符替换为字符
- 浏览器通常自动处理 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
- SSRS SharePoint 模式服务器的示例:
- 传递参数的 null 值。
- 语法:
parameter:isnull=true
- 示例:
SalesOrderNumber:isnull=true
- 语法:
- 传递布尔值。 可能的值为
0
(代表 False)和1
(代表 True)。- 示例:
https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
- 示例:
- 传递浮点值。 包含服务器区域设置的小数分隔符。