Freigeben über

  • Artikel

Parameter (Report Builder 3.0 und SSRS)

Mithilfe von Berichtsparametern können Sie Berichtsdaten steuern, eine Verbindung zwischen verwandten Berichten herstellen und die Berichtspräsentation anpassen. Um einen Bericht mit effektiver Parameterverwendung zu entwerfen, müssen Sie damit vertraut sein, wie Parameter und Datasetabfragen in Beziehung stehen, wie Parameter in Ausdrücke eingefügt werden und wie Parameter unabhängig von einer Berichtsdefinition auf dem Berichtsserver oder auf der SharePoint-Website verwaltet werden.

Berichtsparameter können wie folgt erstellt werden:

  • Erstellen Sie ein Dataset, oder fügen Sie ein Dataset hinzu (eingebettet oder freigegeben), das eine Abfrage mit Abfragevariablen besitzt.

  • Erstellen Sie im Berichtsdatenbereich manuell einen Parameter.

  • Fügen Sie einen Berichtsteil hinzu, der Verweise auf einen Parameter oder ein freigegebenes Dataset mit Variablen beinhaltet.

Nach dem Veröffentlichen eines Berichts können Parameter unabhängig von der Berichtsdefinition verwaltet werden. Sie können auch mehrere Parametersätze für denselben Bericht erstellen. Weitere Informationen finden Sie unter Festlegen von Parametereigenschaften für einen publizierten Bericht und Hinzufügen, Ändern und Löschen von verknüpften Berichten.

Auf der Berichts-Viewer-Symbolleiste werden alle Parameter angezeigt, sodass ein Benutzer interaktiv Werte angeben kann. In der folgenden Abbildung wird der Parameterbereich für einen Bericht veranschaulicht, der über die Parameter "@StartDate", "@EndDate", "@Subcategory" und "@ShowAllRows" verfügt:

Parameter auf der Berichts-Viewer-Symbolleiste

  1. Parameterbereich   Auf der Berichts-Viewer-Symbolleiste werden für jeden Parameter eine Eingabeaufforderung und ein Standardwert angezeigt. Das Parameterlayout auf der Symbolleiste wird automatisch formatiert. Die Reihenfolge richtet sich nach der Reihenfolge, in der die Parameter im Berichtsdatenbereich angezeigt werden.

  2. Parameter "@StartDate" und "@EndDate"   Der Parameter "@StartDate" entspricht dem DateTime-Datentyp. Neben dem Textfeld wird die Eingabeaufforderung "Startdatum" angezeigt. Geben Sie zum Ändern des Datums ein neues Datum in das Textfeld ein, oder verwenden Sie das Kalendersteuerelement.

    Der Parameter "@EndDate" wird neben "@StartDate" angezeigt.

  3. Parameter "@Subcategory"   Der Parameter "@Subcategory" entspricht dem Text-Datentyp. Da für "@Subcategory" eine Liste mit verfügbaren Werten vorhanden ist, werden in einer Dropdownliste gültige Werte angezeigt. Werte müssen aus dieser Liste ausgewählt werden. Da "@Subcategory" mehrwertig ist, wird die Option Alles auswählen angezeigt, mit der Sie die Auswahl aller Werte in der Liste aufheben oder alle Werte in der Liste auswählen können.

  4. Parameter "@ShowAllRows"   Der Parameter "@ShowAllRows" entspricht dem Boolean-Datentyp. Geben Sie mithilfe der Optionsfelder entweder True oder False an.

  5. Handle "Parameterbereich ein-/ausblenden"   Klicken Sie auf der Berichts-Viewer-Symbolleiste auf diesen Pfeil, um den Parameterbereich anzuzeigen oder auszublenden.

  6. Schaltfläche "Parameter"   Klicken Sie in der Berichts-Generator-Vorschau im Menüband auf die Schaltfläche Parameter, um den Parameterbereich anzuzeigen oder auszublenden.

  7. Schaltfläche "Bericht anzeigen"   Klicken Sie auf der Berichts-Viewer-Symbolleiste auf Bericht anzeigen, um nach der Eingabe von Parameterwerten den Bericht auszuführen. Wurden für alle Parameter Standardwerte festgelegt, wird der Bericht beim erstmaligen Anzeigen automatisch ausgeführt.

Weitere Informationen zur direkten Verwendung von Parametern finden Sie unter Lernprogramm: Hinzufügen eines Parameters zu einem Bericht (Berichts-Generator 3.0), Lernprogramm: Hinzufügen von Parametern zu einem Bericht (SSRS) oder Report Samples (Report Builder 3.0 and SSRS) (in englischer Sprache).

HinweisHinweis

Parameter können als separater Berichtsteil für Datenbereiche veröffentlicht werden, die über abhängige Datasets mit Parametern verfügen. Obwohl Parameter als Berichtsteil aufgelistet werden, können Berichtsteile Berichten nicht direkt hinzugefügt werden. Fügen Sie stattdessen den Berichtsteil hinzu. Alle erforderlichen Berichtsparameter werden automatisch aus Datasetabfragen generiert, die im Berichtsteil enthalten sind oder auf die durch den Berichtsteil verwiesen wird. Weitere Informationen zu Berichtsteilen finden Sie unter Berichtsteile (Report Builder 3.0) und Berichtsteile im Berichts-Designer (SSRS).
HinweisHinweis

Sie können Berichtsdefinitionen (RDL) in Berichts-Generator 3.0 und im Berichts-Designer in Business Intelligence Development Studio erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Berichts-Generator 3.0 (SSRS) im Web auf microsoft.com.

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.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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.

SicherheitshinweisSicherheitshinweis
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).

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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).

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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:

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurü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.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurück zum Anfang