使用 URL 存取參數
您可以使用在 URL 中使用下列參數,藉此設定報告的外觀及風格。本章節中將列出最常用的參數:參數會區分大小寫,而且如果是導向至報表伺服器,則以參數前置詞 rs: 開頭,如果是導向至 HTML 檢視器,則以 rc: 開頭。您也可以指定裝置或轉譯延伸模組特定的參數。如需有關裝置特定參數的詳細資訊,請參閱<在 URL 中指定裝置資訊設定>。
HTML 檢視器命令
下表描述前置詞為 rc:,並用於以 HTML 檢視器為目標的 URL 存取參數。
參數 |
動作 |
---|---|
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 存取字串中使用這個參數後,以 GetNextStream 參數使用相同的 URL 存取字串,而不用 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 (or 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