Megosztás a következőn keresztül:


URL-hozzáférés (SSRS)

A jelentéskészítő kiszolgáló URL-hozzáférése az SQL Server Reporting Servicesben (SSRS) lehetővé teszi, hogy URL-kérésen keresztül parancsokat küldjön a jelentéskészítő kiszolgálónak. Ez a funkció lehetővé teszi a jelentések natív módú jelentéskészítő kiszolgálón vagy SharePoint-tárakban való megjelenítésének testreszabását. Előfordulhat például, hogy a jelentést egy adott jelentésparaméter-értékkészlettel tekinti meg, vagy egy adott, a jelentés szempontjából érdekes lapot tekinthet meg. Ezeket a paramétereket előre definiált URL-hozzáférési paraméterekkel határozhatja meg egy URL-címben.

Testre szabhatja, hogy a jelentéskészítő kiszolgáló hogyan dolgozza fel a jelentést a megjelenítési formátum paramétereinek vagy a jelentésmegjelenítő megjelenésének megadásával. Ezután elküldheti ezt az URL-címet másoknak, hogy a böngészőben ugyanúgy férhessenek hozzá a jelentéshez.

Az URL-hozzáféréssel elvégezhető egyéb műveletek a következők:

AZ URL-hozzáférés fogalmai

A jelentéskészítő kiszolgáló feldolgozza a jelentéskészítő kiszolgálónak küldött URL-kérelmekben szereplő paramétereket. Az URL-kérelmek kezelését a jelentéskiszolgáló az URL-ben szereplő paraméterektől, azok előtagjaitól és az elemek típusaitól függően végzi. A jelentéskészítő kiszolgáló URL-címei megfelelnek a World Wide Web Consortium W3C/IETF közös szabványtervezete által javasolt URL-formázási irányelveknek. A Reporting Services URL-funkciója kompatibilis a legtöbb olyan internetböngészővel vagy alkalmazással, amely támogatja a szabványos URL-címzést.

URL-címhozzáférés szintaxisa

Az URL-kérelmek több paramétert is tartalmazhatnak, amelyek bármilyen sorrendben szerepelnek. A paramétereket az ampersand () és a név/érték párok egyenlő jellel (&=) választja el egymástól.

Az URL-hozzáférési sztring különböző összetevőinek megértése elengedhetetlen az SSRS jelentéskészítő kiszolgálóra irányuló parancsok hatékony küldéséhez. Az URL-hozzáférési sztring a következőket tartalmazza:

  • https://[rswebserviceurl]: A jelentéskészítő kiszolgáló webszolgáltatás-URL-címe.
  • ?: A paramétereket tartalmazó lekérdezési sztring kezdetét jelzi.
  • [pathinfo]: A kiszolgálón található jelentés vagy elem elérési útja.
  • [&prefix:param=value]: Egy vagy több paraméter választható előtagokkal, amelyek testre szabják a jelentés renderelését vagy viselkedését.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Szintaxis leírása

Az alábbi szakasz részletes leírást nyújt az URL-hozzáférési sztringben használt paraméterekről. A teljes listát az URL-hozzáférési paraméter hivatkozásában találja.

rswebserviceurl

A jelentéskészítő kiszolgáló webszolgáltatás-URL-címe.

  • Natív mód esetén ez a Jelentéskészítő kiszolgáló webszolgáltatás-példányának URL-címe, amely a Reporting Services Configuration Managerben van konfigurálva. További információ: Jelentéskészítő kiszolgáló URL-címeinek konfigurálása (Jelentéskészítő kiszolgáló konfigurációkezelője).

    Például:

    https://myrshost/reportserver
    https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE
    
  • Integrált SharePoint-mód esetén ez a Reporting Services-proxy URL-címe a Reporting Services szolgáltatással integrált SharePoint-webhelyen.

    Például:

    https://myspsite/subsite/_vti_bin/reportserver
    

    Jótanács

    Fontos, hogy az URL-cím tartalmazza a _vti_bin kérelem SharePointon és a Reporting Services HTTP-proxyn keresztüli átirányításának proxyszintaxisát. A proxy hozzáad néhány környezetet a HTTP-kéréshez, amely szükséges a jelentés SharePoint-módú jelentéskiszolgálókhoz való megfelelő végrehajtásához.

pathinfo

Az elem relatív elérési útja a natív módú jelentéskészítő kiszolgáló adatbázisában, vagy egy SharePoint-katalógusban található elem teljes URL-címe.

A katalóguselem elérési útja. Natív mód esetén ez a jelentéskészítő kiszolgáló adatbázisában lévő elem relatív elérési útja, perjellel (/perjellel) kezdődően. Például:

/AdventureWorks2022/Employee_Sales_Summary_2022

Integrált SharePoint-mód esetén ez a SharePoint-tárban található elem teljes URL-címe, beleértve az elembővítményt is. Például:

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

&előtag:param=érték

Egy URL-hozzáférési sztringben paramétereket és azok megfelelő értékeit adja hozzá a jelentés renderelésének vagy viselkedésének testreszabásához. A paramétereket név-érték párokban az ampersand (param=value) által elválasztott szintaxissal &hozhatja létre.

Használjon választható előtagokat, például rs: vagy rc: a riportkiszolgálón belüli konkrét folyamatokhoz.

Megjegyzés:

Ha nem szerepel egy URL-hozzáférési paraméter előtagja, a paramétert a jelentéskészítő kiszolgáló dolgozza fel jelentésparaméterként. A jelentésparaméterek nem használnak paraméterelőtagot, és megkülönböztetik a kis- és nagybetűket.

Az alábbi példa a cikkben ismertetett teljes URL-címet mutatja be:

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