URL-Zugriff (SSRS)

  • Artikel

Durch den URL-Zugriff des Berichtsservers in SQL Server Reporting Services (SSRS) können Sie Befehle an den Berichtsserver über eine URL-Anforderung senden. Mit dieser Funktion können Sie anpassen, wie Sie Berichte auf einem Berichtsserver im nativen Modus oder in einer SharePoint-Bibliothek rendern. Zum Beispiel, haben Sie den Bericht unter Verwendung bestimmter Berichtsparameterwerte angezeigt oder eine bestimmte Berichtsseite gelesen, die für Sie von Interesse war. Sie können diese Parameter in einer URL definieren, indem Sie vordefinierte URL-Zugriffsparameter verwenden.

Außerdem können Sie die Berichtsverarbeitung auf dem Berichtsserver anpassen, indem Sie Parameter für Renderingformate oder für das Erscheinungsbild des Report Viewer einschließen. Sie können diese URL dann an andere Personen senden, damit sie im Browser auf die gleiche Weise auf Ihren Bericht zugreifen können.

Weitere Aktionen, die über den URL-Zugriff ausgeführt werden können, beinhalten:

URL-Zugriffskonzepte

URL-Anforderungen an den Berichtsserver enthalten Parameter, die vom Berichtsserver verarbeitet werden. Wie URL-Anforderungen vom Berichtsserver behandelt werden, hängt von den Parametern, den Parameterpräfixen sowie den Elementtypen ab, die in der URL enthalten sind. Berichtsserver-URLs erfüllen die URL-Formatierungsrichtlinien, wie sie vom gemeinsamen Entwurfsstandard des World Wide Web Consortium W3C/IETF vorgeschlagen wurden. Reporting Services-URL-Funktionen sind kompatibel mit den meisten Internetbrowsern oder Anwendungen, die Standard-URL-Adressen unterstützen.

URL-Zugriffssyntax

URL-Anforderungen können mehrere Parameter enthalten, die in beliebiger Reihenfolge aufgelistet werden. Sie trennen die Parameter durch das kaufmännische Und-Zeichen (&) und die Name/Wert-Paare durch das Gleichheitszeichen (=).

Das Verstehen der verschiedenen Komponenten einer URL-Zugriffszeichenfolge ist für das effektive Senden von Befehlen an einen SSRS-Berichtsserver unerlässlich. Die URL-Zugriffszeichenfolge umfasst:

  • https://[rswebserviceurl]: Die Webdienst-URL des Berichtsservers.
  • ?: Gibt den Anfang der Abfragezeichenfolge an, die Parameter enthält.
  • [pathinfo]: Der Pfad zum Bericht oder Artikel auf dem Server.
  • [&prefix:param=value]: Mindestens ein Parameter mit optionalen Präfixen, die das Rendern von Berichten oder Verhalten anpassen.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Syntaxbeschreibung

Der folgende Abschnitt enthält eine detaillierte Beschreibung einiger Parameter, die in der URL-Zugriffszeichenfolge verwendet werden. Eine vollständige Liste finden Sie unter URL-Zugriffsparameter-Referenz.

rswebserviceurl

Die Webdienst-URL des Berichtsservers.

  • Für den nativen Modus ist dies die Webdienst-URL der Web-Servicebericht-Serverinstanz, die in Konfigurations-Manager für Reporting Services konfiguriert ist. Weitere Informationen Sie unter Konfigurieren von Berichtsserver-URLs (Berichtsserver-Konfigurations-Manager).

    Zum Beispiel:

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

  • Im integrierten SharePoint-Modus ist dies die URL des Reporting Services-Proxy für eine SharePoint-Website, die in Reporting Services integriert ist.

    Zum Beispiel:

    https://myspsite/subsite/_vti_bin/reportserver

    Tipp

    Es ist wichtig, dass die URL die _vti_bin -Proxysyntax zur Weiterleitung der Anforderung über SharePoint sowie den Reporting Services -HTTP-Proxy enthält. Durch den Proxy wird der HTTP-Anforderung Kontext hinzugefügt. Dieser ist erforderlich, damit der Bericht auf Berichtsservern im SharePoint-Modus ordnungsgemäß ausgeführt wird.

pathinfo

Der relative Pfadname des Elements in der Berichtsserver-Datenbank im einheitlichen Modus oder die vollqualifizierte URL des Elements in einem SharePoint-Katalog.

Der Pfad des Katalogelements. Im einheitlichen Modus ist dies der relative Pfad des Elements in der Berichtsserver-Datenbank, der mit einem Schrägstrich (/) beginnt. Zum Beispiel:

/AdventureWorks2022/Employee_Sales_Summary_2022

Im integrierten SharePoint-Modus ist dies die vollqualifizierte URL des Elements in der SharePoint-Bibliothek, einschließlich der Elementerweiterung. Zum Beispiel:

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

&prefix:param=value

In einer URL-Zugriffszeichenfolge fügen Sie Parameter und die entsprechenden Werte hinzu, um das Rendern von Berichten oder Verhalten anzupassen. Sie erstellen Parameter in Name/Wert-Paaren mithilfe der Syntax param=value, getrennt durch ein kaufmännisches Und-Zeichen (&).

Verwenden Sie optionale Präfixe wie rs: oder rc:, um bestimmte Prozesse innerhalb des Berichtsservers anzusprechen.

Hinweis

Wenn das Präfix für einen URL-Zugriffsparameter nicht enthalten ist, wird der Parameter vom Berichtsserver als Berichtsparameter verarbeitet. Bei Berichtsparametern wird kein Parameterpräfix verwendet und nach Groß-/Kleinschreibung unterschieden.

Das folgende Beispiel zeigt die vollständige URL, wie in diesem Artikel beschrieben:

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

Zugehöriger Inhalt