共用方式為


URL 存取參數參考

您可以使用下列參數作為 URL 的一部分,來設定報表的外觀和風格。 本章節中將列出最常用的參數。 參數會區分大小寫,而且如果是導向至報表伺服器,則以參數前置字元 rs: 開頭,如果是導向至 HTML 檢視器,則以 rc: 開頭。 您也可以指定裝置或轉譯延伸模組特定的參數。 如需裝置特定參數的詳細資訊,請參閱 在URL中指定裝置資訊設定。

重要

請務必讓 URL 包含 _vti_bin Proxy 語法,以透過 SharePoint 和 Reporting Services HTTP Proxy 路由傳送要求。 此 Proxy 會將某些內容加入至 HTTP 要求,也就是確保針對 SharePoint 模式報表伺服器正確執行報表所需的內容。 如需範例,請參閱 使用 URL 存取存取存取報表伺服器專案。

如需在 URL 中包含報表參數和範例的相關信息,請參閱 在 URL 內傳遞報表參數。

HTML 檢視器指令 (rc:)

下表描述前面加上 rc 的 URL 存取參數: ,並用來以 HTML 查看器為目標。

參數 描述
工具列 顯示或隱藏工具列。

** 重要 ** rc:Toolbarfalse= 不適用於使用 IP 位址而非功能變數名稱的 URL 存取字串,以以 SharePoint 網站上裝載的報告為目標。
如果此參數的值是 false,則會忽略所有剩餘的選項。 如果您省略這個參數,工具列就會自動顯示以轉譯支援該參數的格式。 此參數預設值為 true

true
false
參數 顯示或隱藏工具列的參數區域。

Native 模式範例:

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed
如果您將此參數設定為 true,則會顯示工具列的參數區域。 如果您將此參數設定為 false,則不會顯示參數區域,而且無法由用戶顯示。 如果您將此參數設定為的值 Collapsed,則不會顯示參數區域,但可由使用者切換。 此參數的預設值為 true。 有效值為:

true
false
Collapsed
Zoom 將報表縮放值設定為整數百分比或字串常數。

Native 模式範例:

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width
標準字串值包括 Page WidthWhole Page。 Internet Explorer 5.0 之前的舊版 Internet Explorer 和所有非 Microsoft 瀏覽器都會忽略這個參數。 此參數的預設值為 100
區段 設定報表中要顯示的頁面。

Native 顯示報表第 2 頁的模式範例:

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

SharePoint 顯示報表第 2 頁的模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2
大於報表中頁數的任何值會顯示最後一頁。 小於 0 的任何值會顯示報表的第 1 頁。 此參數的預設值為 1
FindString 搜尋一組特定文字的報表。

Native 模式範例:

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

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400
StartFind 指定要搜尋的最後一個區段。

Native 模式範例,從第一頁開始搜尋產品類別目錄範例報表中第一次出現 「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 參數使用。 請參閱上述 StartFind 範例 預設值為目前頁面的頁碼。
FallbackPage 設定搜尋或文件引導模式選取失敗時要顯示的頁碼。 預設值為目前頁面的頁碼。
GetImage 取得 HTML 檢視器使用者介面的特定圖示。
圖示 取得特定轉譯延伸模組的圖示。
樣式表 指定要套用至 HTML 查看器的樣式表單。
裝置資訊設定 以的形式rc:tag=value指定裝置資訊設定,其中 tag 是目前使用之轉譯延伸模組特有的裝置資訊設定名稱(請參閱 Format 參數的描述)。 例如,您可以使用 IMAGE 轉譯延伸模組的 OutputFormat 裝置資訊設定,在 URL 存取字串中使用下列參數將報表轉譯為 JPEG 影像: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG。 如需所有擴充功能特定裝置資訊設定的詳細資訊,請參閱轉譯延伸模組的裝置資訊設定(Reporting Services)。

報表伺服器命令 (rs:)

下表描述前面加上 rs 的 URL 存取參數: ,並用來以報表伺服器為目標。

參數 描述
命令 根據目錄項目類型,對目錄專案執行動作。 預設值取決於 URL 存取字串中所參考目錄項目的類型。 有效值為:

ListChildrenGetChildren 顯示資料夾的內容。 資料夾項目會顯示在一般項目導覽頁中。

Native 模式範例:

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

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren
Render 轉譯指定的報表。

Native 模式範例:

http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
GetSharedDatasetDefinition 顯示與共用數據集相關聯的 XML 定義。 共用資料集屬性 (包括查詢、資料集參數、預設值、資料集篩選,以及定序和大小寫區分等資料選項) 是儲存於定義中。 您必須對共用資料集具有 [讀取報表定義] 權限,才能使用這個值。

Native 模式範例:

https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
GetDataSourceContents 將指定共用資料源的屬性顯示為 XML。 如果您的瀏覽器支援 XML,而且您是具有 Read Contents 數據源許可權的已驗證使用者,則會顯示數據源定義。

Native 模式範例:

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

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents
GetResourceContents 如果資源與瀏覽器相容,則會轉譯資源並將其顯示在 HTML 頁面中。 否則,系統會提示您開啟檔案或資源,或是將其儲存至磁碟。

Native 模式範例:

http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint 模式範例:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
GetComponentDefinition 顯示與已發行報表項目相關聯的 XML 定義。 您必須擁有 Read Contents 已發行報表項目的許可權,才能使用此值。
格式 指定要轉譯報表的格式。 常見的值包括 ATOMHTML4.0、、、MHTMLEXCELIMAGEWORDPDFCSVXML。 預設值是 HTML4.0。 如需詳細資訊,請參閱 Export a Report Using URL Access

例如,直接從 Native 模式報表伺服器取得報表的 PDF 複本。

http://myrshost/ReportServer?/myreport&rs:Format=PDF

例如,在模式中 SharePoint

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage 提供與瀏覽器語言無關之 URL 中傳遞之參數的語言。 預設值是瀏覽器語言。 此值可以是文化特性值,例如 en-usde-de.

例如,在模式中 Native ,若要覆寫瀏覽器語言,並指定de-DE的文化特性值。

http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
快照式 根據報表記錄快照集轉譯報表。 如需詳細資訊,請參閱 使用 URL 存取轉譯報表記錄快照集。

例如,在模式中 Native ,擷取日期為 2003-04-07 且時間戳為 13:40:02 的報表記錄快照集。

http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams 在單一保存數據流中轉譯報表。 這個參數是由影像轉譯器用來傳輸轉譯的報表,一次一個區塊。 在 URL 存取字串中使用這個參數後,以 GetNextStream 參數使用相同的 URL 存取字串,而不用 PersistStreams 參數,以取得永續性資料流中的下一個區塊。 此 URL 命令最終會傳回 0 位元組資料流,以指出保存資料流的結尾。 預設值是 false
GetNextStream 取得使用 PersistStreams 參數存取之保存數據流中的下一個數據區塊。 如需詳細資訊,請參閱 PersistStreams的描述。 預設值是 false
SessionID 指定用戶端應用程式與報表伺服器之間已建立的作用中報表會話。 此參數的值是設定為工作階段識別碼。

您可以將工作階段識別碼指定為 Cookie 或是 URL 的一部分。 當將報表伺服器設定成不使用工作階段 Cookie 時,第一個沒有指定工作階段識別碼的要求,會導致使用某個工作階段識別碼來進行重新導向。 如需報表伺服器會話的詳細資訊,請參閱 識別執行狀態
ClearSession 的值 true 會指示報表伺服器從報表會話中移除報表。 所有和已驗證的使用者相關聯的報表執行個體,都會從報表工作階段移除。 (報表實例定義為使用相同的報表參數值多次執行。預設值為 false
ResetSession 的值 true 會指示報表伺服器移除報表會話與所有報表快照集的關聯,以重設報表會話。 預設值是 false
ShowHideToggle 切換報表區段的顯示和隱藏狀態。 指定正整數以表示要切換的區段。

報表檢視器網頁元件命令 (rv:)

下表描述 SQL Server 保留的報表參數名稱,這些名稱用來以與 SharePoint 整合的報表查看器網頁元件為目標。 這些參數名稱都使用 rv: 做為字首。 報表查看器網頁元件也接受 rs:ParameterLanguage 參數。

參數 動作
工具列 控制報表查看器網頁元件的工具列顯示。 預設值是 Full。 值可以是:

Full:顯示完整的工具列。

Navigation:只顯示工具列中的分頁。

None:不要顯示工具列。



例如,在模式中 SharePoint ,只顯示工具列中的分頁。

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
HeaderArea 控制報表查看器網頁元件的標頭顯示。 預設值是 Full。 值可以是:

Full:顯示完整的標頭。

BreadCrumbsOnly:只顯示標頭中的階層流覽,以通知使用者在應用程式中的位置。

None:不要顯示標頭。



例如,在模式中 SharePoint ,只顯示標頭中的階層流覽。

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
DocMapAreaWidth 控制報表查看器網頁元件中參數區域的顯示寬度,以像素為單位。 預設值與報表查看器網頁元件預設值相同。 其值必須為非負整數。
AsyncRender 控制報表是否以異步方式呈現。 默認值為 true,指定以異步方式轉譯報表。 值必須是 或false的布爾值true
ParamMode 控制報表查看器網頁元件的參數提示區域如何顯示在整頁檢視中。 預設值是 Full。 有效值為:

Full:顯示參數提示區域。

Collapsed:折迭參數提示區域。

Hidden:隱藏參數提示區域。

例如,在模式中 SharePoint ,若要折迭參數提示區域。

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
DocMapMode 控制報表查看器網頁元件的文件對應區域在整頁檢視中的顯示方式。 預設值是 Full。 有效值為:

Full:顯示檔案引導模式區域。

Collapsed:折疊檔對應區域。

Hidden:隱藏檔對應區域。
DockToolBar 控制報表查看器網頁元件的工具列是否停駐在頂端或底部。 有效值為 TopBottom。 預設值是 Top



例如,在模式中 SharePoint ,將工具列停駐在底部。

http://myspsite/_vti_bin/reportserver?http://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 ,只 顯示 [上一頁 ] 按鈕、文字搜尋控件、頁面導覽控件,以及 [重新 整理] 按鈕。

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

另請參閱

URL 存取 (SSRS)