URL 访问 (SSRS)

通过 SQL Server Reporting Services (SSRS) 中报表服务器的 URL 访问,您可以通过 URL 请求将命令发送到报表服务器。 例如,您可以自定义报表在本机模式报表服务器上或 SharePoint 库中的呈现。 你可能已经使用了一组特定的报表参数值查看了报表,或者可能正在查看报表中感兴趣的特定页。 您可以使用预定义的 URL 访问参数在 URL 中封装这些信息。 您可以通过为呈现格式嵌入参数,或者为报表查看器的外观嵌入参数,进一步自定义报表服务器处理报表的方式。 然后,你可以将此 URL 直接粘贴到电子邮件或网页中,让他人在浏览器中采用相同的方式访问你的报表。

您可以通过 URL 访问执行的其他操作包括:

  • 将命令发送到 HTML 查看器,例如调整其外观

  • 列出目录文件夹的子级

  • 检索目录项的 XML 定义

  • 呈现特定的报表历史记录快照

  • 管理报表会话

有关可通过 URL 访问提供的命令和设置的完整列表,请参阅 URL 访问参数引用

URL 访问概念

对 Report Server 的 URL 请求包含 Report Server 处理的参数。 报表服务器处理 URL 请求的方式取决于在 URL 中包括的参数、参数前缀和项的类型。 报表服务器 URL 符合万维网联合会 W3C/IETF 标准草案建议的 URL 格式准则。 Reporting Services URL 功能与支持标准 URL 寻址的大多数 Internet 浏览器或应用程序兼容。

URL 访问语法

URL 请求可包含以任何顺序列出的多个参数。 参数通过“与”符号 (&) 分隔开,名称/值对通过等号 (=) 分隔开。

  
rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]  
  

语法说明

rswebserviceurl
报表服务器的 Web 服务 URL。 对于本机模式,它是在 Reporting Services 配置管理器中配置的 Report Server 实例的 Web 服务 URL(请参阅配置 Report Server URL( Report Server 配置管理器))。 例如:

https://myrshost/reportserver  
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE  

对于 SharePoint 集成模式,它是位于与 Reporting Services 集成的 SharePoint 站点处的 Reporting Services 代理的 URL。 例如:

https://myspsite/subsite/_vti_bin/reportserver  

提示

非常重要的一点是,URL 包括用于通过 SharePoint 和 _vti_bin HTTP 代理路由请求的 Reporting Services 代理语法。 该代理会向 HTTP 请求中添加某一上下文,该上下文是确保为 SharePoint 模式报表服务器正确执行报表所需要的。

pathinfo
本机模式报表服务器数据库中该项的相对路径名称,或者是 SharePoint 目录中该项的完全限定 URL。

目录项的路径。 对于本机模式,它是 Report Server 数据库中该项的相对路径,以斜杠 (/) 开头。 例如:

/AdventureWorks2022/Employee_Sales_Summary_2022  

对于 SharePoint 集成模式,它是 SharePoint 库中的项的完全限定 URL,包括项扩展名。 例如:

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl  

&
用于分隔 URL 访问参数的名称和值对。

prefix
可选。 访问在报表服务器内正运行的特定进程的 URL 访问参数的前缀(例如 rs:rc:)。

注意

如果不包括用于某一 URL 访问参数的前缀,则该参数将被报表服务器作为报表参数处理。 报表参数不使用参数前缀并且区分大小写。

param
参数名称。

value
与要使用的参数值相对应的 URL 文本。

注意: 有关可用 URL 访问参数的列表,请参阅 URL 访问参数参考。 有关在 URL 中传递报表参数的示例,请参阅在 URL 中传递报表参数

任务说明 链接
访问报表服务器项,例如报表、共享数据源和资源。 使用 URL 访问来访问 Report Server 项
将报表参数传递到报表。 在 URL 内传递报表参数
设置 URL 访问字符串中报表参数的区域设置,它定义日期、货币等特定于区域设置的解释。 设置 URL 中的报表语言参数
发送自定义报表呈现方式的报表扩展插件特定的设置。 在 URL 中指定设备信息设置
将报表直接导出到某一文件格式而无需在浏览器中查看它。 使用 URL 访问导出报表
打开报表并且直接导航到某一字符串位置。 使用 URL 访问搜索报表
呈现特定的报表历史记录快照。 使用 URL 访问呈现报表历史记录快照