Parameter (Report Builder 3.0 und SSRS)

In diesem Artikel

Allgemeine Verwendungsmöglichkeiten für Parameter

Parametertypen

Verwenden von Berichtsparametern

Verwenden von Datasetparametern

Kaskadierende Parameter

Übergeben von Parametern an Drillthrough oder Unterberichte

Verwalten von Parametern auf einem Berichtsserver oder einer SharePoint-Website

In diesem Abschnitt

Verwandte Themen

Allgemeine Verwendungsmöglichkeiten für Parameter

Im Folgenden sind einige der häufigsten Verwendungsmöglichkeiten für Parameter aufgeführt:

• Ermöglichen der Angabe von Werten durch Benutzer, um die Daten in einem Bericht anzupassen. Beispiel: Angabe von zwei Parametern (Start- und Enddatum) für Umsatzdaten.

• Ermöglichen der Angabe von Werte durch Benutzer, um die Darstellung eines Berichts anzupassen. Beispiel: Angabe eines booleschen Parameters, um anzugeben, ob alle geschachtelten Zeilengruppen in einer Tabelle erweitert oder reduziert werden sollen.

• Erstellen einer Dropdownliste mit auswählbaren Werten, sodass ein Benutzer nur einen gültigen Wert auswählen kann.

• Erstellen eines Standardwerts für jeden Parameter, sodass der Bericht beim erstmaligen Anzeigen automatisch ausgeführt wird.

• Erstellen kaskadierender Werte, sodass die Dropdownliste für einen Parameter einen Satz gültiger Werte enthält, der auf der Auswahl für einen vorherigen Parameter basiert. Dadurch lassen sich tausende Parameterwerte nach und nach zu einer überschaubare Anzahl filtern.

• Anpassen von Parametersätzen für mehrere Benutzer. Erstellen Sie auf der Grundlage eines Verkaufsberichts auf dem Berichtsserver zwei verknüpfte Berichte. In einem der verknüpften Berichte werden vordefinierte Parameterwerte für Vertriebsmitarbeiter, im anderen vordefinierte Parameterwerte für Verkaufsmanager verwendet. Für beide Berichte wird die gleiche Berichtsdefinition verwendet.

• Ermöglichen des Filterns von Daten aus einem freigegebenen Dataset durch die Benutzer. Wenn Sie einem Bericht ein freigegebenes Dataset hinzufügen, kann die Abfrage nicht geändert werden. Im Bericht können Sie einen Datasetfilter mit einem Verweis auf einen von Ihnen erstellten Berichtsparameter hinzufügen.

Zurück zum Anfang

Parametertypen

Berichte enthalten zwei Arten von Parametern: Datasetparameter und Berichtsparameter.

• Datasetparameter   Ein Datasetparameter für ein eingebettetes Dataset oder ein freigegebenes Dataset wird automatisch für jede Abfragevariable im Datasetabfragebefehl erstellt. Einige Abfrage-Designer verfügen über einen Bereich, um angewendete Filter auf Basis von Feldnamen hinzuzufügen, sowie über eine Option zum Hinzufügen eines Datasetparameters auf der Grundlage des Feldnamens.

  Datasetparameter werden konfiguriert, nachdem die Datasetabfrage definiert wurde. Für jeden Datasetparameter können unabhängig Standardwerte angegeben werden. Wenn Sie einem Bericht ein freigegebenes Dataset hinzufügen, können als "Intern" markierte Datasetparameter im Bericht nicht überschrieben werden. Nicht als "Intern" markierte Datasetparameter können überschrieben werden. Darüber hinaus können auch zusätzliche Parameter erstellt werden. Weitere Informationen finden Sie in diesem Thema unter Verwenden von Datasetparametern.

• Berichtsparameter   Für jeden Datasetparameter wird automatisch ein Berichtsparameter erstellt. Berichtsparameter können aber auch manuell erstellt werden. Sie können Berichtsparameter so konfigurieren, dass ein Benutzer interaktiv Werte eingeben kann, um den Inhalt oder die Darstellung eines Berichts anzupassen. Berichtsparameter können auch so konfiguriert werden, dass vorkonfigurierte Werte nicht vom Benutzer geändert werden können. Berichtsparameter werden unabhängig von einem veröffentlichten Bericht auf dem Berichtsserver verwaltet. Weitere Informationen finden Sie in diesem Thema unter Verwenden von Berichtsparametern.

  Ein Berichtsparameter kann auch getrennt vom Bericht als Berichtsteil gespeichert werden. Berichtsteile werden auf dem Berichtsserver gespeichert und können von anderen Benutzern in deren Berichten verwendet werden. Berichtsteile, bei denen es sich um Parameter handelt, können nicht vom Berichtsserver aus verwaltet werden. In der Berichtsteilgalerie können Sie nach Parametern suchen und sie nach dem Hinzufügen in Ihrem Bericht konfigurieren. Weitere Informationen finden Sie unter Berichtsteile (Report Builder 3.0).

In der Regel werden Sie mit Berichtsparametern arbeiten.

Zurück zum Anfang

Verwenden von Berichtsparametern

Die häufigste Verwendung von Parametern besteht darin, von Datasetabfragen abgerufene Berichtsdaten zu variieren. In diesem Szenario werden Benutzer beim Erstellen des Berichts zur Eingabe eines oder mehrerer Werte aufgefordert, und die Datasetabfrage ruft nur die Daten ab, die angefordert werden. Die Datasetabfrage enthält Abfrageparameter, und der Berichtsprozessor erstellt automatisch Berichtsparameter, die indirekt mit den Abfrageparametern verknüpft sind.

Standardmäßig wird für automatisch erstellte Parameter ein automatisch generierter Name, eine automatisch generierte Eingabeaufforderung und ein automatisch generierter Datentyp verwendet. Die Berichtsparametereigenschaften können im Dialogfeld "Berichtseigenschaften" im Bereich "Berichtsdaten" geändert werden. Die folgende Tabelle enthält die Eigenschaften, die für die einzelnen Parameter festgelegt werden können:

Eigenschaft	Beschreibung
Name	Geben Sie einen Namen für den Parameter ein. (Beachten Sie dabei die Groß- und Kleinschreibung.) Der Name muss mit einem Buchstaben beginnen und Buchstaben, Zahlen und einen Unterstrich (_) umfassen. Er darf keine Leerzeichen enthalten. Bei automatisch generierten Parametern stimmt der Name mit dem Abfrageparameter in der Datasetabfrage überein. Manuell erstellte Parameter ähneln standardmäßig der Zeichenfolge "ReportParameter1".
Eingabeaufforderung	Der Text, der auf der Berichts-Viewer-Symbolleiste neben dem Parameter angezeigt wird.
Datentyp	Bei einem Berichtsparameter muss es sich um einen der folgenden Datentypen handeln: Text, Integer, Float, DateTime, Boolean. Der Datentyp bestimmt die Darstellung eines Berichtsparameters auf der Berichts-Viewer-Symbolleiste. Der Datentyp kann auch von Bedeutung sein, wenn Sie Ausdrücke mit einem Verweis auf den Parameter erstellen.
Leeren Wert zulassen	Aktivieren Sie diese Option, wenn als Wert für den Parameter eine leere Zeichenfolge zulässig sein soll. Wenn Sie für einen Parameter gültige Werte angeben und möchten, dass ein leerer Wert zu den gültigen Werten zählt, muss der Wert zusammen mit den anderen Werten angegeben werden. Durch Aktivieren dieser Option wird den verfügbaren Werten nicht automatisch ein leerer Wert hinzugefügt.
NULL-Wert zulassen	Aktivieren Sie diese Option, wenn für den Parameter ein NULL-Wert zulässig sein soll. Wenn Sie für einen Parameter gültige Werte angeben und möchten, dass NULL zu den gültigen Werten zählt, muss der Wert zusammen mit den anderen Werten angegeben werden. Durch Aktivieren dieser Option wird den verfügbaren Werten nicht automatisch ein NULL-Wert hinzugefügt.
Mehrere Werte zulassen	Geben Sie verfügbare Werte an, um eine Dropdownliste zu erstellen, aus der die Benutzer auswählen können. Damit können Sie sicherstellen, dass in der Datasetabfrage nur gültige Werte übermittelt werden. Aktivieren Sie diese Option, wenn für den Parameter mehrere Werte aus einer Dropdownliste zulässig sein können. NULL-Werte sind nicht zulässig. Wenn diese Option ausgewählt ist, werden der Liste der verfügbaren Werte in einer Parameter-Dropdownliste Kontrollkästchen hinzugefügt. Am Anfang der Liste befindet sich ein Kontrollkästchen für die Option Alles auswählen. Von den Benutzern können die gewünschten Werte ausgewählt werden. Wenn sich die Daten, auf denen die Werte basieren, häufig ändern, ist die Liste, die dem Benutzer angezeigt wird, möglicherweise nicht auf dem neuesten Stand.
Sichtbar	Aktivieren Sie diese Option, damit der Berichtsparameter bei Ausführung des Berichts oben im Bericht angezeigt wird. Diese Option ermöglicht es Benutzern, Parameterwerte zur Laufzeit auszuwählen.
Ausgeblendet	Aktivieren Sie diese Option, um den Berichtsparameter im Bericht auszublenden. Die Berichtsparameterwerte können auf eine Berichts-URL, in einer Abonnementdefinition oder auf dem Berichtsserver mit dem Berichts-Manager festgelegt werden.
Intern	Aktivieren Sie diese Option, um den Berichtsparameter auszublenden. Der Berichtsparameter kann nur in der Berichtsdefinition angezeigt werden.
Verfügbare Werte	Wenn Sie für einen Parameter verfügbare Werte angegeben haben, werden die gültigen Werte immer als Dropdownliste angezeigt. Wenn Sie also beispielsweise verfügbare Werte für einen DateTime-Parameter angeben, wird im Parameterbereich anstelle eines Kalendersteuerelements eine Dropdownliste mit Datumsangaben angezeigt. Zur Gewährleistung der Konsistenz einer Liste mit Werten zwischen dem Bericht und den Unterberichten können Sie eine Option für die Datenquelle festlegen, sodass für alle Abfragen in den Datasets, die dieser Datenquelle zugeordnet sind, eine einzelne Transaktion verwendet wird. Sicherheitshinweis Verwenden Sie in einem Bericht, der einen Parameter vom Datentyp Text enthält, eine Liste der verfügbaren Werte (auch: Liste der gültigen Werte), und stellen Sie sicher, dass Benutzer, die den Bericht ausführen, nur über die Berechtigungen zum Anzeigen der Daten im Bericht verfügen. Weitere Informationen finden Sie unter Sicherheit (Berichts-Generator 3.0).
Standardwerte	Legen Sie Standardwerte aus einer Abfrage oder aus einer statischen Liste fest. Besitzt jeder Parameter einen Standardwert, wird der Bericht beim erstmaligen Anzeigen automatisch ausgeführt.
Erweitert	Legen Sie einen Wert fest, mit dem angegeben wird, ob sich dieser Parameter direkt oder indirekt auf die Daten in einen Bericht auswirkt. Auf dem Berichtsserver wird dieser Wert verwendet, um Cacheoptionen für Berichte und Berichtsdaten zu bestimmen. Weitere Informationen finden Sie unter Berichtsparametereigenschaften (Dialogfeld), Erweitert (Berichts-Generator 3.0).

Zurück zum Anfang

Verwenden von Datasetparametern

Beim Erstellen einer Abfrage in einem Abfrage-Designer werden Abfrageparameter definiert. Bei einigen Datenerweiterungen kann ausgewählt werden, welche Felder als Parameter einbezogen werden sollen. Bei anderen Datenerweiterungen werden Abfragevariablen im Abfragebefehl identifiziert. Für jede Abfragevariable wird automatisch ein Abfrageparameter erstellt.

Nicht alle Datenquellen unterstützen Abfrageparameter. Wenn Daten nicht an der Quelle gefiltert werden können, können Sie Berichtsparameter verwenden, um Benutzern das Filtern von Daten zu ermöglichen, nachdem diese für den Bericht abgerufen wurden. Obgleich alle Abfrageparameter über entsprechende Berichtsparameter verfügen, können Berichtsparameter auch unabhängig definiert werden. Mit Berichtsparametern kann auch die Darstellung oder Organisation eines Berichts geändert werden, nachdem die Daten abgerufen wurden.

Um Daten in der Datasetabfrage zu filtern, können Sie eine Einschränkungsklausel einschließen, mit der die abgerufenen Daten begrenzt werden. Geben Sie dazu die Werte ein, die im Resultset eingeschlossen oder daraus ausgeschlossen werden sollen.

Verwenden Sie den Abfrage-Designer in Verbindung mit einer Datenquelle, um eine parametrisierte Abfrage zu erstellen.

• Im Falle von Transact-SQL-Abfragen unterstützen verschiedene Datenquellen eine unterschiedliche Parametersyntax. Unterstützt werden Parameter, die in der Abfrage anhand der Position oder des Namens identifiziert werden. Weitere Informationen finden Sie in den Themen zu spezifischen externen Datenquellentypen unter Hinzufügen von Daten zu einem Bericht (Report Builder 3.0 und SSRS). Im relationalen Abfrage-Designer müssen Sie die Parameteroption für einen Filter auswählen, um eine parametrisierte Abfrage zu erstellen. Weitere Informationen finden Sie unter Benutzeroberfläche des relationalen Abfrage-Designers (Berichts-Generator 3.0).

• Für Abfragen, die auf einer mehrdimensionalen Datenquelle wie Microsoft SQL Server Analysis Services, SAP NetWeaver BI oder Hyperion Essbase basieren, können Sie angeben, ob ein Parameter auf Basis eines Filters erstellt werden soll, den Sie im Abfrage-Designer angeben. Weitere Informationen finden Sie unter Abfrage-Designer (Berichts-Generator 3.0) im Thema über den entsprechenden Abfrage-Designer für die Datenerweiterung.

Zurück zum Anfang

Kaskadierende Parameter

Sie können kaskadierende Parameter erstellen. Dabei wählt der Benutzer einen Wert für jeden Parameter in einer bestimmten Reihenfolge aus. Jede Auswahl schränkt nach und nach die Werte für den nächsten Parameter ein. Kaskadierende Parameter können die mögliche Auswahl von Tausenden von Elementen auf eine Anzahl reduzieren, die problemlos zu handhaben ist. Beispiel: Ein Benutzer wählt eine Produktkategorie aus, trifft eine Auswahl in der Liste der verfügbaren Produkte für diese Kategorie und wählt anschließend Größe und Farbe aus.

Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen von kaskadierenden Parametern zu einem Bericht (Report Builder 3.0 und SSRS).

Zurück zum Anfang

Übergeben von Parametern an Drillthrough und Unterberichte

Parameter dienen dazu, Berichte mit Unterberichten und Drillthroughberichten zu verknüpfen. Diese Berichtsparameter können ausgeblendet sein, wobei die korrekten Daten für den verknüpften Bericht mithilfe von Werten im Hauptbericht ausgewählt werden, oder sie können für den Benutzer zur Laufzeit sichtbar sein.

Weitere Informationen finden Sie unter Verwenden von Parametern zum Verbinden mit anderen Berichten (Report Builder 3.0 und SSRS).

Verwalten von Parametern auf einem Berichtsserver oder einer SharePoint-Website

Nach dem Veröffentlichen eines Berichts können Parameter unabhängig von der Berichtsdefinition verwaltet werden. Je nachdem, wie Sie den Parameter im Bericht zur Entwurfszeit konfigurieren, können Berichtsserveradministratoren viele Parametereigenschaften für einen Bericht oder ein freigegebenes Dataset ändern. Wenn Sie einen Bericht entwerfen, der zum Zwischenspeichern oder für Abonnements geplant werden soll, gelten für die Parameter unter Umständen weitere Anforderungen. Weitere Information finden Sie in den folgenden Themen der Dokumentation zu Reporting Services in der SQL Server-Onlinedokumentation:

• **Zwischengespeicherte Berichte.   **Zum Erstellen eines Cacheplans für einen Bericht muss jeder Parameter über einen Standardwert verfügen. Weitere Informationen finden Sie unter Zwischenspeichern von Berichten in Reporting Services.

• **Zwischengespeicherte freigegebene Datasets.   **Zum Erstellen eines Cacheplans für ein freigegebenes Dataset muss jeder Parameter über einen Standardwert verfügen. Weitere Informationen finden Sie unter Zwischenspeichern von Berichten in Reporting Services.

• Verknüpfte Berichte.   Sie können verknüpfte Berichte mit voreingestellten Parameterwerten erstellen, um Daten für verschiedene Zielgruppen zu filtern. Weitere Informationen finden Sie unter Hinzufügen, Ändern und Löschen von verknüpften Berichten.

• Berichtsabonnements.   Sie können Parameterwerte angeben, um Daten unter Verwendung von Abonnements zu filtern und Berichte unter Verwendung von Abonnements zu übermitteln. Weitere Informationen finden Sie unter Festlegen von Parametern in Abonnements sowie unter Abonnement und Übermittlung [Reporting Services].

• URL-Zugriff.   Sie können Parameterwerte in einer URL zu einem Bericht angeben. Sie können auch Berichte ausführen und Parameterwerte mit URL-Zugriff angeben. Weitere Informationen finden Sie unter URL-Zugriff.

Zurück zum Anfang

Themen zur Vorgehensweise

In diesem Abschnitt finden Sie Prozeduren, in denen Schritt für Schritt das Arbeiten mit Parametern und Filtern erläutert wird.

• Vorgehensweise: Hinzufügen, Ändern oder Löschen von Berichtsparametern (Report Builder 3.0 und SSRS)

• Vorgehensweise: Hinzufügen, Ändern oder Löschen von verfügbaren Werten für einen Berichtsparameter (Berichts-Generator 3.0 und SSRS)

• Vorgehensweise: Hinzufügen, Ändern oder Löschen von Standardwerten für einen Berichtsparameter (Report Builder 3.0 und SSRS)

• Vorgehensweise: Ändern der Reihenfolge von Berichtsparametern (Report Builder 3.0 und SSRS)

• Vorgehensweise: Hinzufügen von kaskadierenden Parametern zu einem Bericht (Report Builder 3.0 und SSRS)

• Vorgehensweise: Hinzufügen eines Filters zu einem Dataset (Berichts-Generator 3.0 und SSRS)

Zurück zum Anfang

In diesem Abschnitt

Verwenden von ein- und mehrwertigen Parametern (Berichts-Generator 3.0 und SSRS)

Verwenden von Parametern zum Verbinden mit anderen Berichten (Report Builder 3.0 und SSRS)

Zurück zum Anfang

Verwandte Abschnitte

Verwenden von Verweisen auf Parameterauflistungen in Ausdrücken (Report Builder 3.0 und SSRS)

Verwenden von Ausdrücken (Berichts-Generator 3.0 und SSRS)

Ausdrücke (Report Builder 3.0 und SSRS)

Berichtsparametereigenschaften (Dialogfeld), Allgemein (Berichts-Generator 3.0)

Berichtsparametereigenschaften (Dialogfeld), Allgemein

Dataseteigenschaften (Dialogfeld), Abfrage (Berichts-Generator 3.0)

Dataseteigenschaften (Dialogfeld), Abfrage

Abfrage-Designer (Berichts-Generator 3.0)

Abfrage-Designer in Reporting Services

Sicherheit (Berichts-Generator 3.0)

Zurück zum Anfang

Siehe auch

Konzepte