使用 URL 访问参数
可以将下列参数作为 URL 的一部分使用来配置报表的外观。本节列出了最常用的参数。参数是区分大小写的,并且如果将其定向到报表服务器,则以参数前缀 rs: 开头,如果定向到 HTML 查看器,则以参数前缀 rc: 开头。您也可以指定特定于设备或呈现扩展插件的参数。有关特定于设备的参数的详细信息,请参阅在 URL 中指定设备信息设置。
HTML 查看器命令
下表说明的 URL 访问参数带有 rc: 前缀并以 HTML 查看器为对象。
参数 |
操作 |
---|---|
Toolbar |
显示或隐藏工具栏。如果此参数的值为 false,将忽略所有剩余的选项。如果您忽略此参数,则自动为支持工具栏的呈现格式显示此工具栏。此参数的默认值为 true。
重要提示
rc:Toolbar=false 对使用 IP 地址(而非域名)来针对在 SharePoint 站点上承载的报表的 URL 访问字符串不适用。
|
Parameters |
显示或隐藏工具栏的参数区域。如果将此参数设置为 true,将显示工具栏的参数区域。如果此参数设置为 false,则不显示参数区域,用户也不能显示参数区域。如果此参数设置为 Collapsed 值,则不会显示参数区域,但最终用户可以对参数区域进行切换。此参数的默认值为 true。 |
Zoom |
设置报表缩放值,缩放值以整数百分比或字符串常量表示。标准字符串值包括 Page Width 和 Whole Page。早于 Internet Explorer 5.0 的 Internet Explorer 版本和所有非 Microsoft 浏览器忽略此参数。此参数的默认值为 100。 |
Section |
设置将显示报表中的哪一页。对于任何设置为大于报表页数的值,都将显示最后一页。对于任何小于 0 的值,都将显示报表的第 1 页。此参数的默认值为 1。 |
StartFind |
指定要搜索的最后部分。此参数的默认值为报表的最后一页。 |
EndFind |
设置要搜索的最后一页的页码。例如,值 5 指示要搜索的最后一页为报表的第 5 页。默认值为当前页的页码。请将此参数与 StartFind 参数一起使用。 |
FallbackPage |
设置在搜索或文档结构图选择失败的情况下显示的页码。默认值为当前页的页码。 |
GetImage |
获取 HTML 查看器用户界面的特定图标。 |
Icon |
获取特定呈现扩展插件的图标。 |
Stylesheet |
指定要应用于 HTML 查看器的样式表。 |
在 URL 上,您还可以传递其他参数来定向 HTML 呈现的输出。有关详细信息,请参阅 HTML 设备信息设置。
报表服务器命令
下表说明了带有 rs: 前缀的用于指向报表服务器的 URL 访问参数。
参数 |
操作 |
---|---|
Command |
指定要搜索的最后部分。此参数的默认值为报表的最后一页。 |
Format |
指定报表呈现的格式。常用值包括 HTML3.2、HTML4.0、MHTML、IMAGE、EXCEL、WORD、CSV、PDF、XML 和 NULL。有关详细信息,请参阅在 URL 中指定呈现格式。 |
ParameterLanguage |
提供在与浏览器语言无关的 URL 中传递的参数的语言。默认值为浏览器语言。该值可以为区域性值,如 en-us 或 de-de。 |
Snapshot |
基于报表历史记录快照呈现报表。有关详细信息,请参阅使用 URL 访问呈现报表历史记录快照。 |
PersistStreams |
呈现单个持久流中的报表。图像呈现器使用此参数,通过一次传输一块的方式传输呈现的报表。在 URL 访问字符串中使用此参数后,将相同的 URL 访问字符串用于 GetNextStream 参数而非 PersistStreams 参数可以获取持久流中的下一个块。此 URL 命令最终将返回 0 字节流,以指明持久流结束。默认值为 false。 |
GetNextStream |
在使用 PersistStreams 参数访问的持久流中获取下一个数据块。有关详细信息,请参阅 PersistStreams 的说明。默认值为 false。 |
报表查看器 Web 部件命令
下表介绍了 SQL Server 保留的报表参数名称,在 Reporting Services 与 Windows SharePoint Services (WSS) 3.0 或更高版本以及 Microsoft Office SharePoint Server 2007 或更高版本集成时,这些名称用于指向报表查看器 Web 部件。这些参数名称带有 rv: 前缀。报表查看器 Web 部件也接受 rs:ParameterLanguage 参数。
参数 |
操作 |
---|---|
Toolbar |
控制报表查看器 Web 部件的工具栏显示。默认值为 Full。可为以下值:
|
HeaderArea |
控制报表查看器 Web 部件的标头显示。默认值为 Full。可为以下值:
|
DocMapAreaWidth |
控制报表查看器 Web 部件中参数区域的显示宽度(以像素为单位)。默认值与报表查看器 Web 部件中的默认值一样。该值必须是非负整数。 |
AsyncRender |
控制是否异步呈现报表。默认值为 true,该值指定将异步呈现报表。该值必须为布尔值 true 或 false。 |
ParamMode |
控制报表查看器 Web 部件的参数提示区域将在整页视图中如何显示。有效值包括:
默认值为 Full。 |
DocMapMode |
控制报表查看器 Web 部件的文档映射区域将在整页视图中如何显示。有效值包括:
默认值为 Full。 |
DockToolBar |
控制报表查看器 Web 部件的工具栏是停靠到顶部还是底部。有效值为 Top 和 Bottom。默认值为 Top。 |
ToolBarItemsDisplayMode |
控制将显示哪些工具栏项。这是一个按位枚举值。若要包含某一工具栏项,请将该项的值添加到总值中。例如,对于非“操作”菜单,使用 rv:ToolBarItemsDisplayMode=63(或 0x3F),这是 1+2+4+8+16+32 得出的结果;对于仅“操作”菜单项,使用 rv:ToolBarItemsDisplayMode=960(或 0x3C0)。有效值包括:
默认值为 -1,这将包含所有工具栏项。 |
示例
下面的示例通过将 rc:Toolbar 参数值设置为 false 隐藏 HTML 查看器工具栏:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false
下面的示例传递了一个硬编码参数并隐藏了用户提供的参数的输入字段:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002
下面的示例使用 rc:Zoom 参数将报表的缩放属性设置为 Page Width:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width
下面的示例命令用于切换至报表的第 13 部分:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13