Lektion 3: Hinzufügen von Parametern zur Auswahl mehrerer Werte in einer Liste (Berichts-Generator 2.0)

1. Klicken Sie im Berichtsdatenbereich mit der rechten Maustaste auf das Dataset Dataset1, und klicken Sie dann auf Abfrage.

   Der textbasierte Abfrage-Designer wird geöffnet.

2. Ersetzen Sie den Text durch Eingabe der folgenden Abfrage im Textfeld:

   SELECT
     SH.OrderDate
     ,DATENAME(weekday, SH.OrderDate) as Weekday
     ,SH.SalesOrderNumber
     ,SD.OrderQty
     ,SD.LineTotal
     ,P.Name AS [Product]
     ,PS.Name AS [Subcategory]
   FROM Sales.SalesPerson SP 
     INNER JOIN Sales.SalesOrderHeader AS SH 
         ON SP.BusinessEntityID = SH.SalesPersonID
     INNER JOIN Sales.SalesOrderDetail AS SD 
        ON SH.SalesOrderID = SD.SalesOrderID
     INNER JOIN Production.Product AS P
      ON SD.ProductID = P.ProductID
     INNER JOIN Production.ProductSubcategory AS PS
      ON PS.ProductSubcategoryID = P.ProductSubcategoryID
     INNER JOIN Production.ProductCategory AS PC
      ON PC.ProductCategoryID = PS.ProductCategoryID
   WHERE PC.Name = 'Clothing' 
      AND (SH.OrderDate BETWEEN (@StartDate) AND (@EndDate))
         AND SH.SalesPersonID IN (@BusinessPersonID)
   

   Im Unterschied zur vorangehenden Abfrage wurde hier eine Bedingung von Gleichheit = in Enthaltensein INgeändert:

   AND SH.SalesPersonID IN (@BusinessPersonID)
   

3. Klicken Sie auf die Schaltfläche Ausführen (!). Wenn Sie nach den Abfrageparametern gefragt werden, geben Sie die Werte mithilfe der folgenden Tabelle ein. Das Testen mehrwertiger Parameter wird im Abfrage-Designer nicht unterstützt.

   @StartDate	20010101
   @EndDate	20030101
   @BusinessPersonID	290

4. Klicken Sie auf OK. 

   Das Resultset wird für den Vertriebsmitarbeiter Ranjit Varkey Chudukatil mit BusinessPersonID = 290 angezeigt.

1. Erweitern Sie im Bereich für die Berichtsdaten den Knoten Parameter, und doppelklicken Sie auf den Parameter BusinessPersonID.

2. Wählen Sie die Option Mehrere Werte zulassen aus.

3. Klicken Sie auf OK. 

4. Klicken Sie auf Vorschau. Der Bericht wird automatisch ausgeführt. Die Namen aller Vertriebsmitarbeiter werden in einer Dropdownliste für BusinessPersonID aufgeführt.

Hinweis
Der Wert (Alles auswählen) wird als erster Wert in einer Dropdownliste der verfügbaren Werte für einen mehrwertigen Parameter angegeben. Mit diesem Kontrollkästchen können Sie alle Werte auswählen bzw. die Auswahl aller Werte aufheben.

1. Wechseln Sie zur Entwurfsansicht.

2. Klicken Sie auf der Symbolleiste des Berichtsdatenbereichs auf Neu und anschließend auf Dataset. Das Dialogfeld Dataseteigenschaften wird angezeigt.

3. Geben Sie in das Feld Name die Bezeichnung WeekDaysfromQuery ein.

4. Überprüfen Sie unter Abfragetyp, ob Text ausgewählt ist.

5. Klicken Sie auf Abfrage-Designer und dann auf Als Text bearbeiten.

6. Fügen Sie folgende Abfrage im Abfragebereich ein:

   SET DATEFIRST 1;
   SELECT DISTINCT 
      DATEPART(weekday, S.OrderDate) as WeekdayNumber,
      DATENAME(weekday, S.OrderDate) as Weekday
      FROM Sales.SalesOrderHeader S
   Order by WeekdayNumber
   

7. Klicken Sie auf der Symbolleiste des Abfrage-Designers auf die Schaltfläche Ausführen (!). Im Resultset werden Ordinalzahlen (Ordnungszahlen) und Wochentage angezeigt.

8. Klicken Sie zweimal auf OK, um das Dialogfeld Dataseteigenschaften zu schließen.

   Das Dataset WeekDaysfromQuery wird im Bereich für die Berichtsdaten angezeigt.

1. Erweitern Sie im Bereich für die Berichtsdaten den Knoten Parameter, und doppelklicken Sie auf DayoftheWeek. Das Dialogfeld Berichtsparametereigenschaften wird geöffnet.

2. Wählen Sie Mehrere Werte zulassen aus.

3. Klicken Sie auf Verfügbare Werte.

4. Wählen Sie Werte aus Abfrage abrufen aus.

5. Wählen Sie unter Dataset den Eintrag WeekDaysfromQuery aus der Dropdownliste aus.

6. Wählen Sie unter Wertfeld den Eintrag WeekdayNumber aus der Dropdownliste aus.

7. Wählen Sie unter Bezeichnungsfeld den Eintrag Weekday aus der Dropdownliste aus.

Wenn der Benutzer Parameterwerte auswählt, wählt er unter den Bezeichnungen aus, der Bericht verwendet jedoch die Werte. Dies ist wichtig, wenn Sie Standardwerte oder einen Filter festlegen. Die Werte müssen die ganzzahligen Werte für das WeekdayNumber-Feld sein.

1. Klicken Sie auf Standardwerte.

2. Wählen Sie Werte angeben aus.

3. Klicken Sie auf Hinzufügen.

4. Ersetzen Sie in WertFriday durch 6. Weil die Werte aus einem Dataset stammen, das sowohl eine Wochentagszahl als auch einen Wochentagsnamen angibt, muss der Standardwert die Wochentagszahl angeben. Der Wert 6 stellt Saturday dar.

5. Klicken Sie auf Hinzufügen.

6. Geben Sie im Feld Wert den Wert 7 ein. Dieser Wert stellt Sunday dar.

7. Klicken Sie auf OK. 

   Bevor Sie eine Vorschau für den Bericht anzeigen können, müssen Sie den Filterausdruck für den Tabellendatenbereich so ändern, dass der IN-Operator verwendet wird, da der DayoftheWeek-Parameter mehrere Werte annehmen kann.

1. Klicken Sie im Berichtsdatenbereich mit der rechten Maustaste auf Dataset1, und klicken Sie dann auf Dataseteigenschaften.

2. Klicken Sie auf Filter. In Lektion 1 wurde bereits ein Filter für DayoftheWeek hinzugefügt.

3. Vergewissern Sie sich, dass die Spalte Ausdruck (von der Dropdownliste) den Wert [Weekday] enthält.

4. Ändern Sie den Operator vom Gleichheitszeichen (=) in In.

5. Geben Sie im Feld Wert[@DayoftheWeek.Label] ein.

   Geben Sie die Parameterbezeichnung ein, damit der Name des Wochentags mit dem Bezeichnungsfeld und nicht mit dem numerischen Feld für den Wochentag verglichen wird.

6. Klicken Sie auf OK. 

   Der Filter für die Tabelle ist nun so festgelegt, dass der Wert des Felds Weekday mithilfe des In-Operators mit dem Label des Parameters DayoftheWeek verglichen wird. Wenn Sie mehrere Werte für den Berichtsparameter auswählen, testet der Filter jede Zeile der Tabelle daraufhin, ob das Feld Weekday in der DayoftheWeek-Auflistung vorhanden ist.

7. Klicken Sie auf Ausführen, um den Bericht in der Vorschau anzuzeigen. Im Bericht wird der Berichtsparameter DaysoftheWeek mit den Standardwerten Saturday und Sunday angezeigt, den Bezeichnungen für die Standardwerte, die Sie angegeben haben. Verwenden Sie die Dropdownliste, um mehrere Werte für den DayoftheWeek-Parameter auszuwählen.