{"id":55000261,"date":"2021-02-01T00:00:00","date_gmt":"2021-04-29T18:37:42","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=261"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Reporting_Services_Datasets_mit_Parametern","status":"publish","type":"post","link":"https:\/\/vbentwickler.de\/Reporting_Services_Datasets_mit_Parametern\/","title":{"rendered":"Reporting Services Datasets mit Parametern"},"content":{"rendered":"

\"\"<\/p>\n

Ein Dataset, das als Datenquelle eines Berichts der Reporting Services dient, ist selten statisch aufgebaut – also so, dass es immer alle Daten einer Tabelle oder Abfrage liefert oder einen bestimmten Teil. Stattdessen sollen Berichte oft Daten liefern, die sich auf einen bestimmten Zeitraum beziehen, auf einen bestimmten Kunden oder auch auf bestimmte Artikel oder Kategorien. In den bisherigen Artikeln haben wir erläutert, wie Sie Berichte auf Basis statischer Datenquellen erstellen. Der vorliegende Artikel fügt die Verwendung von Parametern mit hinzu, damit der Benutzer genau festlegen kann, welche Daten der von ihm gewählte Bericht liefern soll.<\/b><\/p>\n

Vorbereitung für diesen Artikel<\/h2>\n

Da wir uns explizit um den Einsatz von Parametern kümmern wollen, gehen wir von einem Visual Studio-Projekt des Typs Berichtsserverprojekt <\/b>namens DatasetMitParametern <\/b>aus.<\/p>\n

Diesem haben wir eine freigegebene Datenquelle namens AdventureWorks <\/b>auf Basis der SQL Server-Datenbank AdventureWorksLT2019 <\/b>hinzugefügt. Wo Sie diese Beispieldatenbank finden und wie Sie diese installieren, erfahren Sie im Artikel AdventureWorks: Schnelle Beispieldatenbank <\/b>(www.datenbankentwickler.net\/254)<\/b>.<\/p>\n

Dataset anlegen<\/h2>\n

Das Dataset für diesen Bericht legen wir als eingebettetes Dataset an. Damit erhalten wir zum Beispiel den Vorteil, dass die in diesem Dataset definierten Parameter direkt vom Bericht als solche erkannt werden.<\/p>\n

Bericht anlegen<\/h2>\n

Nun legen wir einen neuen Bericht namens SalesPerProduct.rdl <\/b>an. Diesem weisen wir die zuvor angelegte freigegebene Datenquelle AdventureWorks.rds <\/b>als Datenquelle zu und geben auch der neuen eingebetteten Datenquelle den Namen AdventureWorks<\/b>. <\/p>\n

Dann legen wir für den Bericht ein neues eingebettetes Dataset namens ProductsSalesOrders <\/b>an (siehe Bild 1). Das Dataset verwendet einige Felder der drei Tabellen Product<\/b>, SalesOrderDetail <\/b>und SalesOrderHeader <\/b>als Datenquelle. Damit haben wir ausreichend Daten zum Demonstrieren der Parameter-Funktionen der Reporting Services.<\/p>\n

\"Abfrage<\/p>\n

Bild 1: Abfrage für das Dataset ProductsSalesOrders<\/span><\/b><\/p>\n

Der Bereich Berichtsdaten <\/b>sieht anschließend wie in Bild 2 aus. <\/p>\n

\"Daten<\/p>\n

Bild 2: Daten für den Bericht<\/span><\/b><\/p>\n

Nun blenden wir die Toolbox ein und fügen dem Bericht ein Tabelle<\/b>-Element hinzu. Dann wechseln wir wieder zum Berichtsdaten-Bereich und ziehen einige Felder in die Tabelle, sodass diese wie in Bild 3 aussieht.<\/p>\n

\"Berichtsentwurf\"<\/p>\n

Bild 3: Berichtsentwurf<\/span><\/b><\/p>\n

Ein Wechsel in die Vorschauansicht liefert eine Liste der einzelnen Bestellpositionen (siehe Bild 4). Damit haben wir alles zusammen, um die angezeigten Datensätze nach verschiedenen Kriterien mit noch zu ermittelnden Parameterwerten zu filtern.<\/p>\n

\"Ausgabe<\/p>\n

Bild 4: Ausgabe der einzelnen Bestellpositionen<\/span><\/b><\/p>\n

Parameter zum Dataset hinzufügen<\/h2>\n

Der erste Schritt ist das Hinzufügen des Parameters zum Dataset. Dazu öffnen wir das Dataset per Doppelklick auf seinen Eintrag im Bereich Berichtsdaten.<\/p>\n

Im Bereich Abfrage <\/b>des Dialogs Dataseteigenschaften <\/b>finden wir im Feld Abfrage <\/b>die SQL-Abfrage. Diese erweitern wir wie in Bild 5 um die folgende WHERE<\/b>-Klausel:<\/p>\n

\"Integrieren<\/p>\n

Bild 5: Integrieren des Parameters im Abfrageausdruck<\/span><\/b><\/p>\n

WHERE SalesOrderDetail.ProductID = @ProductID<\/pre>\n
Um die Funktionsweise dieses Parameters auszuprobieren, klicken Sie auf die Schaltfläche Abfrage-Designer… <\/b>und öffnen so den Dialog Abfrage-Designer<\/b>. Hier finden Sie die neu hinzugefügte WHERE<\/b>-Klausel ebenfalls vor. Um diese auszuprobieren, betätigen Sie die Schaltfläche mit dem roten Ausrufezeichen. Dadurch erscheint der Dialog Abfrageparameter<\/b> (siehe Bild 6). Hier geben Sie den Wert ein, nach dem das Feld ProductID <\/b>gefiltert werden soll, zum Beispiel 991<\/b>.<\/p>\n
\"Eingabe<\/p>\n
Bild 6: Eingabe des Parameterwertes<\/span><\/b><\/p>\n
Der Abfrage-Designer zeigt dann im unteren Bereich alle passenden Datensätze an. Nun wollen wir dafür sorgen, dass der Parameter auch beim Anzeigen des Berichts abgefragt und berücksichtigt wird.<\/p>\n
Vorher werfen wir jedoch noch einen Blick auf den Bereich Berichtsdaten<\/b>. Hier finden wir nämlich nun einen neuen Eintrag namens [@] ProductID <\/b>vor (siehe Bild 7).<\/p>\n
\"Neuer<\/p>\n
Bild 7: Neuer Eintrag im Ordner Parameter<\/span><\/b><\/p>\n
Eigenschaften des neuen Parameters festlegen<\/h2>\n
Den neuen Parameter wollen wir direkt anpassen. Die Eigenschaften des neuen Parameters zeigen Sie an, indem Sie doppelt auf den Eintrag im Ordner Parameter <\/b>klicken. Dies öffnet den Dialog Berichtsparametereigenschaften<\/b> (siehe Bild 8).<\/p>\n
\"Eigenschaften<\/p>\n
Bild 8: Eigenschaften des neuen Parameters<\/span><\/b><\/p>\n
Der erste Bereich namens Allgemein <\/b>erwartet die folgenden Informationen:<\/p>\n