Ausführen eines parametrisierten Berichts

Aktualisiert: 17. Juli 2006

Bei einem parametrisierten Bericht handelt es sich um einen Bericht, der Eingabewerte zum Abschluss der Berichtsverarbeitung verwendet. Vertraute Beispiele hierfür sind parametrisierte Berichte, die nach einem Regionalwert, einer Produktkategorie oder einem Bezeichner filtern. Mithilfe von Parametern wird in der Regel eine Abfrage ausgeführt, die Daten für den Bericht auswählt. Beim Verwalten oder Ausführen eines parametrisierten Berichts müssen Ihnen die Auswirkungen bekannt sein, die die Auswahl von Parametern auf den Bericht hat.

Hinweis:

Ein Berichtsautor definiert die in einem Bericht verwendeten Parameter. Nach der Veröffentlichung des Berichts können Sie bestimmte Parametereigenschaften ändern, um festzulegen, welche Werte verwendet und wie diese abgerufen werden. Weitere Informationen zum Erstellen von Parametern finden Sie unter Verwenden von Parametern in Reporting Services. Weitere Informationen zum Verwalten von Parametern finden Sie unter Festlegen von Parametereigenschaften für einen publizierten Bericht.

Speichern und Eingeben von Parameterwerten

Zum Abrufen eines Parameterwertes zur Laufzeit können Sie einen Standardwert im Bericht speichern oder den Benutzer zum Eingeben oder Auswählen eines Wertes auffordern. Das Speichern eines Parameterwertes in einem Bericht ist hilfreich, wenn der Bericht stets mit einem bestimmten Wert verarbeitet werden soll. Wenn z. B. eine regionale Niederlassung über eine dedizierte Website verfügt, können Sie einen regionalen Umsatzbericht auf der Website hosten, für den stets eine bestimmte Regionalkennzahl verwendet wird.

Sie können auch die Benutzer beim Öffnen des Berichts zum Eingeben oder Auswählen eines Wertes auffordern. Wenn Sie für einen Bericht festlegen, dass zur Eingabe von Parameterwerten aufgefordert wird, werden Eingabefelder zur Eingabe von Werten durch den Benutzer bereitgestellt. Nachdem der Benutzer die Werte eingegeben hat, klickt er auf Bericht anzeigen, um den Bericht auszuführen. Wenn die Werte gültig sind, wird der Bericht angezeigt. Wenn die Werte nicht gültig sind, wird entweder eine Fehlermeldung oder ein leerer Bericht angezeigt. Bei der Verwendung gespeicherter Parameterwerte wird der Bericht ohne Eingabefelder oder die Schaltfläche Bericht anzeigen geöffnet. Alle Benutzer, die den Bericht ausführen, verwenden denselben Parameterwert.

Falls der Bericht abfragebasierte Parameter enthält und sich jeder Benutzer für die Datenquelle anmelden muss, wird der Benutzer zur Eingabe von Anmeldeinformationen aufgefordert, ehe die Parametereingabefelder auf der Seite angezeigt werden. In diesem Fall müssen die Anmeldeinformationen bereitgestellt werden, um Parameterwerte abzurufen.

Zum Ausführen eines parametrisierten Berichts müssen Sie normalerweise die einzugebenden Werte kennen. Ein Bericht kann Dropdownlisten mit gültigen Werten enthalten, aus denen Sie auswählen können.

Verwenden Sie den Berichts-Manager oder SQL Server Management Studio, um Parametereigenschaften (einschließlich Standardwerte) in einem veröffentlichten Bericht festzulegen. Weitere Informationen finden Sie unter Erstellen von Berichtsparametern und Festlegen von Berichtsparametereigenschaften und Festlegen von Parametern in Abonnements.

Festlegen von Parametern in einem Berichts-URL

Ein URL ist eine weitere Möglichkeit, um einen parametrisierten Bericht auszuführen. Sie können einen oder mehrere Parameter in codierten Name-Wert-Paaren angeben, die durch ein kaufmännisches Und-Zeichen (&) voneinander getrennt sind.

Für Nullparameter gilt eine spezielle Syntax. Für einen Nullwert müssen Sie isnull angeben. Wenn Sie für einen Parameter einen Nullwert angeben, werden alle anderen für diesen Parameter angegebenen Werte ignoriert. Das folgende Beispiel zeigt mehrere Parameter für Nullwerte und konstante Werte:

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

Für Parameter mit mehreren Werten wird der Parametername wiederholt. z. B.:

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

Für Boolean-Parameter wird der Wert 0 oder 1 angegeben.

Float-Parameter müssen das Dezimaltrennzeichen des Servergebietsschemas aufweisen.

DateTime-Parameter müssen im Format YYYY-MM-DDTHH:MM:SS basierend auf dem International Organization for Standardization (ISO) 8601-Standard angegeben werden. Weitere Informationen zum Festlegen von Parametern in einem URL finden Sie unter Using URL Access Parameters.

Änderungsverlauf

Siehe auch

Aufgaben

Vorgehensweise: Öffnen und Schließen eines Berichts (Berichts-Manager)
Vorgehensweise: Öffnen und Schließen eines Berichts (Management Studio)

Konzepte

Festlegen von Parametereigenschaften für einen publizierten Bericht
Parametrisierte Berichte
Ansehen von Berichten
Suchen und Anzeigen von Berichten im Berichts-Manager

Andere Ressourcen

Verwalten und Verwenden von veröffentlichten Berichten

Hilfe und Informationen

Informationsquellen für SQL Server 2005