Referenz für URL-Zugriffsparameter

  • Artikel

Sie können Parameter als Teil einer URL verwenden, um die Darstellung und das Verhalten Ihrer Berichte in SQL Server 2016 (13.x) Reporting Services (SSRS) oder höheren Versionen zu konfigurieren. In diesem Artikel werden die gängigsten Parameter beschrieben.

Bei den Parametern wird nicht zwischen Groß- und Kleinschreibung unterschieden. Sie benötigen ein Präfix:

  • rs:: Ist auf den Berichtsserver ausgerichtet.
  • rc:: Ist auf einen HTML-Viewer ausgerichtet.
  • rv:: Ist auf den Report Viewer-Webpart ausgerichtet.

Sie können außerdem Parameter angeben, die für Geräte oder Renderingerweiterungen spezifisch sind. Weitere Informationen zu gerätespezifischen Parametern finden Sie unter Angeben von Geräteinformationseinstellungen in einer URL.

Wichtig

Für einen Berichtsserver im SharePoint-Modus ist es wichtig, dass die URL die _vti_bin-Proxysyntax zur Weiterleitung der Anforderung über SharePoint sowie den SharePoint- und den Reporting Services-HTTP-Proxy enthält. Durch den Proxy wird der HTTP-Anforderung Kontext hinzugefügt, der erforderlich ist, damit der Bericht auf Berichtsservern im SharePoint-Modus ordnungsgemäß ausgeführt wird. Beispiele finden Sie unter Zugreifen auf Berichtsserverelemente über den URL-Zugriff.

Die Integration von Reporting Services in SharePoint ist nach SQL Server 2016 nicht mehr möglich.

Befehle des HTML-Viewers (rc:)

Verwenden Sie zum Ausrichten auf den HTML-Viewer das Präfix rc:.

Befehl Parameter Beschreibung
Toolbar True Zeigt die Symbolleiste an. Der Standardwert lautet true.

Hinweis: Wenn Sie diesen Parameter weglassen, wird die Symbolleiste automatisch für Renderingformate angezeigt, die sie unterstützen.
Toolbar False Blendet die Symbolleiste aus. Wenn dieser Parameters false ist, werden alle verbleibenden Optionen ignoriert.
Toolbar Navigation Zeigt nur die Paginierung auf der Symbolleiste an.
Parameters True Zeigt den Parameterbereich der Symbolleiste an. Der Standardwert lautet true.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Parameters False Blendet den Parameterbereich aus, und der Benutzer kann ihn nicht anzeigen.
Parameters Collapsed Blendet den Parameterbereich aus, aber der Benutzer kann zum Anzeigen umschalten.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width Legen Sie den Zoomwert für den Bericht passend zur Seitenbreite fest.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page Legen Sie den Zoomwert für den Bericht passend zur gesamten Seite fest.
Zoom <integer percentage> Legen Sie den Zoomwert für den Bericht auf einen bestimmten Prozentsatz fest. Der Standardwert ist 100.
Section <page number> Legen Sie fest, welche Seite im Bericht angezeigt werden soll. Bei Eingabe eines Werts, der über der Gesamtzahl der Seiten im Bericht liegt, wird die letzte Seite angezeigt. Bei einem Wert unter 0 wird Seite 1 des Berichts angezeigt. Der Standardwert ist 1.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rc:Section=2

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> Suchen Sie in einem Bericht nach einer bestimmten Textstelle und heben Sie den Text hervor. Hinweis: rc:FindString funktioniert nur dann, wenn sie rc:Toolbar=false in die URL-Zugriffszeichenfolge aufnehmen.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400
StartFind <start page> Geben Sie den ersten zu suchenden Abschnitt an. Der Standardwert ist die erste Seite des Berichts.

Beispiel:

Nativer Modus: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> Legen Sie die Seitenzahl der letzten in der Suche zu verwendenden Seite fest. Der Standardwert ist die Seitenzahl der aktuellen Seite. Verwenden Sie diesen Parameter zusammen mit dem Parameter StartFind.

Beispiel: Siehe Beispiel StartFind.
FallbackPage <page number> Legen Sie die Seitenzahl der Seite fest, die bei einer fehlgeschlagenen Suche oder Dokumentstrukturauswahl angezeigt werden soll. Der Standardwert ist die Seitenzahl der aktuellen Seite.
GetImage <icon name> Rufen Sie ein bestimmtes Bild für die Benutzeroberfläche des HTML-Viewers ab.
Icon <icon name> Rufen Sie ein Symbol einer bestimmten Renderingerweiterung ab.
Stylesheet <stylesheet file name> Geben Sie eine Formatvorlage an, die Sie auf den HTML-Viewer anwenden möchten.
Geräteinformationseinstellung Geben Sie eine Geräteinformationseinstellung im Format rc:tag=value an, wobei tag dem Namen einer für die Renderingerweiterung spezifischen Geräteinformationseinstellung entspricht. Weitere Informationen finden Sie in der Beschreibung des Befehls Format.

Sie können die Geräteinformationseinstellung OutputFormat für die IMAGE-Renderingerweiterung verwenden, um den Bericht mithilfe der folgenden Parameter in der URL-Zugriffszeichenfolge in ein JPEG-Bild zu rendern: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Weitere Informationen zu allen erweiterungsspezifischen Geräteinformationseinstellungen finden Sie im Artikel Geräteinformationseinstellungen für Renderingerweiterungen (Reporting Services).

Befehle des Berichtsservers (rs:)

Verwenden Sie zum Ausrichten auf den Berichtsserver das Präfix rs:.

Befehl Parameter Beschreibung
Command ListChildren und GetChildren Zeigen Sie den Inhalt eines Ordners an. Die Ordnerelemente werden in einer generischen Seite zur Elementnavigation angezeigt.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales&rs:Command=GetChildren

Eine benannte Instanz im nativen Modus: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

SharePoint-Modus:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render Der Bericht wird im Browser gerendert, sodass Sie ihn anzeigen können.

Beispiele:

Nativer Modus:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint-Modus:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition Zeigen Sie die einem freigegebenen Dataset zugeordnete XML-Definition an. Die Eigenschaften des freigegebenen Datasets werden in der Definition gespeichert. Zu diesen Eigenschaften gehören Abfrage, Datasetparameter, Standardwerte, Datasetfilter und Datenoptionen, wie z. B. Sortierung und Berücksichtigung der Groß-/Kleinschreibung. Sie müssen zum Lesen von Berichtsdefinitionen eines freigegebenen Datasets berechtigt sein, um diesen Wert verwenden zu können.

Beispiel:

Nativer Modus: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents Zeigen Sie die Eigenschaften einer bestimmten freigegebenen Datenquelle als XML-Datei an. Wenn Ihr Browser XML unterstützt und Sie ein für die Datenquelle authentifizierter Benutzer mit der Berechtigung Read Contents (Inhalte lesen) sind, wird die Datenquellendefinition angezeigt.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents Rendern Sie eine Ressource und zeigen Sie sie auf einer HTML-Seite an, wenn die Ressource mit dem Browser kompatibel ist. Andernfalls können Sie die Datei oder Ressource öffnen oder auf dem Datenträger speichern.

Beispiele:

Nativer Modus: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition Zeigen Sie die einem veröffentlichten Berichtselement zugeordnete XML-Definition an. Sie müssen zum Lesen von Inhalten eines veröffentlichten Berichtselements berechtigt sein, um diesen Wert verwenden zu können.
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL (für .xls)
EXCELOPENXML (für .xlsx)
WORD (für .doc)
WORDOPENXML (für .docx)
CSV
PDF
XML		 Geben Sie das Format an, in dem der Bericht gerendert und angezeigt werden soll. Der Standardwert ist HTML5. Weitere Informationen finden Sie unter Exportieren von Berichten über URL-Zugriff. Eine vollständige Liste finden Sie im Abschnitt zur \<Render>-Erweiterung der Datei rsreportserver.config auf dem Berichtsserver. Weitere Informationen finden Sie unter RsReportServer.config-Konfigurationsdatei.

Beispiele:

Nativer Modus: https://myrshost/ReportServer?/myreport&rs:Format=PDF

SharePoint-Modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us, de-DE usw. Geben Sie eine Sprache für in einer URL übergebene Parameter an, die von der Browsersprache unabhängig ist. Der Standardwert ist die Browsersprache.

Beispiel:

Nativer Modus: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot Rendern Sie einen Bericht anhand einer Berichtsverlaufs-Momentaufnahme. Weitere Informationen finden Sie unter Rendern von Berichtsverlaufs-Momentaufnahmen mit URL-Zugriff.

Beispiel:

Nativer Modus: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false		 Rendern Sie einen Bericht in einem einzelnen permanenten Datenstrom. Der Bildrenderer verwendet diesen Parameter, um den gerenderten Bericht segmentweise zu senden. Nachdem Sie diesen Parameter in einer URL-Zugriffszeichenfolge verwendet haben, verwenden Sie dieselbe URL-Zugriffszeichenfolge mit dem GetNextStream-Parameter anstelle des PersistStreams-Parameters, um das nächste Segment im permanenten Datenstrom abzurufen. Dieser URL-Befehl gibt schließlich einen 0-Byte-Datenstrom zurück, um das Ende des permanenten Datenstroms anzugeben. Der Standardwert ist false.
GetNextStream true
false		 Rufen Sie das nächste Datensegment in einem permanenten Datenstrom ab, auf den mit dem PersistStreams-Parameter zugegriffen wird. Weitere Informationen finden Sie in der Beschreibung des Befehls PersistStreams. Der Standardwert ist false.
SessionID Geben Sie eine feststehende aktive Berichtssitzung zwischen der Clientanwendung und dem Berichtsserver an. Der Wert dieses Parameters wird auf die Sitzungs-ID festgelegt.

Sie können die Sitzungs-ID als Cookie oder als Teil der URL angeben. Wenn Sie den Berichtsserver so konfigurieren, dass keine Sitzungscookies verwendet werden, führt die erste Anforderung ohne eine bestimmte Sitzungs-ID zu einer Umleitung mit einer Sitzungs-ID. Weitere Informationen finden Sie unter Identifizieren des Ausführungsstatus.
ClearSession true
false		 Entfernen Sie alle zu einem authentifizierten Benutzer gehörigen Berichtsinstanzen aus der Berichtssitzung. Eine Berichtsinstanz wird als derselbe Bericht definiert, der mehrmals mit unterschiedlichen Berichtsparameterwerten ausgeführt wurde. Der Standardwert ist false. Gültige Werte sind true und false.
ResetSession true
false		 Setzen Sie die Berichtssitzung zurück, indem die Zuordnung der Berichtssitzung zu allen Berichtsmomentaufnahmen entfernt wird. Der Standardwert ist false. Gültige Werte sind true und false.
ShowHideToggle <positive integer> Schalten Sie das Ein-/Ausblenden eines Abschnitts im Bericht um. Geben Sie eine positive ganze Zahl an, um den Abschnitt anzugeben, der umgeschaltet werden soll.

Befehle des Report Viewer-Webparts (rv:)

Verwenden Sie zum Ausrichten auf den in SharePoint integrierten Report Viewer-Webpart das Präfix rv:. Für Report Viewer-Webparts kann auch der Parameter rs:ParameterLanguage verwendet werden.

Befehl Parameter Beschreibung
Toolbar Full Zeigt die vollständige Symbolleiste an. Der Standardwert ist Full.
Toolbar Navigation Zeigt nur die Paginierung auf der Symbolleiste an.

Beispiel:

SharePoint-Modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None Die Symbolleiste wird nicht angezeigt.
HeaderArea Full Zeigt die vollständige Kopfzeile an. Der Standardwert ist Full.
HeaderArea BreadCrumbsOnly Zeigt nur einen Teil (Breadcrumb) der Navigation in der Kopfzeile an, um die Benutzer über ihre Position in der Anwendung zu informieren.

Beispiel:

SharePoint-Modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None Blendet den Header aus.
DocMapAreaWidth Steuern Sie die Anzeigebreite (in Pixel) des Parameterbereichs im Report Viewer-Webpart. Der Standardwert entspricht dem Standardwert des Bericht-Viewer-Webparts. Der Wert muss eine nicht negative ganze Zahl sein.
AsyncRender true
false		 Steuern Sie, ob ein Bericht asynchron gerendert wird. Der Standardwert ist TRUE. Er gibt an, dass ein Bericht asynchron gerendert wird. Der Wert muss ein boolescher Wert TRUE oder FALSEsein.
ParamMode Full Zeigt den Eingabeaufforderungsbereich für Parameter an. Der Standardwert ist Full.
Collapsed Reduziert den Eingabeaufforderungsbereich für Parameter.

Beispiel:

SharePoint-Modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden Blendet den Eingabeaufforderungsbereich für Parameter aus.
DocMapMode Full Zeigt den Dokumentstrukturbereich an. Der Standardwert ist Full.
DocMapMode Collapsed Reduziert den Dokumentstrukturbereich.
DocMapMode Hidden Blendet den Dokumentstrukturbereich aus.
DockToolBar Top Die Symbolleiste wird im oberen Bereich angedockt. Der Standardwert ist Top.
DockToolBar Bottom Die Symbolleiste wird im unteren Bereich angedockt.

Beispiel:

SharePoint-Modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) Schaltfläche Zurück
ToolBarItemsDisplayMode 2 (0x2) Steuerelemente für die Textsuche
ToolBarItemsDisplayMode 4 (0x4) Steuerelemente für die Seitennavigation
ToolBarItemsDisplayMode 8 (0 x 8) Schaltfläche „Aktualisieren“
ToolBarItemsDisplayMode 16 (0x10) Zoom-Listenfeld
ToolBarItemsDisplayMode 32 (0x20) Schaltfläche Atom-Feed
ToolBarItemsDisplayMode 64 (0x40) Menüoption Drucken in Aktionen
ToolBarItemsDisplayMode 128 (0x80) Untermenü Exportieren in Aktionen
ToolBarItemsDisplayMode 256 (0x100) Menüoption Mit Report Builder öffnen in Aktionen
ToolBarItemsDisplayMode 512 (0x200) Menüoption Abonnieren in Aktionen
ToolBarItemsDisplayMode 1024 (0 x 400) Menüoption Neue Datenwarnung in Aktionen
ToolBarItemsDisplayMode Mehrere Werte Steuern Sie, welche Symbolleistenelemente angezeigt werden sollen. Dieser Wert ist ein bitweiser Enumerationswert. Um ein Symbolleistenelement einzuschließen, fügen Sie dem Gesamtwert den Wert des Elements hinzu. Verwenden Sie beispielsweise rv:ToolBarItemsDisplayMode=63 (oder 0x3F), was 1 + 2 + 4 + 8 + 16 + 32 entspricht, um kein Aktionen-Menü anzuzeigen. Verwenden Sie rv:ToolBarItemsDisplayMode=960 (oder 0x3C0), um nur die Menüelemente Aktionen anzuzeigen. Der Standardwert, der alle Symbolleistenelemente einschließt, ist -1. Gültige Werte sind:

Beispiel:

SharePoint-Modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Zugehöriger Inhalt