Freigeben über


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.

Wichtiger HinweisWichtig
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:

  • Full: Zeigt die vollständige Symbolleiste an.

  • Navigation: Zeigt nur die Paginierung in der Symbolleiste an.

  • None: Zeigt die Symbolleiste nicht an.

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.

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: Der Eingabeaufforderungsbereich für Parameter wird angezeigt.

  • Collapsed: Der Eingabeaufforderungsbereich für Parameter wird reduziert.

  • Hidden: Der Eingabeaufforderungsbereich für Parameter wird ausgeblendet.

Der Standardwert ist Full.

DocMapMode

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

  • Full: Der Dokumentstrukturbereich wird angezeigt.

  • Collapsed: Der Dokumentstrukturbereich wird reduziert.

  • Hidden: Der Dokumentstrukturbereich wird ausgeblendet.

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:

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

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

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

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

  5. 16 (0x10): Listenfeld Zoom

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

  7. 64 (0x40): Option Drucken im Menü Aktionen

  8. 128 (0x80): Untermenü Exportieren im Menü Aktionen

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

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

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

Siehe auch

Verweis

Andere Ressourcen