Ausführen eines parametrisierten Berichts
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.
.gif "Hinweis") 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 Parameter (Report Builder 3.0 und SSRS). 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.
Um Parametereigenschaften (einschließlich Standardwerte) für einen veröffentlichten Bericht festzulegen, verwenden Sie den Berichts-Manager. Weitere Informationen finden Sie unter Parameter (Report Builder 3.0 und SSRS) und Festlegen von Parametern in Abonnements.
Festlegen von Parametern in einer Berichts-URL
Eine 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®ion=west&sales:isnull=true
Für Parameter mit mehreren Werten wird der Parametername wiederholt. z. B.:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders®ion=east®ion=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 einer URL finden Sie unter Verwenden von URL-Zugriffsparametern.
Siehe auch