URL Access Parameter Reference (URL-Zugriffsparameterverweis)
Sie können die folgenden Parameter als Teil einer URL verwenden, um die Darstellung und das 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 ü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 rc vorangestellt sind und für den HTML-Viewer verwendet werden.
| Parameter | BESCHREIBUNG | Werte |
|---|---|---|
| Symbolleiste | Zeigt die Symbolleiste an oder blendet sie aus. ** Important ** rc:Toolbar= false funktioniert nicht für URL-Zugriffszeichenfolgen, die eine IP-Adresse anstelle eines Domänennamens verwenden, um einen bericht zu adressieren, der auf einer SharePoint-Website gehostet wird. |
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=CollapsedSharePoint 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 WidthSharePoint 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. |
| Abschnitt | Legt fest, welche Seite im Bericht angezeigt werden soll.Native Beispiel für den Modus zum Anzeigen von Seite 2 des Berichts:http://myrshost/reportserver?/Sales&rc:Section=2SharePoint Beispiel für den Modus zum Anzeigen 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-400SharePoint 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 example that search for the first occurrence of the text "Mountain-400" in the Product Catalog sample report starting with page one and ends with page five: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. | |
| Geräteinformationseinstellung | 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).For more information on all extension-specific device information settings, see Device Information Settings for Rendering Extensions (Reporting Services). |
Befehle des Berichtsservers (rs:)
In der folgenden Tabelle werden die URL-Zugriffsparameter beschrieben, die rs vorangestellt sind und für den Berichtsserver verwendet werden.
| 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=GetChildrenSharePoint 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=RenderSharePoint 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 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.Native Beispiel für den Modus:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContentsSharePoint 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=GetResourceContentsSharePoint 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 Read Contents über die Berechtigung für ein veröffentlichtes Berichtselement verfügen, um diesen Wert zu verwenden. |
|
| 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=PDFBeispiel: 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 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 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 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 mit unterschiedlichen Berichtsparameterwerten mehrmals ausgeführt.) 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 reservierten SQL Server-Berichtsparameternamen beschrieben, die für das In SharePoint integrierte Berichts-Viewer-Webpart verwendet werden. Diese Parameternamen haben das Präfix rv:. Für Berichts-Viewer-Webparts kann auch der rs:ParameterLanguage -Parameter verwendet werden.
| 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. 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). 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 Schaltfläche Atom-Feed . 64 (0x40): die Menüoption Drucken in Aktionen. 128 (0x80): das Untermenü Exportieren in Aktionen. 256 (0x100): die Menüoption Mit dem Berichts-Generator öffnen in Aktionen. 512 (0x200): die Menüoption Abonnieren in Aktionen. 1024 (0x400): die Menüoption Neue Datenwarnung in Aktionen. Beispielsweise wird im SharePoint Modus nur die Schaltfläche "Zurück ", Textsuchsteuerelemente, Seitennavigationssteuerelemente und die Schaltfläche "Aktualisieren" angezeigt.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |