Verwenden von URL-Zugriffsparametern
Sie können die folgenden Parameter als Teil einer URL verwenden, um die Anzeige der 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.
Befehle des HTML-Viewers
In der folgenden Tabelle werden die URL-Zugriffsparameter beschrieben, die mit einem 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. |
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 einen Wert von Collapsed festlegen, wird der Parameterbereich nicht angezeigt, kann aber vom Endbenutzer ein-/ausgeschaltet werden. Der Standardwert dieses Parameters ist true. |
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 Versionen von Microsoft Internet Explorer, die älter als Internet Explorer 5.0 sind, sowie allen nicht von Microsoft bereitgestellten Browsern ignoriert. Der Standardwert dieses Parameters ist 100. |
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 die Seite 1 des Berichts angezeigt. Der Standardwert dieses Parameters ist 1. |
StartFind |
Legt den letzten Abschnitt für die Suche fest. Der Standardwert dieses Parameters ist die letzte Seite des Berichts. |
EndFind |
Legt die Seitenzahl der letzten Seite für die Suche fest. Beispiel: Ein Wert von 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 Parameter StartFind. |
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. |
Sie können weitere Parameter in einer URL übergeben, um die Ausgabe für HTML-Rendering weiterzuleiten. Weitere Informationen finden Sie unter HTML-Geräteinformationseinstellungen.
Befehle des Berichtsservers
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 |
Legt den letzten Abschnitt für die Suche fest. Der Standardwert dieses Parameters ist die letzte Seite des Berichts. |
Format |
Legt das Format fest, in dem der Bericht gerendert wird. Häufig verwendete Werte sind: HTML3.2, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML und NULL. Weitere Informationen finden Sie unter Angeben eines Renderingformats in einer URL. |
ParameterLanguage |
Bietet eine Sprache für in einer URL übergebene Parameter, die von der Browsersprache unabhängig ist. Der Standardwert ist die Browsersprache. Bei dem Wert kann es sich um einen Kulturwert wie en-us oder de-de. handeln. |
Snapshot |
Rendert einen Bericht anhand eines Berichtsverlaufs-Snapshots. Weitere Informationen finden Sie unter Rendern von Berichtsverlaufs-Snapshots mit URL-Zugriff. |
PersistStream |
Rendert einen Bericht in einem einzigen permanenten Datenstrom. Dieser Parameter wird vom Bildrenderer verwendet, um den gerenderten Bericht segmentweise zu übertragen. Wenn Sie diesen Parameter in einer URL-Zugriffszeichenfolge verwendet haben, verwenden Sie dieselbe URL-Zugriffszeichenfolge mit dem Unterschied, dass Sie den PersistStream-Parameter durch den GetNextStream-Parameter ersetzen, um das nächste Segment im permanenten Datenstrom abzurufen. Dieser URL-Befehl gibt zum Schluss einen 0-Byte-Datenstrom zurück, um das Ende des permanenten Datenstroms anzuzeigen. Der Standardwert lautet false. |
GetNextStream |
Ruft das nächste Datensegment in einem permanenten Datenstrom ab, auf den mit dem PersistStream-Parameter zugegriffen wurde. Weitere Informationen finden Sie in der Beschreibung unter PersistStream. Der Standardwert lautet false. |
Befehle des Berichts-Viewer-Webparts
In der folgenden Tabelle werden die neuen für SQL Server 2008 reservierten Berichtsparameternamen beschrieben, die zum Auswählen des Berichts-Viewer-Webparts verwendet werden, wenn Reporting Services in Windows SharePoint Services (WSS) 3.0 oder in MicrosoftOffice SharePoint Server (MOSS) 2007 integriert ist. Diese Parameternamen haben das Präfix rv:. Für Bericht-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:
|
HeaderArea |
Steuert die Anzeige der Kopfzeile des Bericht-Viewer-Webparts. Der Standardwert ist Full. Folgende Werte sind möglich:
|
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 |
Beispiele
Im folgenden Beispiel wird die Symbolleiste des HTML-Viewers ausgeblendet, indem der Wert des Parameters rc:Toolbar auf false festgelegt wird:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false
Im folgenden Beispiel wird ein hartcodierter Parameter übergeben und das Eingabefeld für vom Benutzer angegebene Parameter ausgeblendet:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002
Im folgenden Beispiel wird die Zoomeigenschaft des Berichts mithilfe des rc:Zoom-Parameters auf Page Width festgelegt:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width
Im folgenden Beispiel wird der Abschnitt 13 des Berichts ein-/ausgeblendet:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13