URL 访问 (SSRS)

  • 项目

通过 SQL Server Reporting Services (SSRS) 中报表服务器的 URL 访问，您可以通过 URL 请求将命令发送到报表服务器。 借助此功能，你可以自定义在本机模式报表服务器或 SharePoint 库中呈现报表的方式。 例如，你可能已经使用了一组特定的报表参数值查看了报表，或者可能正在查看报表中感兴趣的特定页。 可以使用预定义的 URL 访问参数来在 URL 中定义这些参数。

可以通过为呈现格式包含参数，或者为报表查看器指定外观，自定义报表服务器处理报表的方式。 然后，可以将此 URL 发送给其他用户，以便他们可以以相同的方式在浏览器中访问报表。

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

URL 访问概念

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

URL 访问语法

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

了解 URL 访问字符串的各组成部分对于有效地将命令发送到 SSRS 报表服务器至关重要。 URL 访问字符串包含以下内容：

  • https://[rswebserviceurl]：报表服务器的 Web 服务 URL。
  • ?：指示查询字符串的开头包含参数。
  • [pathinfo]：服务器上报表或项的路径。
  • [&prefix:param=value]：一个或多个具有可选前缀的参数，用于自定义报表呈现方式或行为方式。
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

语法说明

以下章节详细说明了 URL 访问字符串中使用的某些参数。 如需完整列表，请参阅 URL 访问参数参考。

rswebserviceurl

报表服务器的 Web 服务 URL。

  • 对于本机模式，它是 Reporting Services 配置管理器中配置的 Web 服务报表服务器实例 Web 服务 URL。 有关详细信息，请参阅配置报表服务器 URL（报表服务器配置管理器）。

    例如：

    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 和 Reporting Services HTTP 代理路由请求的 _vti_bin 代理语法。 该代理会向 HTTP 请求中添加某一上下文，该上下文是确保为 SharePoint 模式报表服务器正确执行报表所需要的。

pathinfo

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

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

/AdventureWorks2022/Employee_Sales_Summary_2022

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

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

&prefix:param=value

可以 URL 访问字符串中添加参数及其相应的值来自定义报表呈现方式或行为方式。 使用语法 param=value（用和号 (&) 分隔）在名称/值对中构造参数。

使用可选前缀（例如 rs: 或 rc:）以报表服务器中的特定进程为目标。

注意

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

以下示例显示本文中所述的完整 URL：

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

相关内容