URL 访问参数参考

  • 项目

可以将参数作为 URL 的一部分来配置 SQL Server 2016 (13.x) Reporting Services 或更高版本 (SSRS) 报表的外观。 本文介绍最常用的参数。

参数不区分大小写。 它们需要前缀：

  • rs:：以报表服务器为目标。
  • rc:：以 HTML 查看器为目标。
  • rv:：以报表查看器 Web 部件为目标。

您也可以指定特定于设备或呈现扩展插件的参数。 有关特定于设备的参数的详细信息，请参阅在 URL 中指定设备信息设置。

重要

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

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

HTML 查看器命令 (rc:)

使用前缀 rc: 来以 HTML 查看器为目标。

命令 参数 说明
Toolbar True 显示工具栏。 默认值为 true。

注意：如果忽略此参数，则自动为支持工具栏的呈现格式显示此工具栏。
Toolbar False 隐藏工具箱。 如果此参数的值为 false，将忽略所有剩余的选项。
Toolbar Navigation 只显示工具栏中的分页。
Parameters True 显示工具栏的参数区域。 默认值为 true。

示例：

本机模式：https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Parameters False 隐藏参数区域，用户无法显示此区域。
Parameters Collapsed 隐藏参数区域，用户可以切换来查看。

示例：

本机模式：https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width 设置报表缩放来适应页面宽度。

示例：

本机模式：https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page 设置报表缩放来适应整个页面。
Zoom <integer percentage> 将报表缩放设置为特定百分比。 默认值为 100。
Section <page number> 设置显示报表中的哪一页。 对于任何大于报表页数的值，都将显示最后一页。 对于任何小于 0 的值，都将显示报表的第 1 页。 默认值是 1秒。

示例：

本机模式：https://myrshost/reportserver?/Sales&rc:Section=2

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> 在报表中搜索一组特定的文本并突出显示该文本。 注意：除非在 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 <start page> 指定要搜索的第一节。 默认值为报表的第一页。

示例：

本机模式：https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> 设置要在搜索中使用的最后一页的页码。 默认值为当前页的页码。 将此参数与 StartFind 参数一起使用。

示例：请参阅 StartFind 示例。
FallbackPage <page number> 设置在搜索或文档结构图选择失败的情况下显示的页码。 默认值为当前页的页码。
GetImage <icon name> 为 HTML 查看器用户界面获取一个特定的图标。
Icon <icon name> 获取特定呈现扩展插件的图标。
Stylesheet <stylesheet file name> 指定要应用于 HTML 查看器的样式表。
Device Information Setting 以 rc:tag=value 形式指定设备信息设置，其中，tag 是特定于呈现扩展插件的设备信息设置的名称。 有关更多信息，请参见 Format 命令说明。

可以使用 IMAGE 呈现扩展插件的 ...&rs:Format=IMAGE&rc:OutputFormat=JPEG 设备信息设置，向 JPEG 图像呈现报表，方法是在 URL 访问字符串中使用以下参数：OutputFormat。 有关所有扩展插件特定的设备信息设置的详细信息，请参阅呈现扩展插件的设备信息设置 (Reporting Services)。

报表服务器命令 (rs:)

使用前缀 rs: 以报表服务器为目标。

命令 参数 说明
Command 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
Command Render 报表呈现在浏览器中，可供查看。

示例：

本机模式：https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition 显示与共享数据集关联的 XML 定义。 共享数据集属性保存在定义中。 这些属性包括查询、数据集参数、默认值、数据集筛选器以及诸如排序规则和区分大小写之类的数据选项。 对共享数据集必须具有 “读取报表定义” 权限才能使用此值。

示例：

本机模式：https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents 将给定共享数据源的属性显示为 XML。 如果浏览器支持 XML，并且你是经过身份验证的用户，且对于该数据源具有“读取内容”权限，则将显示数据源定义。

示例：

本机模式：https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command 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
Command GetComponentDefinition 显示与已发布的报表项关联的 XML 定义。 您必须对已发布的报表项具有“读取内容” 权限才能使用此值。
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL（适用于 .xls）
EXCELOPENXML（适用于 .xlsx）
WORD（适用于 .doc）
WORDOPENXML（适用于 .docx）
CSV
PDF
XML		 指定呈现和查看报表的格式。 默认值是 HTML5秒。 有关详细信息，请参阅使用 URL 访问导出报表。 有关完整列表，请参阅报表服务器 \<Render> 文件的 rsreportserver.config 扩展插件部分。 有关详细信息，请参阅 RsReportServer.config 配置文件。

示例：

本机模式：https://myrshost/ReportServer?/myreport&rs:Format=PDF

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us、de-DE 等 提供在与浏览器语言无关的 URL 中传递的参数语言。 默认值为浏览器语言。

示例：

本机模式：https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot 基于报表历史记录快照呈现报表。 有关详细信息，请参阅使用 URL 访问呈现报表历史记录快照。

示例：

本机模式：https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false		 呈现单个持久流中的报表。 图像呈现器使用此参数，通过一次传输一块的方式传输呈现的报表。 在 URL 访问字符串中使用此参数后，将相同的 URL 访问字符串用于 GetNextStream 参数而非 PersistStreams 参数，可以获取持久流中的下一个块。 此 URL 命令最终返回 0 字节流，以指明持久流结束。 默认值是 false秒。
GetNextStream true
false		 在使用 PersistStreams 参数访问的持久流中获取下一个数据块。 有关更多信息，请参见 PersistStreams 命令说明。 默认值是 false。
SessionID 指定客户端应用程序和报表服务器之间已建立的活动报表会话。 此参数的值设置为会话标识符。

您可以将会话 ID 指定为 cookie 或 URL 的一部分。 将报表服务器配置为不使用会话 cookie 时，没有指定会话 ID 的第一个请求将导致具有会话 ID 的重定向。 有关 Report Server 会话的详细信息，请参阅标识执行状态。
ClearSession true
false		 从报告会话中删除与经过身份验证的用户关联的所有报告实例。 报表实例定义为使用不同报表参数值运行多次的同一报表。 默认值是 false。 有效值为 true 和 false。
ResetSession true
false		 删除报表会话与所有报表快照的关联来重置报表会话。 默认值是 false。 有效值为 true 和 false。
ShowHideToggle <positive integer> 切换报表部分的显示和隐藏状态。 指定用于表示要切换的部分的正整数。

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

使用前缀 rv:，以与 SharePoint 集成的报表查看器 Web 部件为目标。 报表查看器 Web 部件也接受 rs:ParameterLanguage 参数。

命令 参数 说明
Toolbar Full 显示完整的工具栏。 默认值是 Full秒。
Toolbar Navigation 只显示工具栏中的分页。

示例：

SharePoint 模式：https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None 不显示工具栏。
HeaderArea Full 显示完整的标头。 默认值是 Full秒。
HeaderArea BreadCrumbsOnly 仅显示标头中的痕迹导航以告知用户其在应用程序中所处的位置。

示例：

SharePoint 模式：https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None 隐藏标题。
DocMapAreaWidth 控制报表查看器 Web 部件中参数区域的显示宽度（以像素为单位）。 默认值与报表查看器 Web 部件中的默认值一样。 该值必须是非负整数。
AsyncRender true
false		 控制是否异步呈现报表。 默认值为 true，该值指定将异步呈现报表。 该值必须为布尔值 true 或 false。
ParamMode Full 显示参数提示区域。 默认值是 Full秒。
Collapsed 折叠参数提示区域。

示例：

SharePoint 模式：https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden 隐藏参数提示区域。
DocMapMode Full 显示文档结构图区域。 默认值是 Full秒。
DocMapMode Collapsed 折叠文档结构图区域。
DocMapMode Hidden 隐藏文档结构图区域。
DockToolBar Top 停靠在顶部的工具栏。 默认值是 Top秒。
DockToolBar Bottom 停靠在底部的工具栏。

示例：

SharePoint 模式：https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) “后退”按钮
ToolBarItemsDisplayMode 2 (0x2) 文本搜索控件
ToolBarItemsDisplayMode 4 (0x4) 页面导航控件
ToolBarItemsDisplayMode 8 (0x8) “刷新”按钮
ToolBarItemsDisplayMode 16 (0x10) “缩放”列表框
ToolBarItemsDisplayMode 32 (0x20) “Atom 馈送”按钮
ToolBarItemsDisplayMode 64 (0x40) “操作”中的“打印”菜单选项
ToolBarItemsDisplayMode 128 (0x80) “操作”中的“导出”子菜单
ToolBarItemsDisplayMode 256 (0x100) “操作”中的“使用报表生成器打开”菜单选项
ToolBarItemsDisplayMode 512 (0x200) “操作”中的“订阅”菜单选项
ToolBarItemsDisplayMode 1024 (0x400) “操作”中的“新建数据警报”菜单选项
ToolBarItemsDisplayMode 多个值 控制显示哪些工具栏项。 此值是一个按位枚举值。 若要包括某一工具栏项，请将该项的值添加至总值。 例如，对于无“操作”菜单，请使用 rv:ToolBarItemsDisplayMode=63 （或 0x3F），这是 1+2+4+8+16+32。 仅对于“操作”菜单项，请使用 rv:ToolBarItemsDisplayMode=960（或 0x3C0）。 默认值是 -1，这将包括所有工具栏项。 有效值是：

示例：

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

相关内容