Lernprogramm: Hinzufügen eines Parameters zu einem Bericht (Berichts-Generator 3.0)

Fügen Sie dem Bericht einen Parameter hinzu, um Benutzern das Filtern von Berichtsdaten aus der Datenquelle oder im Bericht zu ermöglichen. Berichtsparameter werden automatisch für jeden Abfrageparameter erstellt, den Sie in eine Datasetabfrage einschließen. Der Parameterdatentyp bestimmt, wie der Parameter auf der Symbolleiste der Berichtsansicht angezeigt wird.

Parametrisierter Verkaufsbericht

Lernziele

In diesem Lernprogramm lernen Sie Folgendes:

  1. Erstellen eines Matrixberichts und eines Datasets mit dem Tabellen- oder Matrix-Assistenten

  2. Organisieren von Daten und Auswählen des Layouts und Formats mit dem Tabellen- oder Matrix-Assistenten

  3. Hinzufügen eines Abfrageparameters zum Erstellen eines Berichtsparameters

  4. Ändern des Standarddatentyps und anderer Eigenschaften für einen Berichtsparameter

    1. Hinzufügen eines Datasets, um verfügbare Werte und Anzeigenamen anzuzeigen

    2. Angeben verfügbarer Werte zum Erstellen einer Dropdownliste von Werten

    3. Angeben von Standardwerten zur automatischen Ausführung des Berichts

    4. Suchen nach Werten in einem Dataset mit Name-Wert-Paaren

  5. Anzeigen des ausgewählten Parameterwerts im Bericht

  6. Verwenden des Berichtsparameters in einem Filter

  7. Ändern des Berichtsparameters in einen mehrwertigen Parameter

  8. Hinzufügen eines booleschen Parameters für bedingte Sichtbarkeit

  9. Hinzufügen eines Berichtstitels

  10. Speichern des Berichts

HinweisHinweis

In diesem Lernprogramm werden die Schritte für den Assistenten in einem Verfahren zusammengefasst. Im ersten Lernprogramm dieser Reihe erhalten Sie detaillierte Anweisungen zum Navigieren zu einem Berichtsserver, zum Auswählen einer Datenquelle sowie zum Erstellen eines Datasets: Lernprogramm: Erstellen eines einfachen Tabellenberichts (Berichts-Generator 3.0).

Ungefähre Dauer dieses Lernprogramms: 25 Minuten.

Anforderungen

Informationen zu den Anforderungen finden Sie unter Voraussetzungen für Lernprogramme (Report Builder 3.0).

1. Erstellen eines Matrixberichts und eines Datasets mit dem Tabellen- oder Matrix-Assistenten

Erstellen Sie einen Matrixbericht, eine Datenquelle und ein Dataset.

HinweisHinweis

In diesem Lernprogramm sind die Datenwerte in der Abfrage enthalten, sodass keine externe Datenquelle benötigt wird. Die Abfrage ist daher relativ lang. In einer Geschäftsumgebung wären die Daten nicht in der Abfrage enthalten. Dieses Szenario dient nur zu Lernzwecken.

So erstellen Sie einen neuen Matrixbericht

  1. Klicken Sie auf Start, zeigen Sie auf Programme und Microsoft SQL Server 2008 R2 Report Builder 3.0, und klicken Sie dann auf Report Builder 3.0.

    Das Dialogfeld Erste Schritte wird angezeigt.

    HinweisHinweis

    Falls das Dialogfeld Erste Schritte nicht angezeigt wird, klicken Sie auf die Schaltfläche Berichts-Generator und anschließend auf Neu.

  2. Vergewissern Sie sich, dass im linken Bereich Bericht ausgewählt ist.

  3. Klicken Sie im rechten Bereich auf Tabellen- oder Matrix-Assistent.

  4. Klicken Sie auf Erstellen.

  5. Klicken Sie auf der Seite Dataset auswählen auf Dataset erstellen.

  6. Klicken Sie auf Weiter.

  7. Wählen Sie auf der Seite Verbindung mit einer Datenquelle auswählen eine Datenquelle vom Typ SQL Server aus. Wählen Sie in der Liste eine Datenquelle aus, oder navigieren Sie zum Berichtsserver, um eine Datenquelle auszuwählen.

  8. Klicken Sie auf Weiter.

  9. Klicken Sie auf der Seite Abfrage entwerfen auf Als Text bearbeiten.

  10. Fügen Sie die folgende Abfrage in den Abfragebereich ein:

    ;WITH CTE (StoreID, Subcategory, Quantity) 
    AS (
    SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity
    UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity
    UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity
    UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity
    UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity
    UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity
    UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity
    UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity
    UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity
    UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity
    UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)
    SELECT StoreID, Subcategory, Quantity
    FROM CTE
    

    Durch diese Abfrage werden die Ergebnisse mehrerer Transact-SQL-SELECT-Anweisungen in einem allgemeinen Tabellenausdruck kombiniert, um Werte anzugeben, die auf vereinfachten Daten aus der Contoso-Beispieldatenbank basieren. Die Contoso-Umsatzdaten stellen internationale Umsatzdaten für Verbrauchsgüter dar. In diesem Lernprogramm werden Umsatzdaten für Kameras verwendet. Die Unterkategorien sind Digitalkameras, digitale Spiegelreflexkameras (SLR), Camcorder und Zubehör.

    Zu den in der Abfrage angegebenen Spaltennamen zählen eine Geschäfts-ID, eine Verkaufselement-Unterkategorie und die bestellte Menge für Verkaufsaufträge von drei Geschäften. In dieser Abfrage ist der Geschäftsname nicht Teil des Resultsets. An späterer Stelle dieses Lernprogramms suchen Sie in einem separaten Dataset nach dem Namen des Geschäfts, das der Geschäfts-ID entspricht.

    Diese Abfrage enthält keine Abfrageparameter. Abfrageparameter werden später in diesem Lernprogramm hinzugefügt.

  11. Klicken Sie auf der Symbolleiste des Abfrage-Designers auf Ausführen (!). Das Resultset enthält 11 Datenzeilen, in denen die Menge verkaufter Artikel in jeder Unterkategorie für vier Geschäfte angezeigt wird, und die folgenden Spalten: "StoreID", "Subcategory" und "Quantity".

  12. Klicken Sie auf Weiter.

2. Organisieren von Daten und Auswählen des Layouts und Formats mit dem Tabellen- oder Matrix-Assistenten

Stellen Sie mithilfe des Assistenten einen Startentwurf für die Anzeige von Daten bereit. Im Vorschaufenster des Assistenten können Sie das Ergebnis der Datengruppierung visualisieren, bevor Sie den Tabellen- oder Matrixentwurf abschließen.

So ordnen Sie Daten in Gruppen an

  1. Ziehen Sie "Subcategory" auf der Seite Felder anordnen in Zeilengruppen.

  2. Ziehen Sie "StoreID" in Spaltengruppen.

  3. Ziehen Sie "Quantity" in Werte.

    Sie haben die Werte für die verkaufte Menge in Zeilen organisiert und nach Unterkategorie gruppiert. Für jedes Geschäft wird eine Spalte angezeigt.

  4. Klicken Sie auf Weiter.

  5. Vergewissern Sie sich, dass auf der Seite Layout auswählen unter Optionen die Option Teil- und Gesamtergebnisse anzeigen ausgewählt ist.

    Wenn Sie den Bericht ausführen, werden in der letzten Spalte die Gesamtmenge jeder Unterkategorie für alle Geschäfte und in der letzten Zeile die Gesamtmenge für alle Unterkategorien für jedes Geschäft angezeigt.

  6. Klicken Sie auf Weiter.

  7. Wählen Sie auf der Seite Format auswählen im Bereich "Formate" ein Format aus.

  8. Klicken Sie auf Fertig stellen.

    Die Matrix wird der Entwurfsoberfläche hinzugefügt. Die Matrix enthält drei Spalten und drei Zeilen. Die Zellen in der ersten Zeile enthalten "Subcategory", "[StoreID]" und "Total". Die Zellen in der zweiten Zeile enthalten Ausdrücke, die die Unterkategorie, die Menge verkaufter Artikel für jedes Geschäft und die Gesamtmenge in jeder Unterkategorie für alle Geschäfte darstellen. Die Zellen in der letzten Zeile enthalten das Gesamtergebnis für jedes Geschäft.

  9. Klicken Sie in die Matrix, zeigen Sie auf den Rand der ersten Spalte, und vergrößern Sie die Spaltenbreite mithilfe des Ziehpunkts.

  10. Klicken Sie auf Ausführen, um eine Vorschau des Berichts anzuzeigen.

Der Bericht wird auf dem Berichtsserver ausgeführt. Titel und Zeitpunkt der Verarbeitung des Berichts werden angezeigt.

In diesem Szenario wird in den Spaltenüberschriften die Geschäfts-ID, aber nicht der Geschäftsnamen angezeigt. Später fügen Sie einen Ausdruck hinzu, um in einem Dataset, das Geschäfts-ID/Geschäftsname-Paare enthält, nach dem Geschäftsnamen suchen.

3. Hinzufügen eines Abfrageparameters zum Erstellen eines Berichtsparameters

Wenn Sie einer Abfrage einen Abfrageparameter hinzufügen, erstellt der Berichts-Generator automatisch einen eindeutigen Berichtsparameter mit Standardeigenschaften für Name, Eingabe und Datentyp.

So fügen Sie einen Abfrageparameter hinzu

  1. Wechseln Sie in die Entwurfsansicht.

  2. Erweitern Sie im Bereich "Berichtsdaten" den Ordner Datasets, klicken Sie mit der rechten Maustaste auf DataSet1, und klicken Sie dann auf Abfrage.

  3. Fügen Sie die folgende Transact-SQL-WHERE-Klausel als letzte Zeile in der Abfrage hinzu:

    WHERE StoreID = (@StoreID)
    

    Die WHERE-Klausel beschränkt die abgerufenen Daten auf die Geschäfts-ID, die vom Abfrageparameter @StoreID angegeben wird.

  4. Klicken Sie auf der Symbolleiste des Abfrage-Designers auf Ausführen (!). Das Dialogfeld Abfrageparameter definieren wird geöffnet, und Sie werden aufgefordert, einen Wert für den Abfrageparameter @StoreID einzugeben.

  5. Geben Sie im Feld Parameterwert die Zahl 200 ein.

  6. Klicken Sie auf OK.

    Im Resultset werden die verkauften Mengen für Zubehör, Camcorder und digitale SLR-Kameras für die Geschäfts-ID 200 angezeigt.

  7. Klicken Sie auf OK.

  8. Erweitern Sie im Bereich "Berichtsdaten" den Ordner Parameter.

Beachten Sie, dass jetzt ein Berichtsparameter mit dem Namen @StoreID verfügbar ist. Standardmäßig ist der Parameter vom Datentyp Text. Da es sich bei der Geschäfts-ID um eine ganze Zahl handelt, ändern Sie den Datentyp im nächsten Verfahren in "Integer".

4. Ändern des Standarddatentyps und anderer Eigenschaften für einen Berichtsparameter

Nachdem Sie einen Berichtsparameter erstellt haben, können Sie die Standardwerte für Eigenschaften anpassen.

So ändern Sie den Standarddatentyp für einen Berichtsparameter

  1. Klicken Sie im Bereich "Berichtsdaten" unter dem Knoten Parameter mit der rechten Maustaste auf @StoreID, und klicken Sie dann auf Parametereigenschaften.

  2. Geben Sie im Feld "Eingabeaufforderung" Geschäfts-ID? ein. Dieser Text wird auf der Berichts-Viewer-Symbolleiste angezeigt, wenn Sie den Bericht ausführen.

  3. Wählen Sie in der Dropdownliste Datentyp die Option Ganze Zahl aus.

  4. Nehmen Sie die verbleibenden Standardwerte im Dialogfeld an.

  5. Klicken Sie auf OK.

  6. Zeigen Sie eine Vorschau des Berichts an. Im Berichts-Viewer wird die Eingabeaufforderung für @StoreID angezeigt.

  7. Geben Sie auf der Berichts-Viewer-Symbolleiste neben "Geschäfts-ID" die Zahl 200 ein, und klicken dann auf Bericht anzeigen.

4a. Hinzufügen eines Datasets, um verfügbare Werte und Anzeigenamen anzuzeigen

Um sicherzustellen dass ein Benutzer nur gültige Werte für einen Parameter eingeben kann, können Sie eine Dropdownliste von Werten erstellen. Die Werte können aus einem Dataset oder einer von Ihnen angegebenen Liste stammen. Verfügbare Werte müssen aus einem Dataset stammen, dessen Abfrage keinen Verweis auf den Parameter enthält.

So erstellen Sie ein Dataset für gültige Werte für einen Parameter

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie im Bereich "Berichtsdaten" mit der rechten Maustaste auf den Ordner Datasets, und klicken Sie anschließend auf Dataset hinzufügen.

  3. Geben Sie im Feld Name den Namen Geschäfte ein.

  4. Aktivieren Sie die Option Verwenden Sie ein in den eigenen Bericht eingebettetes Dataset.

  5. Wählen Sie unter Datenquelle in der Dropdownliste die Datenquelle aus, die Sie im ersten Verfahren erstellt haben.

  6. Vergewissern Sie sich, dass unter Abfragetyp die Option Text ausgewählt ist.

  7. Fügen Sie unter Abfrage folgende Abfrage ein:

    SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName
    UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName
    UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName
    UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName
    
  8. Klicken Sie auf OK.

    Im Bereich "Berichtsdaten" werden die Felder "StoreID" und "StoreName" unter dem Datasetknoten Geschäfte angezeigt.

4b. Angeben verfügbarer Werte zum Erstellen einer Dropdownliste von Werten

Nachdem Sie ein Dataset erstellt haben, um verfügbare Werte bereitzustellen, müssen Sie die Berichtseigenschaften ändern, um das Dataset und das Feld anzugeben, aus denen die Dropdownliste gültiger Werte auf der Berichts-Viewer-Symbolleiste aufgefüllt wird.

So stellen Sie verfügbare Werte für einen Parameter aus einem Dataset bereit

  1. Klicken Sie im Bereich "Berichtsdaten" mit der rechten Maustaste auf den Parameter@StoreID, und klicken Sie dann auf Parametereigenschaften.

  2. Klicken Sie auf Verfügbare Werte und dann auf Werte aus Abfrage abrufen.

  3. Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag Stores.

  4. Wählen Sie unter Wertfeld den Eintrag StoreID aus der Dropdownliste aus.

  5. Wählen Sie unter Bezeichnungsfeld den Eintrag StoreName aus der Dropdownliste aus. Das Bezeichnungsfeld gibt den Anzeigenamen für den Wert an.

  6. Klicken Sie auf Allgemein.

  7. Geben Sie im Feld "Eingabeaufforderung" Geschäftsname? ein.

    Dem Benutzer steht jetzt anstelle einer Liste von Geschäfts-IDs eine Liste von Geschäftsnamen zur Verfügung, um seine Auswahl zu treffen. Beachten Sie, dass der Parameterdatentyp weiterhin Integer lautet, da der Parameter nicht auf dem Geschäftsnamen, sondern auf der Geschäfts-ID basiert.

  8. Klicken Sie auf OK.

  9. Zeigen Sie eine Vorschau des Berichts an.

    Auf der Berichts-Viewer-Symbolleiste wird das Parametertextfeld jetzt als Dropdownliste <Einen Wert auswählen> angezeigt.

  10. Wählen Sie in der Dropdownliste "Contoso Catalog Store" aus, und klicken Sie dann auf Bericht anzeigen.

Im Bericht werden die verkauften Mengen für Zubehör, Camcorder und digitale SLR-Kameras für die Geschäfts-ID 200 angezeigt.

4c. Angeben von Standardwerten zur automatischen Ausführung des Berichts

Sie können einen Standardwert für jeden Berichtsparameter angeben, damit der Bericht automatisch ausgeführt wird.

So geben Sie einen Standardwert aus einem Dataset an

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie im Bereich "Berichtsdaten" mit der rechten Maustaste auf @StoreID, und klicken Sie dann auf Parametereigenschaften.

  3. Klicken Sie auf Standardwerte und dann auf Werte aus Abfrage abrufen.

  4. Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag Stores.

  5. Wählen Sie unter Wertfeld den Eintrag StoreID aus der Dropdownliste aus.

  6. Klicken Sie auf OK.

  7. Zeigen Sie eine Vorschau des Berichts an.

Für @StoreID wird im Berichts-Viewer der Wert "Contoso North America Online Store" angezeigt. Dies ist der erste Wert aus dem Resultset für das Dataset Geschäfte. Im Bericht wird die verkaufte Menge von Digitalkameras für die Geschäfts-ID 199 angezeigt.

So geben Sie einen benutzerdefinierten Standardwert an

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie im Bereich "Berichtsdaten" mit der rechten Maustaste auf @StoreID, und klicken Sie dann auf Parametereigenschaften.

  3. Klicken Sie auf Standardwerte und Werte angeben, und klicken Sie dann auf Hinzufügen. Eine neue Wertzeile wird hinzugefügt.

  4. Geben Sie im Feld Wert den Wert 200 ein.

  5. Klicken Sie auf OK.

  6. Zeigen Sie eine Vorschau des Berichts an.

Für @StoreID wird im Berichts-Viewer der Wert "Contoso Catalog Store" angezeigt. Dies ist der Anzeigename für die Geschäfts-ID 200. Im Bericht werden die verkauften Mengen für Zubehör, Camcorder und digitale SLR-Kameras für die Geschäfts-ID 200 angezeigt.

4d. Suchen nach Werten in einem Dataset mit Name-Wert-Paaren

Ein Dataset kann sowohl den Bezeichner als auch das entsprechende Namensfeld enthalten. Wenn Sie nur einen Bezeichner haben, können Sie in einem von Ihnen erstellten Dataset, das Name-Wert-Paare enthält, nach dem entsprechenden Namen suchen.

So suchen Sie nach einem Wert in einem Dataset

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie auf der Entwurfsoberfläche in der Matrix im ersten Zeilenspaltenheader mit der rechten Maustaste auf [StoreID], und klicken Sie dann auf Ausdruck.

  3. Löschen Sie im Ausdrucksbereich den gesamten Text mit Ausnahme des Anfangs equals (=).

  4. Erweitern Sie unter Kategorie den Knoten Allgemeine Funktionen, und klicken Sie auf Sonstiges. Im Bereich "Element" wird ein Satz von Funktionen angezeigt.

  5. Doppelklicken Sie in "Element" auf Suche. Im Ausdrucksbereich wird =Lookup( angezeigt. Der Bereich "Beispiel" enthält ein Beispiel für die Suchsyntax.

  6. Geben Sie den folgenden Ausdruck ein: =Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")

    Die Suchfunktion empfängt den Wert für "StoreID", sucht im Dataset "Geschäfte" danach und gibt den "StoreName"-Wert zurück.

  7. Klicken Sie auf OK.

    Der Spaltenheader für das Geschäft enthält den Anzeigetext für einen komplexen Ausdruck: <<Ausdr>>.

  8. Zeigen Sie eine Vorschau des Berichts an.

Im Textfeld oben auf jeder Seite wird anstelle der Geschäfts-ID der Geschäftsname angezeigt.

5. Anzeigen des ausgewählten Parameterwerts im Bericht

Wenn ein Benutzer Fragen zu einem Bericht hat, ist es hilfreich, die ausgewählten Parameterwerte zu kennen. Die vom Benutzer ausgewählten Werte können für jeden Parameter im Bericht beibehalten werden. Sie können die Parameter z. B. in einem Textfeld im Seitenfuß anzeigen.

So zeigen Sie den ausgewählten Parameterwert und die Bezeichnung in einem Seitenfuß an

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie mit der rechten Maustaste auf den Seitenfuß, zeigen Sie auf Einfügen, und klicken Sie dann auf Textfeld. Ziehen Sie das Textfeld neben das Textfeld mit dem Zeitstempel. Vergrößern Sie die Breite des Textfelds mit dem seitlichen Ziehpunkt.

  3. Ziehen Sie im Bereich "Berichtsdaten" den Parameter @StoreID in das Textfeld. Das Textfeld zeigt [@StoreID] an.

  4. Um die Parameterbezeichnung anzuzeigen, klicken Sie auf das Textfeld, bis der Einfügecursor nach dem vorhandenen Ausdruck angezeigt wird, geben Sie ein Leerzeichen ein, und ziehen Sie dann eine andere Kopie des Parameters im Bereich "Berichtsdaten" in das Textfeld. Im Textfeld wird [@StoreID] [@StoreID] angezeigt.

  5. Klicken Sie mit der rechten Maustaste auf den ersten Ausdruck, und klicken Sie dann auf Ausdruck. Das Dialogfeld Ausdruck wird geöffnet. Ersetzen Sie den Text Value durch Label.

  6. Klicken Sie auf OK.

    Der folgende Text wird angezeigt: [@StoreID.Label] [@StoreID].

  7. Zeigen Sie eine Vorschau des Berichts an.

6. Verwenden des Berichtsparameters in einem Filter

Mithilfe von Filtern können die in einem Bericht zu verwendenden Daten gesteuert werden, nachdem sie aus einer externen Datenquelle abgerufen wurden. Schließen Sie den Berichtsparameter in einen Filter für die Matrix ein, um Benutzern das Steuern der angezeigten Daten zu ermöglichen.

So geben Sie einen Parameter in einem Matrixfilter an

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie mit der rechten Maustaste auf einen Zeilen- oder Spaltenheaderziehpunkt in der Matrix, und klicken Sie dann auf Tablix-Eigenschaften.

  3. Klicken Sie auf Filter, und klicken Sie anschließend auf Hinzufügen. Eine neue Filterzeile wird angezeigt.

  4. Wählen Sie im Feld Ausdruck aus der Dropdownliste das Datasetfeld StoreID aus. Der Datentyp zeigt Ganze Zahl an. Wenn der Ausdruckswert ein Datasetfeld ist, wird der Datentyp automatisch festgelegt.

  5. Vergewissern Sie sich, dass unter Operator die Option equals (=) ausgewählt ist.

  6. Geben Sie im Feld Wert[@StoreID] ein. [@StoreID] ist die einfache Ausdruckssyntax, die =Parameters!StoreID.Value darstellt.

  7. Klicken Sie auf OK.

  8. Zeigen Sie eine Vorschau des Berichts an.

    In der Matrix werden nur Daten für "Contoso Catalog Store" angezeigt.

  9. Wählen Sie auf der Berichts-Viewer-Symbolleiste für Geschäftsname? die Option Contoso Asia Online Store aus, und klicken Sie dann auf Bericht anzeigen.

In der Matrix werden Daten für das ausgewählte Geschäft angezeigt.

7. Ändern des Berichtsparameters in einen mehrwertigen Parameter

Wenn Sie einen einwertigen Parameter in einen mehrwertigen Parameter ändern möchten, müssen Sie die Abfrage und alle Ausdrücke, die einen Verweis auf den Parameter enthalten (einschließlich Filter) ändern. Ein mehrwertiger Parameter ist ein Wertarray. In einer Datasetabfrage muss die Abfragesyntax überprüfen, ob ein Wert in einem Satz von Werten enthalten ist. In einem Berichtsausdruck greift die Ausdruckssyntax nicht auf einzelnen Wert, sondern auf ein Wertarray zu.

So ändern Sie einen einwertigen Parameter in einen mehrwertigen Parameter

  1. Wechseln Sie in die Entwurfsansicht.

  2. Klicken Sie im Bereich "Berichtsdaten" mit der rechten Maustaste auf @StoreID, und klicken Sie dann auf Parametereigenschaften.

  3. Aktivieren Sie Mehrere Werte zulassen.

  4. Klicken Sie auf OK.

  5. Erweitern Sie im Bereich "Berichtsdaten" den Ordner Datasets, klicken Sie mit der rechten Maustaste auf DataSet1, und klicken Sie dann auf Abfrage.

  6. Ändern Sie equals (=) in der Transact-SQLWHERE-Klausel in der letzten Zeile der Abfrage in IN:

    WHERE StoreID IN (@StoreID)
    

    Der IN-Operator testet, ob ein Wert in einem Satz von Werten enthalten ist.

  7. Klicken Sie auf OK.

  8. Klicken Sie mit der rechten Maustaste auf einen Zeilen- oder Spaltenheaderziehpunkt in der Matrix, und klicken Sie dann auf Tablix-Eigenschaften.

  9. Klicken Sie auf Filter.

  10. Wählen Sie unter Operator die Option In aus.

  11. Klicken Sie auf OK.

  12. Löschen Sie im Textfeld, in dem der Parameter im Seitenfuß angezeigt wird, den gesamten Text.

  13. Klicken Sie mit der rechten Maustaste auf das Textfeld, und klicken Sie dann auf Ausdruck. Geben Sie den folgenden Ausdruck ein: =Join(Parameters!StoreID.Label, ", ")

    Durch diesen Ausdruck werden alle Geschäftsnamen, die der Benutzer ausgewählt hat, verkettet.

  14. Klicken Sie auf OK.

  15. Klicken Sie vor dem soeben erstellten Ausdruck in das Textfeld, und geben Sie dann Folgendes ein: "Ausgewählte Parameterwerte:".

  16. Zeigen Sie eine Vorschau des Berichts an.

  17. Klicken Sie auf die Dropdownliste neben "Geschäftsname?"

    Alle gültigen Werte werden neben einem Kontrollkästchen angezeigt.

  18. Klicken Sie auf Alles auswählen und dann auf Bericht anzeigen.

    Im Bericht wird die verkaufte Menge in allen Unterkategorien für alle Geschäfte angezeigt.

  19. Klicken Sie in der Dropdownliste auf Alles auswählen, um die Liste zu löschen, klicken Sie auf "Contoso Catalog Store" und "Contoso Asia Online Store" und dann auf Bericht anzeigen.

8. Hinzufügen eines booleschen Parameters für bedingte Sichtbarkeit

So fügen Sie einen booleschen Parameter hinzu

  1. Klicken Sie auf der Entwurfsoberfläche im Bereich "Berichtsdaten" mit der rechten Maustaste auf Parameter, und klicken Sie dann auf Parameter hinzufügen.

  2. Geben Sie im Feld Name "ShowSelections" ein.

  3. Geben Sie im Feld Eingabeaufforderung "Auswahl anzeigen?" ein.

  4. Klicken Sie unter Datentyp in der Dropdownliste auf Boolesch.

  5. Klicken Sie auf Standardwerte.

  6. Klicken Sie auf Wert angeben und dann auf Hinzufügen.

  7. Geben Sie im Feld Wert den Wert False ein.

  8. Klicken Sie auf OK.

So legen Sie die Sichtbarkeit basierend auf einem booleschen Parameter fest

  1. Klicken Sie auf der Entwurfsoberfläche mit der rechten Maustaste auf das Textfeld im Seitenfuß, in dem die Parameterwerte angezeigt werden, und klicken Sie dann auf Textfeldeigenschaften.

  2. Klicken Sie auf Sichtbarkeit.

  3. Aktivieren Sie die Option Je nach Ausdruck einblenden/ausblenden, und klicken Sie dann auf die Ausdrucksschaltfläche Fx.

  4. Geben Sie den folgenden Ausdruck ein: =Not Parameters!ShowSelections.Value

    Die Textfeldoption "Sichtbarkeit" wird durch die Hidden-Eigenschaft gesteuert. Wenden Sie den Not-Operator an, sodass die Hidden-Eigenschaft bei Auswahl des Parameters den Wert "False" hat und das Textfeld angezeigt wird.

  5. Klicken Sie auf OK.

  6. Klicken Sie auf OK.

  7. Zeigen Sie eine Vorschau des Berichts an.

    Das Textfeld mit der Parameterauswahl wird nicht angezeigt.

  8. Klicken Sie auf der Berichts-Viewer-Symbolleiste neben Auswahl anzeigen auf True.

  9. Zeigen Sie eine Vorschau des Berichts an.

Im Textfeld im Seitenfuß werden alle Geschäftsnamen angezeigt, die Sie ausgewählt haben.

9. Hinzufügen eines Berichtstitels

So fügen Sie einen Berichtstitel hinzu

  1. Klicken Sie auf der Entwurfsoberfläche auf Zum Hinzufügen eines Titels klicken.

  2. Geben Sie "Parametrisierte Produktumsätze" ein, und klicken Sie dann außerhalb des Textfelds.

10. Speichern des Berichts

So speichern Sie den Bericht auf einem Berichtsserver

  1. Klicken Sie auf die Schaltfläche Berichts-Generator und anschließend auf Speichern unter.

  2. Klicken Sie auf Letzte Sites und Server.

  3. Wählen Sie den Namen des Berichtsservers aus, auf dem Sie zum Speichern von Berichten berechtigt sind, oder geben Sie ihn ein.

    Die Meldung Verbindung mit Berichtsserver wird hergestellt wird angezeigt. Nachdem die Verbindung hergestellt wurde, sehen Sie den Inhalt des Berichtsordners, den der Berichtsserveradministrator als Standardspeicherort für Berichte angegeben hat.

  4. Ersetzen Sie im Feld Name den Standardnamen durch "Parametrisierter Umsatzbericht".

  5. Klicken Sie auf Speichern.

Der Bericht wird auf dem Berichtsserver gespeichert. Der Berichtsserver, mit dem Sie verbunden sind, wird in der Statusleiste unten im Fenster angezeigt.

Nächste Schritte

Damit ist die exemplarische Vorgehensweise zum Hinzufügen eines Parameters zum Bericht abgeschlossen. Weitere Informationen zu Parametern finden Sie unter Parameter (Report Builder 3.0 und SSRS).