Přístup k adrese URL (SSRS)

Přístup k URL serveru sestav ve službě SQL Server Reporting Services (SSRS) umožňuje odesílat příkazy na server sestav prostřednictvím URL požadavku. Tato funkce umožňuje přizpůsobit způsob vykreslování sestav na serveru sestav v nativním režimu nebo v knihovně SharePointu. Sestavu můžete například zobrazit pomocí konkrétní sady hodnot parametrů sestavy nebo můžete zobrazit konkrétní stránku, která vás zajímá. Tyto parametry můžete definovat v adrese URL pomocí předdefinovaných parametrů přístupu k adrese URL.

Způsob, jakým server sestav zpracovává sestavu, můžete přizpůsobit tak, že zahrnete parametry pro formáty vykreslování nebo určíte vzhled a chování prohlížeče sestav. Tuto adresu URL pak můžete poslat ostatním, aby mohli k sestavě přistupovat stejným způsobem v prohlížeči.

Mezi další akce, které můžete provádět prostřednictvím přístupu k adrese URL, patří:

Koncepty přístupu k adrese URL

Server sestav zpracovává parametry obsažené v požadavcích URL na server sestav. Způsob, jakým server sestav zpracovává požadavky URL, závisí na parametrech, předponách parametrů a typech položek zahrnutých v URL. Adresy URL serveru sestav odpovídají pokynům pro formátování adres URL navrženým společným návrhem standardu W3C/IETF. Funkce adresy URL služby Reporting Services je kompatibilní s většinou internetových prohlížečů nebo aplikací, které podporují standardní adresování adres URL.

Syntaxe přístupu k adrese URL

Požadavky na adresu URL můžou obsahovat více parametrů, které jsou uvedeny v libovolném pořadí. Parametry oddělíte pomocí symbolu & () a páry název/hodnota znakem rovná se ().

Pochopení různých komponent přístupového řetězce adresy URL je nezbytné pro efektivní odesílání příkazů na server sestav SSRS. Přístupový řetězec adresy URL zahrnuje:

  • https://[rswebserviceurl]: Adresa URL webové služby serveru sestav.
  • ?: Označuje začátek řetězce dotazu, který obsahuje parametry.
  • [pathinfo]: Cesta k sestavě nebo položce na serveru.
  • [&prefix:param=value]: Jeden nebo více parametrů s volitelnými předponami, které přizpůsobí vykreslování sestavy nebo chování.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Popis syntaxe

Následující část obsahuje podrobný popis některých parametrů použitých v přístupovém řetězci adresy URL. Úplný seznam najdete v referenčních informacích k parametrům přístupu url.

rswebserviceurl

URL adresa webové služby serveru sestav.

  • V nativním režimu se jedná o adresu URL webové služby instance serveru sestav, která je nakonfigurována v nástroji Správce konfigurace Reporting Services. Další informace najdete v tématu Konfigurace adres URL serveru sestav (Správce konfigurace serveru sestav).

    Například:

    https://myrshost/reportserver
    https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE
    
  • V integrovaném režimu SharePointu se jedná o adresu URL proxy služby Reporting Services na sharepointovém webu integrovaném se službou Reporting Services.

    Například:

    https://myspsite/subsite/_vti_bin/reportserver
    

    Návod

    Je důležité, aby adresa URL obsahovala _vti_bin syntaxi proxy serveru pro směrování požadavku přes SharePoint a proxy server HTTP služby Reporting Services. Proxy server přidá do požadavku HTTP kontext, který je nutný pro zajištění správného spuštění sestavy pro servery sestav v režimu SharePoint.

Pathinfo

Relativní název cesty položky v databázi serveru sestav v nativním režimu nebo plně kvalifikovaná adresa URL položky v katalogu služby SharePoint.

Cesta k položce katalogu. V nativním režimu se jedná o relativní cestu položky v databázi serveru sestav, která začíná lomítkem (/). Například:

/AdventureWorks2022/Employee_Sales_Summary_2022

V integrovaném režimu SharePointu je to plně kvalifikovaná adresa URL položky v knihovně SharePointu, včetně rozšíření položky. Například:

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

&prefix:param=value

Do adresy URL přidáte parametry a jejich odpovídající hodnoty k přizpůsobení vykreslování sestavy nebo jejího chování. Parametry v párech name/value vytvoříte pomocí syntaxe param=valueoddělené ampersandem (&).

Použijte volitelné předpony, jako rs: nebo rc:, k cílení na konkrétní procesy v rámci serveru sestav.

Poznámka:

Pokud není zahrnuta předpona parametru přístupu url, server sestav ho zpracuje jako parametr sestavy. Parametry sestavy nepoužívají předponu parametru a rozlišují malá a velká písmena.

Následující příklad ukazuje úplnou adresu URL, jak je popsáno v tomto článku:

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