• 發行項

使用 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。其值可能是：

  • Full：顯示完整的工具列。

  • Navigation：只在工具列中顯示分頁。

  • None：不顯示工具列。

HeaderArea

控制報表檢視器 Web 組件的標頭顯示。預設值是 Full。其值可能是：

  • Full：顯示完整的標頭。

  • BreadCrumbsOnly：只在標頭中顯示蹤跡導覽，以通知使用者他們在應用程式中的所在位置。

  • None：不顯示標頭。

DocMapAreaWidth

控制參數區在報表檢視器 Web 組件中的顯示寬度 (以像素為單位)。預設值與報表檢視器 Web 組件的預設值相同。其值必須為非負整數。

AsyncRender

控制是否要以非同步方式轉譯報表。預設值為 true，會指定以非同步方式呈現報告。此值必須是 true 或 false 的布林值。

ParamMode

控制報表檢視器 Web 組件的參數提示區在整頁模式下的顯示方式。有效的值為：

  • Full：顯示參數提示區。

  • Collapsed：摺疊參數提示區。

  • Hidden：隱藏參數提示區。

預設值為 Full。

DocMapMode

控制報表檢視器 Web 組件的文件引導模式區在整頁模式下的顯示方式。有效的值為：

  • Full：顯示文件引導模式區。

  • Collapsed：摺疊文件引導模式區。

  • Hidden：隱藏文件引導模式區。

預設值為 Full。

DockToolBar

控制要將報表檢視器 Web 組件的工具列停駐在頂端或底部。有效值為 Top 和 Bottom。預設值為 Top。

ToolBarItemsDisplayMode

控制所要顯示的工具列項目。此為位元列舉值。若要包含工具列項目，請將項目值加入總計值。例如，若無 [動作] 功能表，請使用 rv:ToolBarItemsDisplayMode=63 (或 0x3F)，亦時 1+2+4+8+16+32；若只有 [動作] 功能表的項目，請使用 rv:ToolBarItemsDisplayMode=960 (or 0x3C0)。有效的值為：

  1. 1 (0x1)：[上一頁] 按鈕

  2. 2 (0x2)：文字搜尋控制項

  3. 4 (0x4)：頁面導覽控制項

  4. 8 (0x8)：[重新整理] 按鈕

  5. 16 (0x10)：[縮放] 清單方塊

  6. 32 (0x20)：[Atom 摘要] 按鈕

  7. 64 (0x40)：[動作] 中的 [列印] 功能表選項

  8. 128 (0x80)：[動作] 中的 A[匯出] 子功能表

  9. 256 (0x100)：[動作] 中的 [用報表產生器開啟] 功能表選項

  10. 512 (0x200)：[動作] 中的 [訂閱] 功能表選項

預設值為 -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

請參閱

參考

在 URL 中使用參數前置字元

其他資源

URL 存取