Verwenden von URL-Zugriffsparametern
Sie können die folgenden Parameter als Teil einer URL verwenden, um das Erscheinungsbild 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.
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 auslassen, wird die Symbolleiste automatisch für Renderingformate angezeigt, von denen sie unterstützt wird. Der Standardwert dieses Parameters ist true. .gif "Wichtiger Hinweis") Wichtig
rc:Toolbar=false funktioniert nicht für URL-Zugriffszeichenfolgen, bei denen anstelle eines Domänennamens eine IP-Adresse verwendet wird, um einen auf einer SharePoint-Website gehosteten Bericht als Ziel anzugeben.
|
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 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 Werts, 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 einer Berichtsverlaufs-Momentaufnahme. Weitere Informationen finden Sie unter Rendern von Berichtsverlaufs-Snapshots mit URL-Zugriff. |
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. |
Befehle des Berichts-Viewer-Webparts
In der folgenden Tabelle werden die für SQL Server reservierten Berichtsparameternamen beschrieben, die zum Auswählen des Berichts-Viewer-Webparts verwendet werden, wenn Reporting Services in Windows SharePoint Services (WSS) 3.0 oder höher sowie in Microsoft Office SharePoint Server 2007 oder höher integriert ist. 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:
|
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. |
ParamMode |
Steuert, wie der Eingabeaufforderungsbereich für Parameter des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. Gültige Werte sind:
Der Standardwert ist Full. |
DocMapMode |
Steuert, wie der Dokumentstrukturbereich des Berichts-Viewer-Webparts in der Ganzseitenansicht angezeigt wird. Gültige Werte sind:
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. |
ToolBarItemsDisplayMode |
Steuert, welche Symbolleistenelemente angezeigt werden. Dies ist ein bitweiser Enumerationswert. Um ein Symbolleistenelement einzuschließen, fügen Sie seinen Wert dem Gesamtwert hinzu. Beispiel: Wenn kein Menü Aktionen angezeigt werden soll, verwenden Sie "rv:ToolBarItemsDisplayMode=63" (oder 0x3F), was 1+2+4+8+16+32 entspricht. Wenn nur Elemente des Menüs Aktionen angezeigt werden sollen, verwenden Sie "rv:ToolBarItemsDisplayMode=960 "(oder 0x3C0). Gültige Werte sind:
Der Standardwert ist -1 (Anzeige aller Symbolleistenelemente). |
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