Erstellen von Berichtsparametern und Festlegen von Berichtsparametereigenschaften
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, Ändern oder Löschen von Berichtsparametern (Reporting Services).
Nach dem Veröffentlichen des Berichts können Sie viele Berichtsparametereigenschaften im Berichts-Manager oder in SQL ServerManagement 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 für Abfrageparameter automatisch erstellt, wenn eine Datasetabfrage gespeichert wird. Sie können einen Berichtsparameter auch manuell erstellen. Nach dem Erstellen eines Berichtsparameters müssen die Standardwerte möglicherweise den Berichtsparametereigenschaften entsprechend angepasst werden, um die gewünschte Funktionalität zu erhalten. Beispielsweise muss der Datentyp geändert werden, ein Dataset zur Bereitstellung einer Liste mit verfügbaren Werten erstellt werden, ein Dataset für Standardwerte erstellt oder festgelegt werden, ob die Werte leer oder NULL sein können.
Wenn ein Parameter mehrere Werte zulassen soll, müssen Sie die Datasetabfrage ändern, um ebenfalls mehrere Werte zuzulassen. Weitere Informationen finden Sie unter Verwenden von ein- und mehrwertigen Parametern. Wenn Sie einen mehrwertigen Parameter in einen Ausdruck einbeziehen, müssen Sie damit vertraut sein, wie der Ausdruck geschrieben werden muss, um auf die gewünschten Werte zuzugreifen. Weitere Informationen finden Sie unter Verwenden von Verweisen auf Parameters-Auflistungen in Ausdrücken (Reporting Services).
Um einen Berichtsparameter zu erstellen oder zu ändern, klicken Sie mit der rechten Maustaste auf den Knoten Parameter im Bereich Daten, und öffnen Sie das Dialogfeld Berichtsparametereigenschaften.
Hinweis
Wenn Sie den Namen eines Abfrageparameters entfernen oder ändern, wird der entsprechende Berichtsparameter nicht automatisch entfernt bzw. umbenannt. Wenn Sie den Namen eines Abfrageparameters beim Speichern der Abfrage ändern, wird ein entsprechend neuer Berichtsparameter erstellt. Sie können den Berichtsparameter umbenennen, sodass er dem neuen Abfrageparameternamen entspricht, und die Dataset-Parametereigenschaften aktualisieren, um den Abfrageparameter mit dem Berichtsparameter zu verknüpfen. Wenn Sie einen Abfrageparameter entfernen und den entsprechenden Berichtsparameter nicht benötigen, müssen Sie ihn manuell löschen.
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 finden Sie unter Common Language Specification unter .
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, wählen Sie 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 einer Berichts-URL oder einer Abonnementdefinition festlegen. Wenn Sie einen Parameter auf Intern festlegen, wird er nur in der Berichtsdefinition angezeigt. Ein interner Parameter muss über einen Standardwert verfügen, der NULL sein kann, falls die Option NULL-Wert zulassen ausgewählt wurde.
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 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 Reporting Services 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-MDX-Elementliste im Abfrage-Designer.
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. Einige 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
Verweis
Berichtsparametereigenschaften (Dialogfeld), Allgemein
Konzepte
Lernprogramm: Hinzufügen von Parametern zu einem Bericht
Hinzufügen von Parametern zum Bericht