通过

URL 访问参数参考

  • 项目

可以使用以下参数作为 URL 的一部分来配置 SQL Server 2016 (13.x) Reporting Services 或更高版本 (SSRS) 报表的外观。 本节列出了最常用的参数。 参数是区分大小写的，并且如果将其定向到报表服务器，则以参数前缀 rs: 开头，如果定向到 HTML 查看器，则以参数前缀 rc: 开头 。 您也可以指定特定于设备或呈现扩展插件的参数。 有关特定于设备的参数的详细信息，请参阅在 URL 中指定设备信息设置。

重要

对于 SharePoint 模式报表服务器来说，非常重要的一点是，URL 包括 _vti_bin 代理语法，以便通过 SharePoint 和 Reporting Services HTTP 代理来路由请求。 该代理会向 HTTP 请求中添加上下文，该上下文是确保为 SharePoint 模式报表服务器正确执行报表所必需的内容。 有关示例，请参阅使用 URL 访问来访问 Report Server 项。

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

HTML 查看器命令 (rc:)

  • HTML 查看器命令用于指向 HTML 查看器且以 rc: 为前缀 ：

  • Toolbar：显示或隐藏工具栏。 如果此参数的值为 false，将忽略所有剩余的选项。 如果您忽略此参数，则自动为支持工具栏的呈现格式显示此工具栏。 此参数的默认值为 true。

    重要

    rc:Toolbar=false 不适用于 URL 访问字符串，该字符串使用 IP 地址（而非域名）定位驻留在 SharePoint 站点上的报表 。

  • 参数：显示或隐藏工具栏的参数区域。 如果将此参数设置为 true，将显示工具栏的参数区域。 如果此参数设置为 false，则不显示参数区域，用户也无法显示参数区域 。 如果此参数设置为 Collapsed 值，则不会显示参数区域，但用户可以对参数区域进行切换。 此参数的默认值为 true。

    例如，在本机模式下：

    https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

    例如，在 SharePoint 模式下：

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed

  • Zoom：设置报表缩放值，缩放值以整数百分比或字符串常量表示。 标准字符串值包括 Page Width 和 Whole Page。 早于 Internet Explorer 5.0 的 Internet Explorer 版本和所有非 Microsoft 浏览器忽略此参数。 此参数的默认值为 100。

    例如，在本机模式下：

    https://myrshost/reportserver?/Sales&rc:Zoom=Page Width

    例如，在 SharePoint 模式下：

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page Width

  • Section：设置将显示报表中的哪一页。 对于任何设置为大于报表页数的值，都将显示最后一页。 对于任何小于 0 的值，都将显示报表的第 1 页 。 此参数的默认值为 1。

    例如在本机模式中，将显示报表的第 2 页：

    https://myrshost/reportserver?/Sales&rc:Section=2

    例如在 SharePoint 模式中，将显示报表的第 2 页：

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2

  • FindString：在报表中搜索一组特定的文本并突出显示该文本。

    重要

    除非你在 URL 访问字符串中包含 rc:Toolbar=false，否则 rc:FindString 不起作用 。

    例如，在本机模式下：

    https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

    例如，在 SharePoint 模式下：

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

  • StartFind：指定要搜索的最后部分。 此参数的默认值为报表的最后一页。

    例如在本机模式中，会在“产品目录”示例报表的第 1 页到第 5 页之间搜索第一条“Mountain-400”文本：

    https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400

  • EndFind：设置要搜索的最后一页的页码。 例如，值 5 指示要搜索的最后一页为报表的第 5 页。 默认值为当前页的页码。 请将此参数与 StartFind 参数一起使用。 请参阅前面的示例。

  • FallbackPage：设置在搜索或文档结构图选择失败的情况下显示的页码。 默认值为当前页的页码。

  • GetImage：为 HTML 查看器用户界面获取一个特定的图标。

  • Icon：获取特定呈现扩展插件的图标。

  • Stylesheet：指定要应用于 HTML 查看器的样式表。

  • 设备信息设置：以 rc:tag=value 形式指定设备信息设置，其中，tag 是特定于当前使用的呈现扩展插件的设备信息设置的名称。 （请参阅 Format 参数的说明。）例如，可以使用 IMAGE 呈现扩展插件的 OutputFormat 设备信息设置，向 JPEG 图像呈现报表，方法是在 URL 访问字符串中使用以下参数：...&rs:Format=IMAGE&rc:OutputFormat=JPEG。 有关所有扩展插件特定的设备信息设置的详细信息，请参阅呈现扩展插件的设备信息设置 (Reporting Services)。

报表服务器命令 (rs:)

报表服务器命令以 rs: 为前缀，用于指向报表服务器：

  • 命令：根据目录项的类型，对其执行操作。 默认值由在 URL 访问字符串中引用的目录项的类型确定。 有效值是：

    • ListChildren 和 GetChildren：显示文件夹的内容。 文件夹项显示在一般项导航页内。

      例如，在本机模式下：

      https://myrshost/reportserver?/Sales&rs:Command=GetChildren

      例如，在本机模式下的命名实例：

      https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

      例如，在 SharePoint 模式下：

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren

    • Render：报表呈现在浏览器中，可供查看。

      例如，在本机模式下：

      https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

      例如，在 SharePoint 模式下：

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render

    • GetSharedDatasetDefinition：显示与共享数据集关联的 XML 定义。 共享数据集属性（包括查询、数据集参数、默认值、数据集筛选器以及诸如排序规则和区分大小写之类的数据选项）保存在定义中。 对共享数据集必须具有 “读取报表定义” 权限才能使用此值。

      例如，在本机模式下：

      https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition

    • GetDataSourceContents：将给定共享数据源的属性显示为 XML。 如果你的浏览器支持 XML，且如果你对于该数据源是具有 Read Contents 权限的用户并已经过身份验证，则将显示数据源定义。

      例如，在本机模式下：

      https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

      例如，在 SharePoint 模式下：

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

    • GetResourceContents：如果资源与浏览器兼容，将呈现资源并在 HTML 页面中显示资源。 否则，系统会提示你打开文件或资源或将其保存到磁盘。

      例如，在本机模式下：

      https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

      例如，在 SharePoint 模式下：

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents

    • GetComponentDefinition：显示与已发布的报表项关联的 XML 定义。 您必须对已发布的报表项具有“读取内容” 权限才能使用此值。

  • Format：指定呈现和查看报表的格式。 常用值包括：

    • HTML5

    • PPTX

    • ATOM

    • HTML4.0

    • MHTML

    • IMAGE

    • EXCEL（适用于 .xls）

    • EXCELOPENXML（适用于 .xlsx）

    • WORD（适用于 .doc）

    • WORDOPENXML（适用于 .docx）

    • CSV

    • PDF

    • XML

    默认值是 HTML5秒。 有关详细信息，请参阅使用 URL 访问导出报表。

    有关完整列表，请参阅报表服务器 rsreportserver.config 文件的 <Render> 扩展部分。 有关在何处查找文件的信息，请参阅 RsReportServer.config 配置文件。

    例如，若要直接从本机模式报表服务器获取报表的 PDF 副本：

    https://myrshost/ReportServer?/myreport&rs:Format=PDF

    例如，直接从 SharePoint 模式报表服务器获取报表的 PDF 副本：

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF

  • ParameterLanguage：提供在与浏览器语言无关的 URL 中传递的参数的语言。 默认值为浏览器语言。 该值可以为区域性值，如 en-us 或 de-de。

    例如在本机模式中，将替代浏览器语言并指定区域性值 de-DE：

    https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE

  • 快照：基于报表历史记录快照呈现报表。 有关详细信息，请参阅使用 URL 访问呈现报表历史记录快照。

    例如在本机模式中，请检索日期为 2003-04-07 且时间戳为 13:40:02 的报表历史记录快照：

    https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02

  • PersistStreams：呈现单个持久流中的报表。 图像呈现器使用此参数，通过一次传输一块的方式传输呈现的报表。 在 URL 访问字符串中使用此参数后，将相同的 URL 访问字符串用于 GetNextStream 参数而非 PersistStreams 参数可以获取持久流中的下一个块。 此 URL 命令最终返回 0 字节流，以指明持久流结束。 默认值是 false秒。

  • GetNextStream：在使用 PersistStreams 参数访问的持久流中获取下一个数据块。 有关详细信息，请参阅 PersistStreams的说明。 默认值是 false秒。

  • SessionID：指定客户端应用程序和报表服务器之间已建立的活动报表会话。 此参数的值设置为会话标识符。

    您可以将会话 ID 指定为 cookie 或 URL 的一部分。 在报表服务器已配置为不使用会话 cookie 时，没有指定会话 ID 的第一个请求将导致具有某一会话 ID 的重定向。 有关 Report Server 会话的详细信息，请参阅标识执行状态。

  • ClearSession：true 值指示报表服务器从报表会话中删除报表。 与经过身份验证的用户相关联的所有报表实例都将从报表会话中删除。 （报表实例定义为使用不同报表参数值运行多次的同一报表。）默认值是 false秒。

  • ResetSession： true 值指示报表服务器通过删除报表会话与所有报表快照的关联来重置报表会话。 默认值是 false秒。

  • ShowHideToggle：切换报表部分的显示和隐藏状态。 指定用于表示要切换的部分的正整数。

报表查看器 Web 部件命令 (rv:)

以下 SQL Server 保留的报表参数名称用于指向与 SharePoint 集成的报表查看器 Web 部件。 这些参数名称带有 rv: 前缀。 报表查看器 Web 部件也接受 rs:ParameterLanguage 参数。

  • Toolbar：控制报表查看器 Web 部件的工具栏显示。 默认值是 Full秒。 值可以是：

    • Full：显示完整的工具栏。

    • Navigation：只显示工具栏中的分页。

    • 无：不显示工具栏。

    例如，在 SharePoint 模式中，只显示工具栏中的分页：

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation

  • HeaderArea：控制报表查看器 Web 部件的标头显示。 默认值是 Full秒。 值可以是：

    • Full：显示完整的标头。

    • BreadCrumbsOnly：仅显示标头中的痕迹导航以告知用户其在应用程序中所处的位置。

    • 无：不显示标头。

    例如，在 SharePoint 模式中，只显示标头中的痕迹导航：

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly

  • DocMapAreaWidth：控制报表查看器 Web 部件中参数区域的显示宽度（以像素为单位）。 默认值与报表查看器 Web 部件中的默认值一样。 该值必须是非负整数。

  • AsyncRender：控制是否异步呈现报表。 默认值为 true，该值指定将异步呈现报表。 该值必须为布尔值 true 或 false。

  • ParamMode：控制报表查看器 Web 部件的参数提示区域在整页视图中的显示方式。 默认值是 Full秒。 有效值是：

    • Full：显示参数提示区域。

    • Collapsed：折叠参数提示区域。

    • Hidden：隐藏参数提示区域。

    例如，在 SharePoint 模式中，折叠参数提示区域：

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

  • DocMapMode：控制报表查看器 Web 部件的文档结构图区域在整页视图中的显示方式。 默认值是 Full秒。 有效值是：

    • Full：显示文档结构图区域。

    • Collapsed：折叠文档结构图区域。

    • Hidden：隐藏文档结构图区域。

  • DockToolBar：控制报表查看器 Web 部件的工具栏是停靠在顶部还是底部。 有效值为 Top 和 Bottom。 默认值是 Top秒。

    例如，在 SharePoint 模式中，将工具栏停靠在底部：

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom

  • ToolBarItemsDisplayMode：控制显示哪些工具栏项。 这是一个按位枚举值。 若要包括某一工具栏项，请将该项的值添加至总值。 例如，对于无“操作”菜单，请使用 rv:ToolBarItemsDisplayMode=63（或 0x3F），这是 1+2+4+8+16+32。 对于仅“操作”菜单项，请使用 rv:ToolBarItemsDisplayMode=960（或 0x3C0）。 默认值是 -1，这将包括所有工具栏项。 有效值是：

    • 1 (0x1) ：“后退”按钮

    • 2 (0x2) ：文本搜索控件

    • 4 (0x4) ：页面导航控件

    • 8 (0x8) ：“刷新”按钮

    • 16 (0x10) ：“缩放”列表框

    • 32 (0x20) ：“Atom 馈送”按钮

    • 64 (0x40) ：“操作”中的“打印”菜单选项

    • 128 (0x80) ：“操作”中的“导出”子菜单

    • 256 (0x100) ：“操作”中的“使用报表生成器打开”菜单选项

    • 512 (0x200) ：“操作”中的“订阅”菜单选项

    • 1024 (0x400) ：“操作”中的“新建数据警报”菜单选项

    例如，在 SharePoint 模式中，仅显示“后退”按钮、文本搜索控件、页面导航控件和“刷新”按钮 ：

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

相关内容