URL-Zugriffsparameterverweis

  • Artikel

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 rc:, 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.

Wichtiger HinweisWichtig

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 über den URL-Zugriff.

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, die mit dem Präfix rc: versehen sind, und mit deren Hilfe der HTML-Viewer ausgewählt wird.

Parameter

Aktion

Toolbar

Zeigt die Symbolleiste an oder blendet sie aus. 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.

Wichtiger HinweisWichtig

rc:Toolbar=false funktioniert nicht für URL-Zugriffszeichenfolgen, die eine IP-Adresse anstelle eines Domänennamens verwenden, um auf einen auf einer SharePoint-Website gehosteten Bericht abzuzielen.

Parameters

Zeigt den Parameterbereich der Symbolleiste an oder blendet ihn aus. 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.

Beispiel im Native-Modus.

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Beispiel im SharePoint-Modus.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed

Zoom

Legt den Zoomfaktor für den Bericht als ganzzahligen Prozentsatz oder Zeichenfolgenkonstante fest. Standardwerte für die Zeichenfolge sind Page Width und Whole Page. Dieser Parameter wird von Internet Explorer-Versionen vor Internet Explorer 5.0 sowie allen nicht von Microsoft bereitgestellten Browsern ignoriert. Der Standardwert dieses Parameters ist 100.

Beispiel im Native-Modus.

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

Beispiel im SharePoint-Modus.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width

Section

Legt fest, welche Seite im Bericht angezeigt werden soll. 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.

Beispiel zum Anzeigen von Berichtsseite 2 im Native-Modus.

http://myrshost/reportserver?/Sales&rc:Section=2

Beispiel zum Anzeigen von Berichtsseite 2 im SharePoint-Modus.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2

FindString

Durchsuchen eines Berichts nach einem bestimmten Textteil.

Beispiel im Native-Modus.

http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400

Beispiel im SharePoint-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. Der Standardwert dieses Parameters ist die letzte Seite des Berichts.

Beispiel im Native-Modus, in dem nach dem ersten Vorkommen des Texts "Mountain-400" im Beispielbericht "Product Catalog" gesucht wird. Die Suche beginnt auf der ersten Seite und endet auf der fünften Seite.

https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400

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. Der Standardwert ist die Seitenzahl der aktuellen Seite. Verwenden Sie diesen Parameter in Verbindung mit dem StartFind-Parameter. Weitere Informationen finden Sie im Beispiel oben.

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.

Icon

Ruft ein Symbol einer bestimmten Renderingerweiterung ab.

Stylesheet

Legt ein Stylesheet fest, das auf den HTML-Viewer angewendet wird.

Geräteinformationseinstellungen

Legt eine Geräteinformationseinstellung in der Form von rc:tag=value fest, 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, die mit einem Präfix rs: versehen sind, und mit deren Hilfe der Berichtsserver ausgewählt wird.

Parameter

Aktion

Command

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 Zeigen den Inhalt eines Ordners an. Die Ordnerelemente werden in einer generischen Seite zur Elementnavigation angezeigt.

    Beispiel im Native-Modus.

    http://myrshost/reportserver?/Sales&rs:Command=GetChildren

    Beispiel im SharePoint-Modus.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren

  • Render Rendert den angegebenen Bericht.

    Beispiel im Native-Modus:

    http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

    Beispiel im SharePoint-Modus.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render

  • GetSharedDatasetDefinition Zeigt die einem freigegebenen Dataset zugeordnete XML-Definition an. 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.

    Beispiel im Native-Modus.

    https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition

  • GetDataSourceContents Zeigt die Eigenschaften einer bestimmten 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.

    Beispiel im Native-Modus.

    http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

    Beispiel im SharePoint-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.

    Beispiel im Native-Modus.

    http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

    Beispiel im SharePoint-Modus.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents

  • GetComponentDefinition Zeigt 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

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

Snapshot

Rendert einen Bericht anhand einer Berichtsverlaufs-Momentaufnahme. Weitere Informationen finden Sie unter Rendern von Berichtsverlaufs-Momentaufnahmen mit URL-Zugriff.

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 zu 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 Berichtsserver-Sitzungen 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. (Eine Berichtsinstanz wird als derselbe Bericht definiert, der mehrmals mit unterschiedlichen Berichtsparameterwerten ausgeführt wurde.) 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 für SQL Server reservierten Berichtsparameternamen beschrieben, die zum Auswählen des in SharePoint integrierten Berichts-Viewer-Webparts verwendet werden. Diese Parameternamen haben das Präfix rv:. Für Berichts-Viewer-Webparts kann auch der rs:ParameterLanguage-Parameter verwendet werden.

Parameter

Aktion

Toolbar

Steuert die Symbolleistenanzeige des Bericht-Viewer-Webparts. Der Standardwert ist Full. Folgende Werte sind möglich:

  • 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. Folgende Werte sind möglich:

  • 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

Steuert, wie der Eingabeaufforderungsbereich für Parameter des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. 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.

Der Standardwert ist Full.

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

Steuert, wie der Dokumentstrukturbereich des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. Gültige Werte sind:

  • Full: Dokumentstrukturbereich anzeigen.

  • Collapsed: Dokumentstrukturbereich reduzieren.

  • Hidden: Dokumentstrukturbereich ausblenden.

Der Standardwert ist Full.

DockToolBar

Steuert, ob die Symbolleiste des Berichts-Viewer-Webparts oben oder unten angedockt wird. Gültige Werte sind Top und Bottom. Der Standardwert ist 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). Gültige Werte sind:

  1. 1 (0x1): die Schaltfläche Zurück.

  2. 2 (0x2): die Steuerelemente für die Textsuche.

  3. 4 (0x4): die Steuerelemente für die Seitennavigation.

  4. 8 (0x8): die Schaltfläche Aktualisieren.

  5. 16 (0x10): das Listenfeld Zoom.

  6. 32 (0x20): die Schaltfläche Atom-Feed.

  7. 64 (0x40): die Menüoption Drucken in Aktionen.

  8. 128 (0x80): das Untermenü Exportieren in Aktionen.

  9. 256 (0x100): die Menüoption Mit dem Berichts-Generator öffnen in Aktionen.

  10. 512 (0x200): die Menüoption Abonnieren in Aktionen.

  11. 1024 (0x400): die Menüoption Neue Datenwarnung in Aktionen.

Der Standardwert, der alle Symbolleistenelemente einschließt, ist -1.

Wenn z. B. im SharePoint-Modus nur die Schaltfläche Zurück, Steuerelemente für die Textsuche, Steuerelemente für die Seitennavigation und die Schaltfläche Aktualisieren angezeigt werden sollen.

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

Siehe auch

Konzepte

URL-Zugriff (SSRS)