URL 存取 (SSRS)

  • 發行項

在 SQL Server Reporting Services (SSRS) 中，報表伺服器的 URL 存取權可讓您透過 URL 要求，傳送命令至報表伺服器。 此功能讓您可自訂如何在原生模式報表伺服器或 SharePoint 文件庫中轉譯報表。 例如，您可能已使用特定一組報表參數值來檢視過報表，或報表中您感興趣的特定頁面。 您可以使用預先定義的網址存取參數，在網址中定義這些參數。

您可以納入轉譯格式或指定報表檢視器外觀和風格的參數，以進一步自訂報表伺服器處理報表的方式。 然後，您可以將此網址傳送給其他人，讓他們可以在瀏覽器中以相同方式存取報表。

您可利用網址存取執行的其他動作包括：

URL 存取概念

報表伺服器會處理 URL 中包含的參數，並要求傳送到報表伺服器。 報表伺服器處理網址要求的方法須視網址中包含的參數、參數前置詞以及項目類型而定。 報表伺服器網址會遵循聯合全球資訊網協會 W3C/IETF 草擬標準所提議的網址格式指導方針。 Reporting Services 網址功能與大部分的網際網路瀏覽器或是支援標準網址定址的應用程式相容。

URL 存取語法

URL 要求可包含以任何順序所列的多個參數。 您會使用 & 符號 (&) 來分隔參數，並使用等號 (=) 來分隔名稱/值對。

若要有效地將命令傳送至 SSRS 報表伺服器，則瞭解網址存取字串的不同元件便十分重要。 網址存取字串包括：

  • https://[rswebserviceurl]：報表伺服器的 Web 服務網址。
  • ?：表示包含參數的查詢字串開頭。
  • [pathinfo]：伺服器上報表或項目的路徑。
  • [&prefix:param=value]：具有選用前置詞的一個或多個參數，可自訂報表轉譯或行為。
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

語法描述

下一節會針對網址存取字串中使用的一些參數提供詳細描述。 如需完整清單，請參閱網址存取參數參考。

rswebserviceurl

報表伺服器的 Web 服務網址。

  • 若為原生模式，其為 Reporting Services 組態管理員中設定的 Web 服務報告伺服器執行個體 Web 服務 網址。 如需詳細資訊，請參閱設定網址 (報表伺服器組態管理員)。

    例如：

    https://myrshost/reportserver
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE

  • 針對 SharePoint 整合模式，其為整合 Reporting Services 之 SharePoint 網站的 Reporting Services Proxy URL。

    例如：

    https://myspsite/subsite/_vti_bin/reportserver

    提示

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

pathinfo

原生模式報表伺服器資料庫中項目的相對路徑名稱，或 SharePoint 目錄中項目的完整 URL。

目錄項目的路徑。 針對原生模式，其為報表伺服器資料庫中項目的相對路徑名稱，以斜線 (/) 開頭。 例如：

/AdventureWorks2022/Employee_Sales_Summary_2022

若為 SharePoint 整合模式，其為 SharePoint 文件庫中項目的完整 URL，包括項目延伸模組。 例如：

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix:param=value

在網址存取字串中，您會新增參數及其對應的值，以自訂報表轉譯或行為。 您可以使用以 & 符號 (&) 分隔的語法 param=value，在名稱/值對中建構參數。

使用選用前置詞，例如 rs: 或 rc:，以報表伺服器內的特定進程為目標。

注意

如果未包括網址存取參數的前置詞，報表伺服器會以報表參數來處理參數。 報表參數不使用參數前置詞，且有區分大小寫。

下列範例會顯示本文中所述的完整網址：

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

相關內容