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=CollapsedSharePoint 模式： https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Parameters |
False |
隐藏参数区域，用户无法显示此区域。 |
Parameters |
Collapsed |
隐藏参数区域，用户可以切换来查看。 示例： 本机模式： https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint 模式： https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Zoom |
Page Width |
设置报表缩放来适应页面宽度。 示例： 本机模式： https://myrshost/reportserver?/Sales&rc:Zoom=Page%20WidthSharePoint 模式： 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=2SharePoint 模式： 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-400SharePoint 模式： 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=listChildrenSharePoint 模式： https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren |
Command |
Render |
报表呈现在浏览器中，可供查看。 示例： 本机模式： https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint 模式： 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=GetDataSourceContentsSharePoint 模式： https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents |
Command |
GetResourceContents |
如果资源与浏览器兼容，将呈现资源并在 HTML 页面中显示资源。 否则，可以选择打开文件或资源或将其保存到磁盘。 示例： 本机模式： https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint 模式： https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
Command |
GetComponentDefinition |
显示与已发布的报表项关联的 XML 定义。 您必须对已发布的报表项具有“读取内容” 权限才能使用此值。 |
Format |
HTML5PPTXATOMHTML4.0MHTMLIMAGEEXCEL（适用于 .xls）EXCELOPENXML（适用于 .xlsx）WORD（适用于 .doc）WORDOPENXML（适用于 .docx）CSVPDFXML |
指定呈现和查看报表的格式。 默认值是 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 |
truefalse |
呈现单个持久流中的报表。 图像呈现器使用此参数，通过一次传输一块的方式传输呈现的报表。 在 URL 访问字符串中使用此参数后，将相同的 URL 访问字符串用于 GetNextStream 参数而非 PersistStreams 参数，可以获取持久流中的下一个块。 此 URL 命令最终返回 0 字节流，以指明持久流结束。 默认值是 false秒。 |
GetNextStream |
truefalse |
在使用 PersistStreams 参数访问的持久流中获取下一个数据块。 有关更多信息，请参见 PersistStreams 命令说明。 默认值是 false。 |
SessionID |
指定客户端应用程序和报表服务器之间已建立的活动报表会话。 此参数的值设置为会话标识符。 您可以将会话 ID 指定为 cookie 或 URL 的一部分。 将报表服务器配置为不使用会话 cookie 时，没有指定会话 ID 的第一个请求将导致具有会话 ID 的重定向。 有关 Report Server 会话的详细信息，请参阅标识执行状态。 |
|
ClearSession |
truefalse |
从报告会话中删除与经过身份验证的用户关联的所有报告实例。 报表实例定义为使用不同报表参数值运行多次的同一报表。 默认值是 false。 有效值为 true 和 false。 |
ResetSession |
truefalse |
删除报表会话与所有报表快照的关联来重置报表会话。 默认值是 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 |
truefalse |
控制是否异步呈现报表。 默认值为 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 |