Freigeben über


URL-Zugriff (SSRS)

Der URL-Zugriff auf den Berichtsserver in SQL Server Reporting Services (SSRS) ermöglicht es Ihnen, Befehle über eine URL-Anforderung an einen Berichtsserver zu senden. Sie können z. B. das Rendern eines Berichts in einem Native-Modus-Server oder einer SharePoint-Bibliothek anpassen. Möglicherweise haben Sie den Bericht mithilfe einer bestimmten Gruppe von Berichtsparameterwerten angezeigt, oder Sie haben eine bestimmte Seite angezeigt, die für den Bericht von Interesse ist. Sie können diese Informationen in der URL mithilfe vordefinierter URL-Zugriffsparameter kapseln. Sie können weiter anpassen, wie der Berichtsserver den Bericht verarbeitet, indem Sie Parameter für Renderingformate oder das Aussehen und Verhalten des Berichtsanzeiges einbetten. Sie können diese URL dann direkt in eine E-Mail oder Webseite einfügen, damit andere Personen auf die gleiche Weise im Browser auf Ihren Bericht zugreifen können.

Andere Aktionen, die Sie über DEN URL-Zugriff ausführen können, sind:

  • Senden von Befehlen an den HTML-Viewer, z. B. Anpassen des Erscheinungsbilds

  • Auflisten der untergeordneten Elemente eines Katalogordners

  • Abrufen der XML-Definition eines Katalogelements

  • Rendern einer bestimmten Momentaufnahme des Berichtsverlaufs

  • Verwalten von Berichtssitzungen

Die vollständige Liste der Befehle und Einstellungen, die über den URL-Zugriff verfügbar sind, finden Sie unter URL Access Parameter Reference.

URL-Zugriffskonzepte

URL-Anforderungen an den Berichtsserver enthalten Parameter, die vom Berichtsserver verarbeitet werden. Die Art und Weise, in der der Berichtsserver URL-Anforderungen verarbeitet, hängt von den Parametern, Parameterpräfixen und Typen von Elementen ab, die in der URL enthalten sind. Berichtsserver-URLs entsprechen den URL-Formatierungsrichtlinien, wie vom gemeinsamen World Wide Web Consortium W3C/IETF-Entwurfsstandard vorgeschlagen. Die Reporting Services-URL-Funktionalität ist mit den meisten Internetbrowsern oder Anwendungen kompatibel, die die Standard-URL-Adressierung unterstützen.

URL-Zugriffssyntax

URL-Anforderungen können mehrere Parameter enthalten, die in beliebiger Reihenfolge aufgeführt sind. Die Parameter werden durch ein und-Zeichen (&) und die Name/Wert-Paare durch ein Gleichheitszeichen (=) getrennt.

  
rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]  
  

Syntaxbeschreibung

rswebserviceurl
Die Webdienst-URL des Berichtsservers. Für den nativen Modus ist es die Webdienst-URL der Berichtsserverinstanz, die in Reporting Services Configuration Manager konfiguriert ist (siehe Konfigurieren von Berichtsserver-URLs (SSRS Configuration Manager)). Beispiel:

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

Für den integrierten SharePoint-Modus ist es die URL des Reporting Services-Proxys auf einer SharePoint-Website, die in Reporting Services integriert ist. Beispiel:

http://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 Berichtsserverdatenbank für den nativen Modus oder die vollqualifizierte URL des Elements in einem SharePoint-Katalog.

Der Pfad des Katalogelements. Im nativen Modus ist es der relative Pfad des Elements in der Berichtsserverdatenbank, beginnend mit einem Schrägstrich (/). Beispiel:

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2  

Für den integrierten SharePoint-Modus ist es die vollqualifizierte URL des Elements in der SharePoint-Bibliothek, einschließlich der Elementerweiterung. Beispiel:

http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl  

&
Wird verwendet, um Namen- und Wertpaare von URL-Zugriffsparametern zu trennen.

Präfix
Wahlfrei. Ein Präfix für den URL-Zugriffsparameter (z. B. rs: oder rc:), der auf einen bestimmten Prozess zugreift, der innerhalb des Berichtsservers ausgeführt wird.

Hinweis

Wenn kein Präfix für einen URL-Zugriffsparameter enthalten ist, wird der Parameter vom Berichtsserver als Berichtsparameter verarbeitet. Berichtsparameter verwenden kein Parameterpräfix und sind groß-/klein-schreibungssensitiv.

param
Der Parametername.

Wert
URL-Text, der dem Wert des verwendeten Parameters entspricht.

Anmerkung: Eine Liste der verfügbaren URL-Zugriffsparameter finden Sie unter URL Access Parameter Reference. Beispiele zum Übergeben von Berichtsparametern für die URL finden Sie unter Übergeben eines Berichtsparameters innerhalb einer URL.

Aufgabenbeschreibungen Verknüpfungen
Greifen Sie auf Berichtsserverelemente wie Berichte, freigegebene Datenquellen und Ressourcen zu. Zugreifen auf Berichtsserverelemente mithilfe des URL-Zugriffs
Übergeben Sie Berichtsparameter an einen Bericht. Übergeben eines Berichtsparameters innerhalb einer URL
Legen Sie das Gebietsschema der Berichtsparameter in der URL-Zugriffszeichenfolge fest, die die gebietsschemaspezifischen Interpretationen von Datumsangaben, Währungen usw. definiert. Festlegen der Sprache für Berichtsparameter in einer URL
Senden Sie spezifische Einstellungen für die Renderingerweiterung, die anpassen, wie der Bericht gerendert wird. Angeben von Geräteinformationseinstellungen in einer URL
Exportieren Sie einen Bericht direkt in ein Dateiformat, ohne ihn im Browser anzuzeigen. Exportieren eines Berichts mit URL-Zugriff
Öffnen Sie einen Bericht, und navigieren Sie direkt zum Speicherort einer Zeichenfolge. Durchsuchen eines Berichts mit URL-Zugriff
Rendern einer bestimmten Momentaufnahme des Berichtsverlaufs. Rendern einer Berichtsverlaufsmomentaufnahme mithilfe von URL-Zugriff

Siehe auch

Übergeben eines Berichtsparameters innerhalb einer URL
URL-Zugriffsparameterreferenz
Integrieren von Reporting Services mit URL-Zugriff
Suchen, Anzeigen und Verwalten von Berichten (Berichts-Generator und SSRS)