URL-Zugriffsparameterreferenz

Sie können die folgenden Parameter als Teil einer URL verwenden, um das Aussehen und Verhalten Ihrer Berichte zu konfigurieren. In diesem Abschnitt sind die am häufigsten verwendeten Parameter aufgeführt. Bei Parametern muss keine Groß- und Kleinschreibung beachtet werden. Sie beginnen mit dem Präfix rs: , wenn sie an den Berichtsserver weitergeleitet werden, und mit rs: , wenn sie zu einem HTML-Viewer weitergeleitet werden. 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

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. Beispiele finden Sie unter Zugreifen auf Berichtsserverelemente mithilfe des URL-Zugriffs.

Informationen dazu, wie Berichtsparameter in eine URL eingeschlossen werden, finden Sie unter Übergeben von Berichtsparametern innerhalb einer URL.

Befehle des HTML-Viewers (rc:)

In der folgenden Tabelle werden die URL-Zugriffsparameter beschrieben, denen rc: vorangestellt ist und für den HTML-Viewer verwendet wird.

Parameter	BESCHREIBUNG	Werte
Symbolleiste	Zeigt die Symbolleiste an oder blendet sie aus. ** Wichtig **rc:Toolbar=false funktioniert nicht für URL-Zugriffszeichenfolgen, die eine IP-Adresse anstelle eines Domänennamens verwenden, um einen auf einer SharePoint-Website gehosteten Bericht als Ziel zu verwenden.	Wenn der Wert dieses Parameters false ist, werden alle verbleibenden Optionen ignoriert. Wenn Sie diesen Parameter weglassen, wird die Symbolleiste automatisch für Renderingformate angezeigt, die sie unterstützen. Der Standardwert dieses Parameters ist true. true false
Parameter	Zeigt den Parameterbereich der Symbolleiste an oder blendet ihn aus. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed	Wenn Sie diesen Parameter auf true festlegen, wird der Parameterbereich der Symbolleiste angezeigt. Wenn Sie diesen Parameter auf false festlegen, wird der Parameterbereich nicht angezeigt und kann auch nicht vom Benutzer angezeigt werden. Wenn Sie diesen Parameter auf den Wert Collapsed festlegen, wird der Parameterbereich nicht angezeigt, kann aber vom Endbenutzer ein-/ausgeschaltet werden. Der Standardwert dieses Parameters ist true. Gültige Werte sind: true false Collapsed
Zoom	Legt den Zoomfaktor für den Bericht als ganzzahligen Prozentsatz oder Zeichenfolgenkonstante fest. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales&rc:Zoom=Page Width SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width	Standardwerte für die Zeichenfolge sind Page Width und Whole Page. Dieser Parameter wird von den Internet Explorer-Versionen vor 5.0 sowie allen nicht von Microsoft bereitgestellten Browsern ignoriert. Der Standardwert dieses Parameters ist 100.
Bereich	Legt fest, welche Seite im Bericht angezeigt werden soll. Native Beispiel für die Anzeige von Seite 2 des Berichts: http://myrshost/reportserver?/Sales&rc:Section=2 SharePoint Beispiel für die Anzeige von Seite 2 des Berichts: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2	Bei Eingabe eines Wertes, der über der Gesamtzahl der Seiten im Bericht liegt, wird die letzte Seite angezeigt. Bei jedem Wert kleiner als 0 wird Seite 1 des Berichts angezeigt. Der Standardwert dieses Parameters ist 1.
FindString	Durchsuchen eines Berichts nach einem bestimmten Textteil. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400 SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400
StartFind	Legt den letzten Abschnitt für die Suche fest. Native Mode-Beispiel, das nach dem ersten Vorkommen des Texts "Mountain-400" im Beispielbericht des Produktkatalogs sucht, beginnend mit Seite 1 und Ende auf Seite fünf: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400	Der Standardwert dieses Parameters ist die letzte Seite des Berichts.
EndFind	Legt die Seitenzahl der letzten Seite für die Suche fest. Beispiel: Der Wert 5 gibt an, dass Seite 5 des Berichts die letzte zu durchsuchende Seite ist. Verwenden Sie diesen Parameter in Verbindung mit dem StartFind -Parameter. Siehe das obige Beispiel für StartFind .	Der Standardwert ist die Seitenzahl der aktuellen Seite.
FallbackPage	Legt die Seitenzahl der Seite fest, die bei einer fehlgeschlagenen Suche oder Dokumentstrukturauswahl angezeigt wird.	Der Standardwert ist die Seitenzahl der aktuellen Seite.
GetImage	Ruft ein bestimmtes Symbol für die Benutzeroberfläche des HTML-Viewers ab.
Symbol:	Ruft ein Symbol einer bestimmten Renderingerweiterung ab.
Stylesheet	Legt ein Stylesheet fest, das auf den HTML-Viewer angewendet wird.
Einstellung für Geräteinformationen	Hiermit wird eine Geräteinformationseinstellung in der Form von rc:tag=value festgelegt, wobei tag der Name einer für die gerade verwendete Renderingerweiterung spezifischen Geräteinformationseinstellung ist (siehe die Beschreibung für den Format-Parameter). Sie können z.B. die OutputFormat -Geräteinformationseinstellung für die IMAGE-Renderingerweiterung verwenden, um den Bericht mithilfe der folgenden Parameter in der URL-Zugriffszeichenfolge zu einem JPEG-Bild zu rendern: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Weitere Informationen zu allen erweiterungsspezifischen Geräteinformationseinstellungen finden Sie unter Geräteinformationseinstellungen für Renderingerweiterungen (Reporting Services).

Befehle des Berichtsservers (rs:)

In der folgenden Tabelle werden die URL-Zugriffsparameter beschrieben, denen rs: vorangestellt ist und für den Berichtsserver verwendet wird.

Parameter	BESCHREIBUNG
Befehl	Führt eine Aktion auf einem Katalogelement aus. Dies ist abhängig von dessen Elementtyp. Der Standardwert wird vom Typ des Katalogelements bestimmt, auf den in der URL-Zugriffszeichenfolge verwiesen wird. Gültige Werte sind: ListChildren und GetChildren zeigt den Inhalt eines Ordners an. Die Ordnerelemente werden in einer generischen Seite zur Elementnavigation angezeigt. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales&rs:Command=GetChildren SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren
	Render Rendert den angegebenen Bericht. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
	GetSharedDatasetDefinition Zeigt die XML-Definition an, die einem freigegebenen Dataset zugeordnet ist. Eigenschaften freigegebener Datasets, einschließlich der Abfrage, Datasetparameter, Standardwerte, Datasetfilter und Datenoptionen z. B. zur Sortierung und Berücksichtigung der Groß-/Kleinschreibung, werden in der Definition gespeichert. Sie müssen zum Lesen von Berichtsdefinitionen eines freigegebenen Datasets berechtigt sein, um diesen Wert verwenden zu können. Native Beispiel für den Modus: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
	GetDataSourceContents Zeigt die Eigenschaften einer angegebenen freigegebenen Datenquelle als XML an. Wenn Ihr Browser XML unterstützt und wenn Sie ein für die Datenquelle authentifizierter Benutzer mit der Berechtigung Read Contents sind, wird die Datenquellendefinition angezeigt. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents
	GetResourceContents Rendert eine Ressource und zeigt sie auf einer HTML-Seite an, wenn die Ressource mit dem Browser kompatibel ist. Andernfalls werden Sie aufgefordert, die Datei oder Ressource zu öffnen oder auf dem Datenträger zu speichern. Native Beispiel für den Modus: http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents SharePoint Beispiel für den Modus: http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
	GetComponentDefinition Zeigt die XML-Definition an, die einem veröffentlichten Berichtselement zugeordnet ist. Sie müssen über die Berechtigung für ein veröffentlichtes Berichtselement verfügen Read Contents , um diesen Wert verwenden zu können.
Format	Legt das Format fest, in dem der Bericht gerendert wird. Häufig verwendete Werte sind: ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. Der Standardwert ist HTML4.0. Weitere Informationen finden Sie unter Exportieren von Berichten über URL-Zugriff. Beispiel für das Abrufen einer PDF-Kopie eines Berichts direkt von einem Berichtsserver im Native-Modus. http://myrshost/ReportServer?/myreport&rs:Format=PDF Beispiel: im SharePoint Modus. http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage	Bietet eine Sprache für in einer URL übergebene Parameter, die von der Browsersprache unabhängig ist. Der Standardwert ist die Browsersprache. Der Wert kann ein Kulturwert sein, z. B. en-us oder de-de. Beispiel im Native-Modus, in dem die Browsersprache überschrieben und der Kulturwert "de-DE" angegeben wird. http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Momentaufnahme	Rendert einen Bericht anhand einer Berichtsverlaufs-Momentaufnahme. Weitere Informationen finden Sie unter Rendern einer Berichtsverlaufsmomentaufnahme mithilfe des URL-Zugriffs. Beispiel im Native-Modus, in dem eine Berichtsverlaufs-Momentaufnahme vom 07.04.2003 mit dem Zeitstempel 13:40:02 abgerufen wird. http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams	Rendert einen Bericht in einem einzelnen permanenten Datenstrom. Dieser Parameter wird vom Bildrenderer verwendet, um den gerenderten Bericht segmentweise zu senden. Nachdem Sie diesen Parameter in einer URL-Zugriffszeichenfolge verwendet haben, verwenden Sie diese URL-Zugriffszeichenfolge mit dem GetNextStream -Parameter anstelle des PersistStreams -Parameters, um das nächste Segment im permanenten Datenstrom abzurufen. Dieser URL-Befehl gibt abschließend einen 0-Byte-Datenstrom zurück, um das Ende des permanenten Datenstroms anzugeben. Der Standardwert ist false.
GetNextStream	Ruft das nächste Datensegment in einem permanenten Datenstrom ab, auf den mit dem PersistStreams -Parameter zugegriffen wird. Weitere Informationen finden Sie in der Beschreibung für PersistStreams. Der Standardwert ist false.
Sessionid	Gibt 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 der Berichtsserver nicht für die Verwendung von Cookies konfiguriert wurde, führt die erste Anforderung ohne eine bestimmte Sitzungs-ID zu einer Umleitung mit einer Sitzungs-ID. Weitere Informationen zu Berichtsserversitzungen finden Sie unter Identifizieren des Ausführungsstatus.
ClearSession	Ein true-Wert weist den Berichtsserver an, einen Bericht aus der Berichtssitzung zu löschen. Alle zu einem authentifizierten Benutzer gehörigen Berichtsinstanzen werden aus der Berichtssitzung entfernt. (Ein Bericht instance als derselbe Bericht definiert wird, der mehrmals mit unterschiedlichen Berichtsparameterwerten ausgeführt wird.) Der Standardwert ist false.
ResetSession	Ein true-Wert weist den Berichtsserver an, die Berichtssitzung zurückzusetzen, indem die Zuordnung der Berichtssitzung zu allen Berichtsmomentaufnahmen entfernt wird. Der Standardwert ist false.
ShowHideToggle	Schaltet 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 Berichts-Viewer-Webparts (rv:)

In der folgenden Tabelle werden die SQL Server reservierten Berichtsparameternamen beschrieben, die für das In SharePoint integrierte Berichts-Viewer-Webpart verwendet werden. Diese Parameternamen haben das Präfix rv: . Das Berichts-Viewer-Webpart akzeptiert auch den Rs:ParameterLanguage-Parameter .

Parameter	Aktion
Symbolleiste	Steuert die Symbolleistenanzeige des Bericht-Viewer-Webparts. Der Standardwert ist Full. Mögliche Werte: Full: Zeigt die vollständige Symbolleiste an. Navigation: Zeigt nur die Paginierung auf der Symbolleiste an. None: Zeigt die Symbolleiste nicht an. Wenn z. B. im SharePoint-Modus nur die Paginierung auf der Symbolleiste angezeigt werden soll. http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
HeaderArea	Steuert die Anzeige der Kopfzeile des Bericht-Viewer-Webparts. Der Standardwert ist Full. Mögliche Werte: Full: Zeigt die vollständige Kopfzeile an. BreadCrumbsOnly: Zeigt nur einen Teil (Breadcrumb) der Navigation in der Kopfzeile an, um die Benutzer über ihre Position in der Anwendung zu informieren. None: Zeigt die Kopfzeile nicht an. Wenn z. B. im SharePoint-Modus nur ein Teil der Navigation (Breadcrumb) in der Kopfzeile angezeigt werden soll. http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
DocMapAreaWidth	Steuert die Anzeigebreite (in Pixel) des Parameterbereichs im Bericht-Viewer-Webpart. Der Standardwert entspricht dem Standardwert des Bericht-Viewer-Webparts. Der Wert muss eine nicht negative ganze Zahl sein.
AsyncRender	Steuert, 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 false sein
ParamMode	Mit diesem Befehl wird gesteuert, wie der Eingabeaufforderungsbereich für Parameter des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. Der Standardwert ist Full. Gültige Werte sind: Full: Eingabeaufforderungsbereich für Parameter anzeigen. Collapsed: Reduziert den Eingabeaufforderungsbereich für Parameter. Hidden: Blendet den Eingabeaufforderungsbereich für Parameter aus. Wenn z. B. im SharePoint-Modus der Eingabeaufforderungsbereich für Parameter reduziert werden soll. http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
DocMapMode	Mit diesem Befehl wird gesteuert, wie der Dokumentstrukturbereich des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. Der Standardwert ist Full. Gültige Werte sind: Full: Dokumentstrukturbereich anzeigen. Collapsed: Dokumentstrukturbereich reduzieren. Hidden: Dokumentstrukturbereich ausblenden.
DockToolBar	Mit diesem Befehl wird gesteuert, ob die Symbolleiste des Berichts-Viewer-Webparts oben oder unten angedockt wird. Gültige Werte sind Top und Bottom. Standardwert: Top. Wenn z. B. im SharePoint-Modus die Symbolleiste unten angedockt werden soll. http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode	Steuert, welche Symbolleistenelemente angezeigt werden. Hierbei handelt es sich um einen bitweisen Enumerationswert. Um ein Symbolleistenelement einzuschließen, fügen Sie dem Gesamtwert den Wert des Elements hinzu. Zum Beispiel: verwenden Sie für das Menü "Keine Aktionen" rv:ToolBarItemsDisplayMode=63 (oder 0x3F), was 1+2+4+8+16+32 bedeutet; nur für Aktionen-Menüelemente verwenden Sie rv:ToolBarItemsDisplayMode=960 (oder 0x3C0). Der Standardwert, der alle Symbolleistenelemente einschließt, ist -1. Gültige Werte sind: 1 (0x1): die Schaltfläche "Zurück " 2 (0x2): die Steuerelemente für die Textsuche. 4 (0x4): die Steuerelemente für die Seitennavigation. 8 (0x8): die Schaltfläche Aktualisieren 16 (0x10): das Listenfeld Zoom 32 (0x20): die Atom Feed-Schaltfläche 64 (0x40): Die Menüoption Drucken in Aktionen 128 (0x80): das Untermenü Export in Actions 256 (0x100: Die Menüoption Mit Report Builder öffnen in Aktionen 512 (0x200: Menüoption "Abonnieren " in Aktionen 1024 (0x400: Die Menüoption Neue Datenwarnung in Aktionen Beispielsweise im SharePoint Modus, um nur die Schaltfläche Zurück , Textsuchsteuerelemente, Seitennavigationssteuerelemente und die Schaltfläche Aktualisieren anzuzeigen. http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Weitere Informationen

URL-Zugriff (SSRS)