Erstellen von Berichtsparametern und Festlegen von Berichtsparametereigenschaften

Neu: 17. Juli 2006

Berichtsparameter werden für den Bericht global definiert. Berichtsparameter werden automatisch erstellt, wenn der Bericht Parameter enthält, sie können aber auch manuell erstellt werden. Nach dem Erstellen eines Parameters müssen Sie Eigenschaften festlegen, die ihn identifizieren sowie steuern, wie er im Bericht verwendet wird.

Verwenden Sie zum Bearbeiten von Parametern vor dem Veröffentlichen eines Berichts im Berichts-Designer das Dialogfeld Berichtsparameter. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen, Bearbeiten oder Löschen eines Berichtsparameters (Berichts-Designer).

Nach dem Veröffentlichen des Berichts können Sie viele Berichtsparametereigenschaften im Berichts-Manager oder in SQL Server Management Studio ändern. Weitere Informationen zum Ändern von Parametereigenschaften und zu Sicherheitsaspekten finden Sie unter Festlegen von Parametereigenschaften für einen publizierten Bericht.

Berichtsparameter

Berichtsparameter werden zwar automatisch aus Abfrageparametern erstellt, wenn ein Abfrageparameter gelöscht wird, werden die Berichtsparameter jedoch nicht automatisch gelöscht.

Zum Öffnen des Dialogfeldes Berichtseigenschaften wechseln Sie im Berichts-Designer zur Daten- oder Layoutansicht und wählen im Menü Bericht die Option Berichtseigenschaften aus. Im linken Bereich wird eine Liste der Berichtsparameter angezeigt. Wählen Sie den Parameter aus, den Sie ändern möchten.

Name und Datentyp

Parameternamen sind erforderlich und müssen innerhalb des Berichts eindeutig sein. Als Datentyp eines Parameters wird standardmäßig String festgelegt. Sie können einen anderen Datentyp in der Dropdownliste auswählen. Wenn der Berichtsparameter auf einem Abfrageparameter basiert, stellen Sie sicher, dass der Datentyp des Berichtsparameters dem Datentyp des Abfrageparameters entspricht. Reporting Services erkennt keine Datentypen von Abfrageparametern. Daher müssen Sie den Datentyp selbst anpassen.

Der Name muss den Standards für Zeichen und Schreibweise der Common Language Specification entsprechen. Weitere Informationen erhalten Sie, wenn Sie unter https://msdn.microsoft.com nach dem Stichwort "Common Language Specification" suchen.

Eingabeaufforderung

In einem veröffentlichten Bericht werden Parameter normalerweise als Textfelder in einem Parametereingabebereich oben im Bericht angezeigt. Die Eingabeaufforderungs-Zeichenfolge definiert die Bezeichnung, die den Parameter im Eingabebereich identifiziert. Die Eingabeaufforderung kann den Namen des Parameters oder Anweisungen für den Benutzer enthalten, z. B. "Jahr" oder "Wählen Sie ein Jahr aus". Wenn die Eingabeaufforderung leer und ein Standardwert für den Parameter angegeben ist, wird der Standardwert verwendet. In diesem Fall wird das Eingabefeld für den Parameter nicht angezeigt, wenn der Benutzer den Bericht ausführt. Wenn die Eingabeaufforderung leer ist, ohne dass ein Standardwert für den Parameter angegeben ist, kann der Bericht nicht ausgeführt werden. Wenn Sie den Benutzer nicht zur Eingabe von Parameterwerten auffordern möchten, kennzeichnen Sie den betreffenden Parameter als ausgeblendet oder intern.

Ausgeblendete und interne Parameter

Sie können Optionen festlegen, die die Sichtbarkeit von Parametern im veröffentlichten Bericht steuern. Durch das Festlegen der Optionen Ausgeblendet und Intern werden unterschiedliche Sichtbarkeitsebenen bereitgestellt. Sie können den Parameter im Parametereingabebereich des veröffentlichten Berichts ausblenden und dennoch Werte für ihn in einem Berichts-URL oder einer Abonnementdefinition festlegen. Wenn Sie einen Parameter als nur intern festlegen, wird er nur in der Berichtsdefinition verfügbar gemacht.

Einwertige und mehrwertige Parameter

Sie können einen mehrwertigen Parameter definieren, indem Sie im Dialogfeld Berichtsparameter die Option Mehrwertig auswählen. Wird dieses Kontrollkästchen nicht aktiviert, ist der Parameter einwertig. Durch Angeben der Option Mehrwertig werden den verfügbaren Werten in einer Parameter-Dropdownliste im veröffentlichten Bericht Kontrollkästchen hinzugefügt. Die Benutzer können die gewünschten Werte auswählen. So können z. B. Benutzer im Beispielbericht Sales Reason Comparisons mehrere Produkte auswählen, um die kombinierten Umsatzdaten für diese Produkte anzuzeigen.

Beim Angeben der verfügbaren Werte können Sie eine statische Liste von Zeichenfolgen bereitstellen oder eine Abfrage verwenden, um verfügbare Werte von einer Datenquelle abzurufen. Ein mehrwertiger Parameter muss mindestens einen Wert enthalten. NULL-Werte sind nicht zulässig. Die Option Alles auswählen wird automatisch erstellt und nur dann angezeigt, wenn mehrere Werte vorhanden sind.

Hinweis:
Wählen Sie in SQL Server 2005 nicht die Option Alles auswählen aus, wenn Sie eine Analysis Services-Datenquelle verwenden. Die Option Alles auswählen kann zu einer schlechteren Leistung beim Verarbeiten einer MDX-Abfrage führen. Verwenden Sie stattdessen zum Auswählen aller Werte die Alle-Elementliste.

Zulassen von leeren Werten

Wenn Sie beim Erstellen einer Liste der verfügbaren Werte <Blank> als gültigen Wert zulassen möchten, müssen Sie ihn in die Liste der gültigen Wert aufnehmen.

Zulassen von NULL-Werten

Null zulassen ist eine Option für einwertige Parameter. Dieser Wert kann nicht für mehrwertige Parameter ausgewählt werden. Wenn Sie NULL zulassen auswählen, lassen Sie für den Parameter den Wert NULL zu. Viele Abfragesprachen geben standardmäßig keine NULL-Werte in einem Resultset zurück.

Verfügbare Werte

Wenn Sie einen Berichtsparameter definieren, müssen Sie die Werte definieren, die mit dem Bericht verwendet werden können. Diese Werte werden als verfügbare oder gültige Werte bezeichnet. Eine Liste der verfügbaren Werte enthält einen Satz von Wert-Bezeichnungs-Paaren. Bei der Ausführung des Berichts wird dem Benutzer die Bezeichnung angezeigt. Wenn der Benutzer eine Bezeichnung auswählt, wird der entsprechende Wert als Parameterwert verwendet. Verfügbare Werte können als statische Liste oder Ausdruck vordefiniert werden oder aus einem Dataset abgerufen werden:

• Bei einer nicht abgefragten Liste handelt es sich um eine statische Liste von Wert-Bezeichnungs-Paaren. Die gesamte Liste ist in der Definition des Berichtsparameters enthalten. Jeder Wert und jede Bezeichnung kann ein statischer Wert sein oder aus einem Ausdruck generiert werden.
• Bei einer abgefragten Liste ruft der Berichtsserver bei der Berichtsausführung einen Satz von Werten und Bezeichnungen aus einem Dataset ab. Wenn Sie eine abgefragte Liste der verfügbaren Werte angeben, wählen Sie das Dataset, das Feld für die Werte und das Feld für die Bezeichnungen aus.

Beim Angeben einer abgefragten Liste verfügbarer Werte ist es empfehlenswert, ein vereinfachtes Dataset speziell für die Verwendung durch den Parameter zu erstellen, statt ein komplizierteres Dataset zu verwenden, das auch von Datenbereichen in dem Bericht verwendet wird. Das Verwenden desselben Datasets für die Liste der gültigen Werte und für die Datenbereiche im Bericht könnte zu unerwarteten Ergebnissen in der Liste der gültigen Werte führen.

Standardwert

Sie können einen Standardwert für den Parameter definieren. Wenn alle Parameter in einem Bericht Standardwerte besitzen, wird der Bericht sofort verarbeitet, wenn er vom Benutzer geöffnet oder in der Vorschau im Berichts-Designer angezeigt wird. Weist jedoch mindestens ein Parameter keinen Standardwert auf, werden erst Berichtsdaten angezeigt, nachdem der Benutzer alle Parameterwerte eingegeben und den Bericht ausgeführt hat.

Sie können nicht abgefragte oder abgefragte Werte als Standard verwenden. Bei einem nicht abgefragten Standardwert handelt es sich um einen statischen Wert oder um einen Ausdruck. Bei einem abgefragten Standardwert handelt es sich um einen Ausdruck, der auf ein Feld in einem Dataset zeigt. Falls die Abfrage mehrere Zeilen zurückgibt, wird der Wert aus der ersten Zeile des zurückgegebenen Datasets verwendet.

Sie können auch auf die Angabe eines Standardwertes verzichten. In diesem Fall müssen Sie eine Eingabeaufforderung angeben.

Hinweis:
Wenn Sie einen mehrwertigen Parameter verwenden und die Abfrage mehrere Zeilen zurückgibt, werden alle Zeilen als Standard verwendet.

Siehe auch

Andere Ressourcen

Lernprogramm: Hinzufügen von Parametern zu einem einfachen Tabellenbericht
Lernprogramm: Erweiterte Features und Parameter
Verwenden von Parametern in Reporting Services
Berichtsparameter (Berichts-Designer)

Hilfe und Informationen

Informationsquellen für SQL Server 2005