大网数据广告活动
数据库与应用安全

URL 访问参数引用

· 52CE 我爱测

可以将下列参数作为 URL 的一部分使用来配置 !INCLUDE[ssRSCurrent]报表的外观。 本节列出了最常用的参数。 参数是区分大小写的,并且如果将其定向到报表服务器,则以参数前缀 rs: 开头,如果定向到 HTML 查看器,则以参数前缀 rc: 开头。 您也可以指定特定于设备或呈现扩展插件的参数。 有关特定于设备的参数的详细信息,请参阅 在 URL 中指定设备信息设置。

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

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

有关在 URL 中包括报表参数的信息,请参阅 Pass a Report Parameter Within a URL。

本主题内容

HTML 查看器命令 (rc:)

HTML 查看器命令用于指向 HTML 查看器(例如,从报表管理器中)且以 rc: 为前缀:

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

    IMPORTANT
    =false 不适用于使用 IP 地址(而非域名)以针对驻留在 SharePoint 站点上的报表的 URL 访问字符串。

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

    例如在 Native 模式中。

    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。

    例如在 Native 模式中:

    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。

    例如在 Native 模式中,将显示报表的第 2 页:

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

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

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2  
    
  • FindString:搜索一组特定文本的报表。

    例如在 Native 模式中。

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

    例如在 SharePoint 模式中。

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:FindString=Mountain-400  
    
  • StartFind :指定要搜索的最后部分。 此参数的默认值为报表的最后一页。

    例如在 Native 模式中,会在 Product Catalog 示例报表的第 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 设备信息设置向在 URL 访问字符串中使用以下参数的 JPEG 图像呈现报表:…&rs:Format=IMAGE&rc:OutputFormat=JPEG。 有关所有扩展插件特定的设备信息设置的详细信息,请参阅呈现扩展插件的设备信息设置 (Reporting Services)。

报表服务器命令 (rs:)

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

  • Command:
    根据目录项的类型,对其执行操作。 默认值由在 URL 访问字符串中引用的目录项的类型确定。 有效值为

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

      例如在 Native 模式中。

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

      例如在 Native 模式中的命名实例。

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

      例如在 SharePoint 模式中。

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren  
      
    • Render 报表呈现在浏览器中,可供查看。

      例如在 Native 模式中:

      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 定义。 共享数据集属性(包括查询、数据集参数、默认值、数据集筛选器以及诸如排序规则和区分大小写之类的数据选项)保存在定义中。 对共享数据集必须具有 “读取报表定义” 权限才能使用此值。

      例如在 Native 模式中。

      https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition  
      
    • GetDataSourceContents 将给定共享数据源的属性显示为 XML。 如果您的浏览器支持 XML,且如果您对于该数据源是具有 Read Contents 权限的经过身份验证的用户,则将显示数据源定义。

      例如在 Native 模式中。

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

      例如在 SharePoint 模式中。

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents  
      
    • 如果资源与浏览器兼容,GetResourceContents 将呈现资源并在 HTML 页面中显示资源。 否则,系统会提示您打开文件或资源或将其保存到磁盘。

      例如在 Native 模式中。

      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

    • WORD

    • CSV

    • PDF

    • XML

    默认值是 HTML5秒。 有关详细信息,请参阅 Export a Report Using URL Access。

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

    例如,若要直接从 Native 模式报表服务器获取报表的 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。

    例如在 Native 模式中,将覆盖浏览器语言并指定区域性值 de-DE:

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

    例如在 Native 模式中,请检索日期为 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 的重定向。 有关报表服务器会话的详细信息,请参阅 Identifying Execution State。

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

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

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

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

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

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

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

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

    • None:不显示工具栏。

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

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation  
    
  • HeaderArea:控制报表查看器 Web 部件的标头显示。 默认值是 Full秒。 可为以下值:

    • Full:显示完整的标头。

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

    • None:不显示标头。

    例如在 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  
    

另请参阅

URL 访问 (SSRS)
Export a Report Using URL Access

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 markingmyname)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 09/09/2015
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。