URL 访问参数参考

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

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

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

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

HTML 查看器命令 (rc:)

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

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

示例:https://myrshost/reportserver?/Sales&rc:Toolbar=True

注意:如果忽略此参数,则对于支持该工具栏的呈现格式,将自动显示该工具栏。
Toolbar False 隐藏工具箱。 如果此参数的值为 false,将忽略所有剩余的选项。

示例:https://myrshost/reportserver?/Sales&rc:Toolbar=False
Parameters True 显示工具栏的参数区域。 默认值为 true。

示例:https://myrshost/reportserver?/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:FindString,否则 rc:Toolbar=false 不起作用。

示例:

原生模式: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 查看器的样式表。
设备信息设置 以 rc:tag=value 形式指定设备信息设置,其中,tag 是特定于呈现扩展插件的设备信息设置的名称。 有关更多信息,请参见 Format 命令说明。

可以使用 IMAGE 呈现扩展插件的 OutputFormat 设备信息设置,向 JPEG 图像呈现报表,方法是在 URL 访问字符串中使用以下参数:...&rs:Format=IMAGE&rc:OutputFormat=JPEG。 有关所有扩展插件特定的设备信息设置的详细信息,请参阅呈现扩展插件的设备信息设置 (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 的重定向。 有关报表服务器会话的更多信息,请参阅识别执行状态。
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