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:Toolbar false = 不適用於使用 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 Width 和 Whole 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 存取字串中所參考目錄項目的類型。 有效值為:ListChildren 和 GetChildren 顯示資料夾的內容。 資料夾項目會顯示在一般項目導覽頁中。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 已發行報表項目的許可權,才能使用此值。 |
|
格式 | 指定要轉譯報表的格式。 常見的值包括 ATOM 、HTML4.0 、、、MHTML 、EXCEL IMAGE 、WORD 、PDF CSV 、 XML 。 預設值是 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-us 或 de-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 | 控制報表查看器網頁元件的工具列是否停駐在頂端或底部。 有效值為 Top 和 Bottom 。 預設值是 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 |