URL 存取參數參考

  • 發行項

您可以在 URL 中使用下列參數，來設定 SQL Server Reporting Services (SSRS) 2016 (13.x) 或更高版本的報表外觀和風格。 本文會介紹最常用的參數。

這些參數不區分大小寫。 它們需要使用前置詞：

  • rs:：以報表伺服器為目標。
  • rc:：以 HTML 檢視器為目標。
  • rv:：以報表檢視器網頁組件為目標。

您也可以指定裝置或轉譯延伸模組特定的參數。 如需裝置特定參數的詳細資訊，請參閱在 URL 中指定裝置資訊設定。

重要

對 SharePoint 模式報表伺服器而言，URL 要包含 _vti_bin Proxy 語法，才能透過 SharePoint 和 Reporting Services HTTP Proxy 路由傳送要求。 此 Proxy 會將確保正確執行 SharePoint 模式報表伺服器報表所需的內容來新增至 HTTP 要求。 如需範例，請參閱使用 URL 存取權存取報表伺服器項目。

SQL Server 2016 後即不再提供 Reporting Services 與 SharePoint 的整合。

HTML 檢視器命令 (rc:)

使用前置詞 rc: 來以 HTML 檢視器為目標。

Command 參數 描述
Toolbar True 顯示工具列。 預設值為 true。

注意：如果您省略這個參數，工具列就會自動顯示以轉譯支援該參數的格式。
Toolbar False 隱藏工具列。 如果此參數的值為 false，則會忽略所有剩餘的選項。
Toolbar Navigation 只在工具列中顯示分頁。
Parameters True 顯示工具列的參數區域。 預設值為 true。

範例：

原生模式：https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 模式：https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/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> 在報表中搜尋一組特定的文字，並醒目提示該文字。 注意：rc:FindString 無法運作，除非您在 URL 存取字串中包含 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 裝置資訊設定，使用下列 URL 存取字串的參數將報表轉譯為 JPEG 影像：...&rs:Format=IMAGE&rc:OutputFormat=JPEG。 如需所有延伸模組特定裝置資訊設定的詳細資訊，請參閱轉譯延伸模組的裝置資訊設定 (Reporting Services)。

報表伺服器命令 (rs:)

使用前置詞 rs: 來以報表伺服器為目標。

Command 參數 描述
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，且您是具有資料來源 Read Contents 權限的已驗證使用者，則會顯示資料來源定義。

例如：

原生模式：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 存取匯出報表。 如需完整清單，請參閱報表伺服器 rsreportserver.config 檔案的 \<Render> 轉譯延伸模組區段。 如需詳細資訊，請參閱 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 存取字串中使用這個參數後，以 GetNextStream 參數使用相同的 URL 存取字串，而不用 PersistStreams 參數，以取得永續性資料流中的下一個區塊。 這個 URL 命令最後會傳回 0 個位元組資料流，表示永續性資料流結尾。 預設值為 false。
GetNextStream true
false		 取得使用 PersistStreams 參數存取的永續性資料流中下一個資料區塊。 如需詳細資訊，請參閱 PersistStreams 命令說明。 預設值為 false。
SessionID 指定用戶端應用程式和報表伺服器之間已建立的使用中報表工作階段。 此參數的值是設定為工作階段識別碼。

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

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

使用前置詞 rv: 以與 SharePoint 整合的報表檢視器網頁組件為目標。 報表檢視器網頁組件也接受 rs:ParameterLanguage 參數。

Command 參數 描述
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 控制參數區在報表檢視器網頁組件中的顯示寬度 (以像素為單位)。 預設值與報表檢視器網頁組件的預設值相同。 其值必須為非負整數。
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) [動作] 中的 [用 Report Builder 開啟] 功能表選項
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

相關內容