Artikel
03/30/2012

Lektion 4: Hinzufügen von kaskadierenden Parametern (SSRS)

Kaskadierende Parameter ermöglichen das Verwalten großer Berichtsdatenmengen. Bei kaskadierenden Parametern hängt die Liste der Werte für einen Parameter von dem Wert abhängt, der in vorangehenden Parametern ausgewählt wurde. Die Reihenfolge ist für kaskadierende Parameter wichtig, da die Datasetabfrage für einen Parameter weiter unten in der Liste Verweise auf Parameter weiter oben in der Liste enthält.

In dieser Lektion erstellen Sie einen Bericht mit einer Hauptdatasetabfrage, die drei Abfrageparameter für Kategorie, Unterkategorie und Produkt definiert. Außerdem definieren Sie drei weitere Datasets, um verfügbare Werte für jeden kaskadierenden Parameter bereitzustellen.

So fügen Sie einem geöffneten Berichtsserverprojekt einen neuen Bericht hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Berichte, zeigen Sie auf Hinzufügen, und klicken Sie auf Neues Element.
Klicken Sie im Dialogfeld Neues Element hinzufügen unter Vorlagen auf Bericht.
Geben Sie in das Feld Name den Namen CascadingParameters.rdl ein, und klicken Sie auf Hinzufügen.

Der Berichts-Designer wird geöffnet, und in der Entwurfsansicht wird die neue RDL-Datei angezeigt.

So erstellen Sie einen Verweis auf eine freigegebene Datenquelle

Klicken Sie im Berichtsdatenbereich auf Neu, und klicken Sie dann auf Datenquelle.
Geben Sie in das Feld Name den Wert AdventureWorks_Ref ein.
Wählen Sie Freigegebenen Datenquellenverweis verwenden aus.
Wählen Sie in der Dropdownliste den Eintrag AdventureWorks aus.
Klicken Sie auf OK.

So erstellen Sie das Hauptdataset mit einer Abfrage und Abfrageparametern

Klicken Sie im Bereich für die Berichtsdaten mit der rechten Maustaste auf die Datenquelle AdventureWorks_Ref und anschließend auf Dataset hinzufügen.
Geben Sie in das Feld Name den Namen SalesbyCategory ein.
Vergewissern Sie sich, dass unter Datenquelle die Option AdventureWorks_Ref ausgewählt ist.
Überprüfen Sie unter Abfragetyp, ob Text ausgewählt ist.
Klicken Sie unter dem Abfragebereich auf Abfrage-Designer.
Klicken Sie auf Als Text bearbeiten, um zum textbasierten Abfrage-Designer zu wechseln.

Fügen Sie die folgende Abfrage ein:

SELECT 
   PC.Name AS Category,
   PSC.Name AS Subcategory,
   P.Name AS Product,
   SOH.[OrderDate],
   SOH.SalesOrderNumber,
   SD.OrderQty, 
   SD.LineTotal
   FROM [Sales].[SalesPerson] SP 
      INNER JOIN [Sales].[SalesOrderHeader] SOH 
      ON SP.[BusinessEntityID] = SOH.[SalesPersonID]
      INNER JOIN Sales.SalesOrderDetail SD
      ON SD.SalesOrderID = SOH.SalesOrderID
      INNER JOIN Production.Product P
      ON SD.ProductID = P.ProductID
      INNER JOIN Production.ProductSubcategory PSC
      ON P.ProductSubcategoryID = PSC.ProductSubcategoryID
      INNER JOIN Production.ProductCategory PC
      ON PC.ProductCategoryID = PSC.ProductCategoryID
      WHERE (PC.Name = (@Category)
         AND PSC.Name = (@Subcategory)
         AND P.Name = (@Product))

Die Abfrage enthält nun die Abfrageparameter @Category, @Subcategory und @Product.

Klicken Sie auf Ausführen (!), um das Resultset anzuzeigen. Das Dialogfeld Abfrageparameter definieren wird geöffnet.
Geben Sie mithilfe der folgenden Tabelle in der Parameterwert-Spalte einen Wert für jeden Abfrageparameter ein.

Parametername

Parameterwert

@Category

Komponenten

@Subcategory

Brakes

@Product

Front Brakes
Klicken Sie auf OK.

Das Resultset enthält eine Liste von Bestellnummern für Vorderradbremsen, die nach Datum gruppiert sind.

Beim Ausführen der Abfrage wurde durch jeden Abfrageparameter ein entsprechender Berichtsparameter erzeugt. Klicken Sie zweimal auf OK, um den Abfrage-Designer und das Dialogfeld zu schließen.
(Optional) Erweitern Sie im Bereich für die Berichtsdaten den Knoten Parameter, und vergewissern Sie sich, dass folgende Berichtsparameter angezeigt werden: Category, Subcategory und Product.
(Optional) Der Wert der einzelnen Datasetabfrageparameter ist jeweils an einen Berichtsparameter mit dem gleichen Namen gebunden. Klicken Sie im Bereich für die Berichtsdaten mit der rechten Maustaste auf SalesbyCategory und anschließend auf Dataseteigenschaften, um dies zu überprüfen.
1. Klicken Sie auf Parameter.
2. Die Spalte Parametername sollte die Namen @Category, @Subcategory und @Product enthalten.
3. Die Spalte Parameterwert sollte die Werte [@Category], [@Subcategory] und [@Product] enthalten.
  
  Diese einfachen Ausdrücke beziehen sich auf die Berichtsparameter, die im Bereich für die Berichtsdaten angezeigt werden.

Parametername	Parameterwert
@Category	Komponenten
@Subcategory	Brakes
@Product	Front Brakes

Anschließend erstellen Sie ein Dataset, um Werte für die einzelnen Berichtsparameter zur Laufzeit bereitzustellen. Die Werte füllen die verfügbaren Werte auf und stellen Standardwerte bereit, damit der Bericht automatisch ausgeführt werden kann.

So definieren Sie ein Dataset mit gültigen Werten für einen Berichtsparameter

Klicken Sie im Bereich für die Berichtsdaten mit der rechten Maustaste auf AdventureWorks_Ref und anschließend auf Dataset hinzufügen.
Geben Sie im Feld Name den Wert CategoryValues ein.
Vergewissern Sie sich, dass unter Datenquelle die Option AdventureWorks_Ref ausgewählt ist.
Überprüfen Sie unter Abfragetyp, ob Text festgelegt ist.
Klicken Sie unter dem Bereich Abfrage auf Abfrage-Designer.
Klicken Sie auf Als Text bearbeiten, um zum textbasierten Abfrage-Designer zu wechseln.
Geben Sie den folgenden Abfragetext im Bereich Abfrage ein:
```
SELECT DISTINCT Name AS Category FROM Production.ProductCategory
```
Der Befehl SELECT DISTINCT ruft nur eindeutige Werte aus einer Spalte ab.
Klicken Sie auf Ausführen (!), um das Resultset anzuzeigen. Die Spalte Category wird mit vier Werten angezeigt: "Accessories", "Bikes", "Clothing" und "Components"
Klicken Sie auf OK.

Als Nächstes legen Sie die Eigenschaften für den Berichtsparameter Category fest, um Werte aus dieser Abfrage für die verfügbaren Werte ebenso wie für die Standardwerte zu verwenden.

So legen Sie verfügbare Werte und Standardwerte für einen Berichtsparameter fest

Klicken Sie im Bereich für die Berichtsdaten im Ordner Parameter mit der rechten Maustaste auf Category, und klicken Sie dann auf Parametereigenschaften.
Der Name unter Name sollte Category lauten.
Klicken Sie auf Verfügbare Werte.
Klicken Sie auf Werte aus Abfrage abrufen. Es werden drei Felder angezeigt.
Wählen Sie unter Dataset den Eintrag CategoryValues aus der Dropdownliste aus.
Klicken Sie im Feld Wert auf Category.
Klicken Sie im Feld Bezeichnung auf Category.
Klicken Sie auf Standardwerte.
Klicken Sie auf Werte aus Abfrage abrufen.
Wählen Sie unter Dataset den Eintrag CategoryValues aus der Dropdownliste aus.
Wählen Sie im Feld Wert den Wert Category aus.
Klicken Sie auf OK.

Anschließend ändern Sie den Parameter @Subcategory so, dass er von dem Wert abhängig ist, der für @Category ausgewählt wurde.

So fügen Sie das Dataset mit Werten für den Berichtsparameter "Subcategory" hinzu

Klicken Sie im Bereich für die Berichtsdaten mit der rechten Maustaste auf AdventureWorks_Ref und anschließend auf Dataset hinzufügen.
Geben Sie in das Feld Name den Wert SubcategoryValues ein.

Geben Sie den folgenden Abfragetext im Bereich Abfrage ein:

SELECT DISTINCT PSC.Name AS Subcategory 
   FROM Production.ProductSubcategory AS PSC
      INNER JOIN Production.ProductCategory AS PC
      ON PC.ProductCategoryID = PSC.ProductCategoryID
      WHERE PC.Name = (@Category)

Klicken Sie auf OK.
Das Dataset SubcategoryValues wird im Bereich Berichtsdaten angezeigt. Wenn Sie den Abfrage-Designer öffnen, die Abfrage ausführen und Components als Kategorie eingeben, zeigt das Resultset 14 Zeilen an.

Im Anschluss legen Sie die Eigenschaften für den Berichtsparameter @Subcategory fest, um Werte aus dieser Abfrage für die verfügbaren Werte ebenso wie für die Standardwerte zu verwenden.

So legen Sie verfügbare Werte und Standardwerte für den Berichtsparameter "Subcategory" fest

Klicken Sie im Bereich für die Berichtsdaten im Ordner Parameter mit der rechten Maustaste auf Subcategory, und klicken Sie dann auf Parametereigenschaften.
Klicken Sie auf Verfügbare Werte.
Klicken Sie auf Werte aus Abfrage abrufen.
Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag SubcategoryValues.
Klicken Sie im Feld Wert auf Subcategory.
Klicken Sie im Feld Bezeichnung auf Subcategory.
Klicken Sie auf Standardwerte.
Klicken Sie auf Werte aus Abfrage abrufen.
Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag SubcategoryValues.
Klicken Sie im Feld Wert auf Subcategory.
Klicken Sie auf OK.

Als Nächstes erstellen Sie den Parameter @Product, der vom Wert für @Category sowie vom Wert für @Subcategory abhängig ist.

So fügen Sie das Dataset mit Werten für den Berichtsparameter "Product" hinzu

Klicken Sie im Bereich für die Berichtsdaten mit der rechten Maustaste AdventureWorks_Ref und anschließend auf Dataset hinzufügen.
Geben Sie im Feld Name den Namen ProductValues ein.

Geben Sie den folgenden Abfragetext im Bereich für die Abfrage ein:

SELECT DISTINCT P.Name AS Product
FROM Production.Product P
   INNER JOIN Production.ProductSubcategory AS PSC
   ON P.ProductSubcategoryID = PSC.ProductSubcategoryID
   INNER JOIN Production.ProductCategory AS PC
   ON PC.ProductCategoryID = PSC.ProductCategoryID
WHERE (PC.Name = (@Category)
   AND PSC.Name = (@Subcategory))

Klicken Sie auf OK.

Im Bereich für die Berichtsdaten wird das ProductValues-Dataset mit dem Feld Product hinzugefügt.

Im Anschluss legen Sie die Eigenschaften für den Parameter @Product fest, um Werte aus dieser Abfrage für die verfügbaren Werte ebenso wie für die Standardwerte zu verwenden.

So legen Sie verfügbare Werte und Standardwerte für den Berichtsparameter "Product" fest

Klicken Sie im Bereich für die Berichtsdaten im Ordner Parameter mit der rechten Maustaste auf Product, und klicken Sie dann auf Parametereigenschaften.
Klicken Sie auf Verfügbare Werte.
Klicken Sie auf Werte aus Abfrage abrufen.
Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag ProductValues.
Klicken Sie im Feld Wert auf Product.
Klicken Sie im Feld Bezeichnung auf Product.
Klicken Sie auf Standardwerte.
Klicken Sie auf Werte aus Abfrage abrufen.
Klicken Sie unter Dataset in der Dropdownliste auf den Eintrag ProductValues.
Klicken Sie im Feld Wert auf Product.
Klicken Sie auf OK.

Fügen Sie nun eine Tabelle hinzu, um die Auswirkungen der Auswahl eines Werts für die einzelnen kaskadierenden Parameter anzuzeigen.

So fügen Sie eine Tabelle zum Anzeigen der Ergebnisse hinzu

Fügen Sie eine Tabelle in der Entwurfsansicht hinzu.
Ziehen Sie im Bereich für die Berichtsdaten die folgenden Felder aus dem SalesbyCategory-Dataset in die drei Zellen in der Detailzeile für die Tabelle: SalesOrderNumber, OrderQty, LineTotal
Ziehen Sie den Parameter Category vom SalesbyCategory-Dataset in den Bereich Zeilengruppen und legen Sie diesen über der Gruppe Details ab.
Ziehen Sie Subcategory vom SalesbyCategory-Dataset in den Bereich Zeilengruppen und legen Sie diesen unter Category ab.
Ziehen Sie Product vom SalesbyCategory-Dataset in den Bereich Zeilengruppen und legen Sie diesen unter Subcategory ab.
Ziehen Sie OrderDate vom SalesbyCategory-Dataset in den Bereich Zeilengruppen und legen Sie diesen unter Product ab.
Optional: Formatieren Sie die Zelle [LineTotal] als Währung und die Zelle [OrderDate] als Datum.

So testen Sie die kaskadierenden Parameter

Klicken Sie auf Vorschau.

Der Bericht wird automatisch ausgeführt, da Sie die Standardwerte für die einzelnen Berichtsparameter festgelegt haben.
Wählen Sie in der Dropdownliste Category den Eintrag Components aus.
Wählen Sie in der Dropdownliste Subcategory den Eintrag Brakes aus.
Wählen Sie in der Dropdownliste Product den Wert Front Brakes aus.

Beachten Sie, dass in der Dropdownliste des nächsten Parameters nur die gültigen Werte anhand Ihrer Auswahl angezeigt werden, wenn Sie die einzelnen nachfolgenden Parameter auswählen.
Klicken Sie auf der Berichts-Viewer-Symbolleiste auf Bericht anzeigen.

Im Bericht werden die Bestellnummern zusammen mit der Bestellmenge und Zeilengesamtwerten für Bestellungen für das Produkt "Front Brakes" angezeigt. Dabei sind die Bestellungen in der Tabelle nach Kategorie, Unterkategorie, Produkt und Bestelldatum angeordnet.

Nächste Schritte

Sie haben erfolgreich einen Bericht mit kaskadierenden Parametern erstellt, in dem Bestellungen für ein bestimmtes Produkt angezeigt werden und eine Filterung nach Produktkategorie, Unterkategorie und Produktname ausgeführt werden kann. In der nächsten Lektion erfahren Sie, wie ein Parameter an einen Drillthroughbericht übergeben wird. Siehe Lektion 5: Hinzufügen von Parametern zur Übergabe an einen Drillthroughbericht (SSRS).

Siehe auch

Konzepte

Parameter (Report Builder 3.0 und SSRS)

Freigeben über