URL-Zugriff (SSRS)

 

Gilt für: SQL Server 2016

Durch den URL-Zugriff des Berichtsservers in SQL Server Reporting Services (SSRS) können Sie Befehle an den Berichtsserver über eine URL-Anforderung senden. Beispielsweise können Sie das Rendering eines Berichts auf einem Berichtsserver im einheitlichen Modus oder in einer SharePoint-Bibliothek anpassen. Möglicherweise haben Sie den Bericht unter Verwendung bestimmter Berichtsparameterwerte angezeigt oder eine bestimmte Berichtsseite gelesen, die für Sie von Interesse war. Diese Informationen können mithilfe vordefinierter URL-Zugriffsparameter in der URL gekapselt werden. Außerdem kann die Berichtsverarbeitung auf dem Berichtsserver weiter angepasst werden, indem Sie Parameter für Renderingformate oder für das Erscheinungsbild des Berichts-Viewers einbetten. Anschließend können Sie diese URL direkt in eine E-Mail oder Webseite einfügen, damit andere Benutzer im Browser auf die gleiche Weise auf den Bericht zugreifen können.

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

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

  • Auflisten der untergeordneten Elemente eines Katalogordners

  • Abrufen der XML-Definition eines Katalogelements

  • Rendern einer bestimmten Berichtsverlaufs-Momentaufnahme

  • Verwalten von Berichtssitzungen

Eine vollständige Liste der über URL-Zugriff verfügbaren Befehle und Einstellungen finden Sie unter URL-Zugriffsparameterreferenz.

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. Parameter werden durch das kaufmännische Und-Zeichen (&) getrennt, Name/Wert-Paare werden durch das Gleichheitszeichen (=) getrennt.

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

Syntaxbeschreibung

rswebserviceurl
Die Webdienst-URL des Berichtsservers. Im einheitlichen Modus ist dies die Webdienst-URL der im Konfigurations-Manager für Reporting Services konfigurierten Berichtsserverinstanz. Weitere Informationen finden Sie unter Konfigurieren von Berichtsserver-URLs (SSRS-Konfigurations-Manager). Beispiel:

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

Im integrierten SharePoint-Modus entspricht sie der URL des Reporting Services -Proxys auf einer in Reporting Servicesintegrierten SharePoint-Website. Beispiel:

http://myspsite/subsite/_vti_bin/reportserver  

System_CAPS_ICON_tip.jpg 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. Beispiel:

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2  

Im integrierten SharePoint-Modus ist dies 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
Optional. Ein Präfix für den URL-Zugriffsparameter (z.B. rs: oder rc:), durch das auf einen bestimmten im Berichtsserver ausgeführten Prozess zugegriffen wird.

System_CAPS_ICON_note.jpg 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.

param
Der Name des Parameters.

value
URL-Text, der dem Wert des Parameters entspricht, der verwendet wird.

Hinweis: Eine Liste der verfügbaren URL-Zugriffsparameter finden Sie unter URL Access Parameter Reference. Beispiele für die Übergabe von Berichtsparametern mit der URL finden Sie unter Pass a Report Parameter Within a URL.

TaskbeschreibungenLinks
Zugreifen auf Berichtserverelemente, z. B. Berichte, freigegebene Datenquellen und RessourcenZugreifen auf Berichtsserverelemente über den URL-Zugriff
Übergeben von Berichtsparametern an einen BerichtÜbergeben von Berichtsparametern innerhalb einer URL
Festlegen des Gebietsschemas der Berichtsparameter in der URL-Zugriffszeichenfolge, durch die die gebietsschemaspezifische Interpretation von Datumsangaben, Währungen usw. festgelegt wirdFestlegen der Sprache für Berichtsparameter in einer URL
Senden spezifischer Einstellungen für Renderingerweiterungen, durch die das Rendern des Berichts angepasst wirdAngeben von Geräteinformationseinstellungen in einer URL
Direktes Exportieren eines Berichts in ein Dateiformat, ohne ihn im Browser anzuzeigenExportieren von Berichten über URL-Zugriff
Öffnen eines Berichts und direktes Navigieren zur Position einer ZeichenfolgeSuchen eines Berichts mithilfe von URL-Zugriff
Rendern einer bestimmten Berichtsverlaufs-MomentaufnahmeRendern von Berichtsverlaufs-Momentaufnahmen mit URL-Zugriff

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

Community-Beiträge

HINZUFÜGEN
Anzeigen: