Berichtsparameter (Berichts-Generator und Berichts-Designer)Report Parameters (Report Builder and Report Designer)

In diesem Thema werden die allgemeinen Einsatzbereiche von Reporting ServicesReporting Services -Berichtsparametern, die einstellbaren Eigenschaften und vieles mehr beschrieben.This topic describes the common uses for Reporting ServicesReporting Services report parameters, the properties you can set, and much more. Mithilfe von Berichtsparametern können Sie Berichtsdaten steuern, eine Verbindung zwischen verwandten Berichten herstellen und die Berichtspräsentation anpassen.Report parameters enable you to control report data, connect related reports together, and vary report presentation. Sie können Berichtsparameter in paginierten Berichten verwenden, die Sie in Berichts-GeneratorReport Builder und im Berichts-Designer erstellen, und auch in mobilen Berichten, die Sie in Publisher für mobile Berichte von SQL ServerSQL Server Mobile Report Publishererstellen.You can use report parameters in paginated reports you create in Berichts-GeneratorReport Builder and Report Designer, and also in mobile reports you create in Publisher für mobile Berichte von SQL ServerSQL Server Mobile Report Publisher. Erfahren Sie mehr über Berichtsparameterkonzepte.Read more about Report Parameters Concepts.

||
|-|
| Gilt für:Applies to: Berichts-GeneratorReport Builder, Reporting ServicesReporting Services SharePoint-Modus und einheitlicher Modus SharePoint mode and Native mode|

Wenn Sie einem Bericht einen Parameter selbst hinzufügen möchten, lesen Sie unter Tutorial: Hinzufügen eines Parameters zum Bericht (Berichts-Generator)erstellen.To try adding a parameter to a report yourself, see Tutorial: Add a Parameter to Your Report (Report Builder).

Allgemeine Verwendungsmöglichkeiten für Parameter Common Uses for Parameters

Im Folgenden sind einige der häufigsten Verwendungsmöglichkeiten für Parameter aufgeführt.Here are some of the most common ways to use parameters.

Steuern von Daten in paginierten und mobilen BerichtenControl Paginated and Mobile Report Data

  • Filtern Sie paginierte Berichtsdaten in der Datenquelle, indem Sie Datasetabfragen schreiben, die Variablen enthalten.Filter paginated report data at the data source by writing dataset queries that contain variables.

  • Filtern Sie Daten von einem freigegebenen Dataset.Filter data from a shared dataset. Wenn Sie einem paginierten Bericht ein freigegebenes Dataset hinzufügen, kann die Abfrage nicht geändert werden.When you add a shared dataset to a paginated report, you cannot change the query. Im Bericht können Sie einen Datasetfilter mit einem Verweis auf einen von Ihnen erstellten Berichtsparameter hinzufügen.In the report, you can add a dataset filter that includes a reference to a report parameter that you create.

  • Filtern Sie Daten aus einem freigegebenen Dataset in einem mobilen SQL ServerSQL Server -Bericht.Filter data from a shared dataset in a SQL ServerSQL Server mobile report. Weitere Informationen finden Sie unter Create mobile reports with SQL Server Mobile Report Publisher .See Create mobile reports with SQL Server Mobile Report Publisher for more information.

  • Ermöglichen Sie Benutzern die Angabe von Werten, um die Daten in einem paginierten Bericht anzupassen.Enable users to specify values to customize the data in a paginated report. Beispiel: Angabe von zwei Parametern (Start- und Enddatum) für Umsatzdaten.For example, provide two parameters for the start date and end date for sales data.

    Eine Verbindung zwischen verwandten Berichten herstellenConnect Related Reports

  • Verwenden Sie Parameter, um Hauptberichte mit Drillthroughberichten, Unterberichten sowie verknüpften Berichten zu verbinden.Use parameters to relate main reports to drillthrough reports, to subreports, and to linked reports. Beim Entwurf von Berichtssätzen können Sie jeden Bericht so entwerfen, dass er Antworten auf ganz bestimmte Fragen liefert.When you design a set of reports, you can design each report to answer certain questions. Jeder Bericht kann eine andere Sicht oder Detailebene zu verwandten Informationen bereitstellen.Each report can provide a different view or a different level of detail for related information. Zum Bereitstellen eines Satzes untereinander verbundener Berichte erstellen Sie Parameter für die verbundenen Daten in den Zielberichten.To provide a set of interrelated reports, create parameters for the related data on target reports.

    Weitere Informationen finden Sie unter Drillthroughberichte (Berichts-Generator und SSRS), Unterberichte (Berichts-Generator und SSRS) und Erstellen eines verknüpften Berichts.For more information, see Drillthrough Reports (Report Builder and SSRS), Subreports (Report Builder and SSRS), and Create a Linked Report.

  • Anpassen von Parametersätzen für mehrere Benutzer.Customize sets of parameters for multiple users. Erstellen Sie auf der Grundlage eines Verkaufsberichts auf dem Berichtsserver zwei verknüpfte Berichte.Create two linked reports based on a sales report on the report server. In einem der verknüpften Berichte werden vordefinierte Parameterwerte für Vertriebsmitarbeiter, im anderen vordefinierte Parameterwerte für Verkaufsmanager verwendet.One linked report uses predefined parameter values for sales persons and the second linked report uses predefined parameter values for sales managers. Für beide Berichte wird die gleiche Berichtsdefinition verwendet.Both reports use the same report definition.

    Berichtspräsentation anpassenVary Report Presentation

  • Senden Sie einem Berichtsserver über eine URL-Anforderung Befehle, um das Rendering eines Berichts anzupassen.Send commands to a report server through a URL request, to customize the rendering of a report. Weitere Informationen finden Sie unter URL-Zugriff (SSRS) und Übergeben von Berichtsparametern innerhalb einer URL.For more information, see URL Access (SSRS) and Pass a Report Parameter Within a URL.

  • Ermöglichen der Angabe von Werte durch Benutzer, um die Darstellung eines Berichts anzupassen.Enable users to specify values to help customize the appearance of a report. Beispiel: Angabe eines booleschen Parameters, um anzugeben, ob alle geschachtelten Zeilengruppen in einer Tabelle erweitert oder reduziert werden sollen.For example, provide a Boolean parameter to indicate whether to expand or collapse all nested row groups in a table.

  • Ermöglichen Sie Benutzern das Anpassen von Berichtsdaten und der Darstellung von Berichten, indem Sie Parameter in einen Ausdruck einschließen.Enable users to customize report data and appearance by including parameters in an expression.

    Weitere Informationen finden Sie unter Verweise auf Parametersammlungen (Berichts-Generator und SSRS).For more information, see Parameters Collection References (Report Builder and SSRS).

Anzeigen eines Berichts mit Parametern Viewing a Report with Parameters

Wenn Sie einen Bericht mit Parametern anzeigen, werden auf der Berichts-Viewer-Symbolleiste alle Parameter angezeigt, sodass Sie interaktiv Werte angeben können.When you view a report that has parameters, the report viewer toolbar displays each parameter so you can interactively specify values. Die folgende Abbildung zeigt den Parameterbereich für einen Bericht Withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, und @SalesDate.</span><span class="sxs-lookup">The following illustration shows the parameter area for a report withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, and @SalesDate.</span></span>

Anzeigen des Berichts mit ParameternView report with parameters

  1. Parameterbereich Auf der Berichts-Viewer-Symbolleiste werden für jeden Parameter eine Eingabeaufforderung und ein Standardwert angezeigt.Parameters pane The report viewer toolbar displays a prompt and default value for each parameter. Sie können das Layout von Parametern im Parameterbereich anpassen.You can customize the layout of parameters in the parameters pane. Weitere Informationen finden Sie unter Benutzerdefiniertes Anpassen des Parameterbereichs in einem Bericht (Berichts-Generator)erstellen.For more information, see Customize the Parameters Pane in a Report (Report Builder).

  2. @SalesDateParameter Parameters @SalesDate Datentyp "DateTime".@SalesDate parameter The parameter @SalesDate is data type DateTime. Neben dem Textfeld wird die Aufforderung „Datum auswählen“ angezeigt.The prompt Select the Date appears next to the text box. Geben Sie zum Ändern des Datums ein neues Datum in das Textfeld ein, oder verwenden Sie das Kalendersteuerelement.To modify the date, type a new date in the text box or use the calendar control.

  3. @ShowAllParameter Parameters @ShowAll Datentyp booleschen.@ShowAll parameter The parameter @ShowAll is data type Boolean. Geben Sie mithilfe der Optionsfelder entweder True oder Falsean.Use the radio buttons to specify True or False.

  4. Handle "Parameterbereich ein-/ausblenden" Klicken Sie auf der Berichts-Viewer-Symbolleiste auf diesen Pfeil, um den Parameterbereich anzuzeigen oder auszublenden.Show or Hide Parameter Area handle On the report viewer toolbar, click this arrow to show or hide the parameters pane.

  5. @CategoryQuotaParameter Parameters @CategoryQuota Datentyp Float, sodass es einen numerischen Wert akzeptiert.@CategoryQuota parameter The parameter @CategoryQuota is data type Float, so it takes a numeric value. @CategoryQuotamehrere Werte zulassen festgelegt ist.@CategoryQuota is set to allow multiple values.

  6. Bericht anzeigen Klicken Sie auf Bericht anzeigen , um nach der Eingabe von Parameterwerten den Bericht auszuführen.View Report After you enter parameter values, click View Report to run the report. Wurden für alle Parameter Standardwerte festgelegt, wird der Bericht beim erstmaligen Anzeigen automatisch ausgeführt.If all parameters have default values, the report runs automatically on first view.

Erstellen von Parametern Creating Parameters

Es gibt verschiedene Möglichkeiten zum Erstellen von Berichtsparametern.You can create report parameters in a few different ways.

Hinweis

Nicht alle Datenquellen unterstützen Parameter.Not all data sources support parameters.

Datasetabfrage oder gespeicherte Prozedur mit ParameternDataset query or stored procedure with parameters

Fügen Sie eine Datasetabfrage mit Variablen oder eine gespeicherte Prozedur für ein Dataset mit Eingabeparametern hinzu.Add a dataset query that contains variables or a dataset stored procedure that contains input parameters. Für jede Variable oder jeden Eingabeparameter wird ein Datasetparameter erstellt und für jeden Datasetparameter wird ein Berichtsparameter erstellt.A dataset parameter is created for each variable or input parameter, and a report parameter is created for each dataset parameter.

Berichts-Generator-Dataset-ParametereigenschaftenReport Builder Parameter Dataset Properties

Dieses Bild vom Berichts-Generator zeigt Folgendes:This image from Report Builder shows:

  1. Die Berichtsparameter im BerichtsdatenbereichThe report parameters in the Report Data pane.

  2. Das Dataset mit den ParameternThe dataset with the parameters.

  3. Den ParameterbereichThe Parameters pane.

  4. Die im Dialogfeld „Dataseteigenschaften“ aufgeführten ParameterThe parameters listed in the Dataset Properties dialog box.

    Das Dataset kann eingebettet oder freigegeben sein.The dataset can be embedded or shared. Wenn Sie einem Bericht ein freigegebenes Dataset hinzufügen, können als "Intern" markierte Datasetparameter im Bericht nicht überschrieben werden.When you add a shared dataset to a report, dataset parameters that are marked internal cannot be overridden in the report. Nicht als "Intern" markierte Datasetparameter können überschrieben werden.You can override dataset parameters that are not marked internal.

    Weitere Informationen finden Sie in diesem Thema unter Datasetabfrage .For more information, see Dataset Query in this topic.

    Manuelles Erstellen von ParameternCreate a parameter manually

    Erstellen Sie einen Parameter manuell aus dem Berichtsdatenbereich.Create a parameter manually from the Report Data pane. Sie können Berichtsparameter so konfigurieren, dass ein Benutzer interaktiv Werte eingeben kann, um den Inhalt oder die Darstellung eines Berichts anzupassen.You can configure report parameters so that a user can interactively enter values to help customize the contents or appearance of a report. Berichtsparameter können auch so konfiguriert werden, dass vorkonfigurierte Werte nicht vom Benutzer geändert werden können.You can also configure report parameters so that a user cannot change preconfigured values.

Hinweis

Da Parameter auf dem Server unabhängig verwaltet werden, werden durch das erneute Veröffentlichen eines Hauptberichts mit neuen Parametereinstellungen keine im Bericht vorhandenen Parametereinstellungen überschrieben.Because parameters are managed independently on the server, republishing a main report with new parameter settings does not overwrite the existing parameters settings on the report.

Berichtsteil mit einem ParameterReport part with a parameter

Fügen Sie einen Berichtsteil hinzu, der Verweise auf einen Parameter oder ein freigegebenes Dataset mit Variablen enthält.Add a report part that contains references to a parameter or to a shared dataset that contains variables.

Berichtsteile werden auf dem Berichtsserver gespeichert und können von anderen Benutzern in deren Berichten verwendet werden.Report parts are stored on the report server and available for others to use in their reports. Berichtsteile, bei denen es sich um Parameter handelt, können nicht vom Berichtsserver aus verwaltet werden.Report parts that are parameters cannot be managed from the report server. Im Berichtsteilkatalog können Sie nach Parametern suchen und sie nach dem Hinzufügen in Ihrem Bericht konfigurieren.You can search for parameters in the Report Part Gallery and after you add them, configure them in your report. Weitere Informationen finden Sie unter Berichtsteile (Berichts-Generator und SSRS).For more information, see Report Parts (Report Builder and SSRS).

Hinweis

Parameter können als separater Berichtsteil für Datenbereiche veröffentlicht werden, die abhängige Datasets mit Parametern enthalten.Parameters can be published as a separate report part for data regions that have dependent datasets with parameters. Obwohl Parameter als Berichtsteil aufgeführt werden, können Sie einem Bericht keinen Berichtsteilparameter direkt hinzufügen.Although parameters are listed as a report part, you cannot add a report part parameter directly to a report. Fügen Sie stattdessen den Berichtsteil hinzu, und alle notwendigen Berichtsparameter werden automatisch aus Datasetabfragen generiert, die enthalten sind oder auf die vom Berichtsteil verwiesen wird.Instead, add the report part, and any necessary report parameters are automatically generated from dataset queries that are contained or referenced by the report part. Weitere Informationen zu Berichtsteilen finden Sie unter Berichtsteile (Berichts-Generator und SSRS) und Berichtsteile im Berichts-Designer (SSRS).For more information about report parts, see Report Parts (Report Builder and SSRS) and Report Parts in Report Designer (SSRS).

ParameterwerteParameter Values

Ihnen stehen folgende Optionen für das Auswählen von Parameterwerten im Bericht zur Verfügung.The following are options for selecting parameter values in the report.

  • Wählen Sie einen einzelnen Parameterwert aus einer Dropdownliste aus.Select a single parameter value from a drop-down list.

  • Wählen Sie mehrere Parameterwerte aus einer Dropdownliste aus.Select multiple parameter values from a drop-down list.

  • Wählen Sie einen Wert aus einer Dropdownliste für einen Parameter aus, der die für einen anderen Parameter in der Dropdownliste verfügbaren Werte bestimmt.Select a value from a drop-down list for one parameter, which determines the values that are available in the drop-down list for another parameter. Dies sind kaskadierende Parameter.These are cascading parameters. Durch kaskadierende Parameter lassen sich tausende Parameterwerte nach und nach zu einer überschaubare Anzahl filtern.Cascading parameters enables you to successively filter parameter values from thousands of values to a manageable number.

    Weitere Informationen finden Sie unter Hinzufügen von kaskadierenden Parametern zu einem Bericht (Berichts-Generator und SSRS)erstellen.For more information, see Add Cascading Parameters to a Report (Report Builder and SSRS).

  • Führen Sie den Bericht aus, ohne zuvor einen Parameterwert auswählen zu müssen, da ein Standardwert für den Parameter erstellt wurde.Run the report without having to first select a parameter value because a default value has been created for the parameter.

Berichtsparametereigenschaften Report Parameter Properties

Sie können die Berichtsparametereigenschaften über das Dialogfeld Berichtseigenschaften ändern.You can change the report parameter properties by using the Report Properties dialog box. Die folgende Tabelle enthält die Eigenschaften, die für die einzelnen Parameter festgelegt werden können:The following table summarizes the properties that you can set for each parameter:

EigenschaftProperty DescriptionDescription
NameName Geben Sie einen Namen für den Parameter ein. (Beachten Sie dabei die Groß- und Kleinschreibung.)Type a case-sensitive name for the parameter. Der Name muss mit einem Buchstaben beginnen und Buchstaben, Zahlen und einen Unterstrich () umfassen.The name must begin with a letter and can have letters, numbers, an underscore (). Er darf keine Leerzeichen enthalten.The name cannot have spaces. Bei automatisch generierten Parametern stimmt der Name mit dem Parameter in der Datasetabfrage überein.For automatically-generated parameters, the name matches the parameter in the dataset query. Manuell erstellte Parameter ähneln standardmäßig der Zeichenfolge "ReportParameter1".By default, manually-created parameters are similar to ReportParameter1.
EingabeaufforderungPrompt Der Text, der auf der Berichts-Viewer-Symbolleiste neben dem Parameter angezeigt wird.The text that appears next to the parameter on the report viewer toolbar.
DatentypData type Bei einem Berichtsparameter muss es sich um einen der folgenden Datentypen handeln:A report parameter must be one of the following data types:

Boolean.Boolean. Der Benutzer wählt True oder False über ein Optionsfeld aus.The user selects True or False from a radio button.

DateTime.DateTime. Der Benutzer wählt ein Datum aus einem Kalendersteuerelement aus.The user selects a date from a calendar control.

Integer.Integer. Der Benutzer gibt Werte in ein Textfeld ein.The user types values in a text box.

Float.Float. Der Benutzer gibt Werte in ein Textfeld ein.The user types values in a text box.

Text.Text. Der Benutzer gibt Werte in ein Textfeld ein.The user types values in a text box.

Wenn verfügbare Werte für einen Parameter definiert sind, wählt der Benutzer auch dann Werte in einer Dropdownliste aus, wenn der Datentyp DateTimelautet.Note that when available values are defined for a parameter, the user chooses values from a drop-down list, even when the data type is DateTime.

Weitere Informationen zu Berichtsdatentypen finden Sie unter RDL Data Types.For more information about report data types, see RDL Data Types.
Leeren Wert zulassenAllow blank value Aktivieren Sie diese Option, wenn als Wert für den Parameter eine leere Zeichenfolge zulässig sein soll.Select this option if the value of the parameter can be an empty string or a blank.

Wenn Sie für einen Parameter gültige Werte angeben und möchten, dass ein leerer Wert zu den gültigen Werten zählt, muss der Wert zusammen mit den anderen Werten angegeben werden.If you specify valid values for a parameter, and you want a blank value to be one of the valid values, you must include it as one of the values that you specify. Durch Aktivieren dieser Option wird den verfügbaren Werten nicht automatisch ein leerer Wert hinzugefügt.Selecting this option does not automatically include a blank for available values.
NULL-Wert zulassenAllow null value Aktivieren Sie diese Option, wenn für den Parameter ein NULL-Wert zulässig sein soll.Select this option if the value of the parameter can be a null.

Wenn Sie für einen Parameter gültige Werte angeben und möchten, dass NULL zu den gültigen Werten zählt, muss der Wert zusammen mit den anderen Werten angegeben werden.If you specify valid values for a parameter, and you want null to be one of the valid values, you must include null as one of the values that you specify. Durch Aktivieren dieser Option wird den verfügbaren Werten nicht automatisch ein NULL-Wert hinzugefügt.Selecting this option does not automatically include a null for available values.
Mehrere Werte zulassenAllow multiple values Geben Sie verfügbare Werte an, um eine Dropdownliste zu erstellen, aus der die Benutzer auswählen können.Provide available values to create a drop-down list that your users can choose from. Damit können Sie sicherstellen, dass in der Datasetabfrage nur gültige Werte übermittelt werden.This is a good way to ensure that only valid values are submitted in the dataset query.

Aktivieren Sie diese Option, wenn für den Parameter mehrere Werte aus einer Dropdownliste zulässig sein können.Select this option if the value for the parameter can be multiple values that are displayed in a drop-down list. NULL-Werte sind nicht zulässig.Null values are not allowed. Wenn diese Option ausgewählt ist, werden der Liste der verfügbaren Werte in einer Parameter-Dropdownliste Kontrollkästchen hinzugefügt.When this option is selected, check boxes are added to the list of available values in a parameter drop-down list. Am Anfang der Liste befindet sich ein Kontrollkästchen für die Option Alles auswählen.The top of the list includes a check box for Select All. Von den Benutzern können die gewünschten Werte ausgewählt werden.Users can check the values that they want.

Wenn sich die Daten, auf denen die Werte basieren, häufig ändern, ist die Liste, die dem Benutzer angezeigt wird, möglicherweise nicht auf dem neuesten Stand.If the data that provides values changes rapidly, the list the user sees might not be the most current.
SichtbarVisible Aktivieren Sie diese Option, damit der Berichtsparameter bei Ausführung des Berichts oben im Bericht angezeigt wird.Select this option to display the report parameter at the top of the report when it is run. Diese Option ermöglicht es Benutzern, Parameterwerte zur Laufzeit auszuwählen.This option allows users to select parameter values at run time.
HiddenHidden Aktivieren Sie diese Option, um den Berichtsparameter im veröffentlichten Bericht auszublenden.Select this option to hide the report parameter in the published report. Die Berichtsparameterwerte können weiterhin auf eine Berichts-URL, in einer Abonnementdefinition oder auf dem Berichtsserver festgelegt werden.The report parameter values can still be set on a report URL, in a subscription definition, or on the report server.
InternInternal Aktivieren Sie diese Option, um den Berichtsparameter auszublenden.Select this option to hide the report parameter. Im veröffentlichten Bericht kann der Berichtsparameter nur in der Berichtsdefinition angezeigt werden.In the published report, the report parameter can only be viewed in the report definition.
Verfügbare WerteAvailable values Wenn Sie für einen Parameter verfügbare Werte angegeben haben, werden die gültigen Werte immer als Dropdownliste angezeigt.If you have specified available values for a parameter, the valid values always appear as a drop-down list. Wenn Sie also beispielsweise verfügbare Werte für einen DateTime -Parameter angeben, wird im Parameterbereich anstelle eines Kalendersteuerelements eine Dropdownliste mit Datumsangaben angezeigt.For example, if you provide available values for a DateTime parameter, a drop-down list for dates appears in the parameter pane instead of a calendar control.

Zur Gewährleistung der Konsistenz einer Liste mit Werten zwischen dem Bericht und den Unterberichten können Sie eine Option für die Datenquelle festlegen, sodass für alle Abfragen in den Datasets, die dieser Datenquelle zugeordnet sind, eine einzelne Transaktion verwendet wird.To ensure that a list of values is consistent among a report and subreports, you can set an option on the data source to use a single transaction for all queries in the datasets that are associated with a data source.

** Sicherheitshinweis *\* Verwenden Sie in einem Bericht, der einen Parameter vom Datentyp Textenthält, eine Liste der verfügbaren Werte (auch: Liste der gültigen Werte), und stellen Sie sicher, dass Benutzer, die den Bericht ausführen, nur über die Berechtigungen zum Anzeigen der Daten im Bericht verfügen.** Security Note *\* In any report that includes a parameter of data type Text, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. Weitere Informationen finden Sie unter Sicherheit (Berichts-Generator)erstellen.For more information, see Security (Report Builder).
StandardwerteDefault values Legen Sie Standardwerte aus einer Abfrage oder aus einer statischen Liste fest.Set default values from a query or from a static list.

Besitzt jeder Parameter einen Standardwert, wird der Bericht beim erstmaligen Anzeigen automatisch ausgeführt.When each parameter has a default value, the report runs automatically on first view.
ErweitertAdvanced Legen Sie das Berichtsdefinitionsattribut UsedInQueryfest. Dies ist ein Wert, mit dem angegeben wird, ob sich dieser Parameter direkt oder indirekt auf die Daten in einem Bericht auswirkt.Set the report definition attribute UsedInQuery, a value that indicates whether this parameter directly or indirectly affects the data in a report.

Aktualisierungszeitpunkt automatisch bestimmenAutomatically determine when to refresh
Wählen Sie diese Option aus, wenn der Wert vom Berichtsprozessor festgelegt werden soll.Choose this option when you want the report processor to determine a setting for this value. Der Wert ist True , wenn der Berichtsprozessor eine Datasetabfrage mit einem direkten oder indirekten Verweis auf diesen Parameter findet oder wenn der Bericht Unterberichte enthält.The value is True if the report processor detects a dataset query with a direct or indirect reference to this parameter, or if the report has subreports.

Immer aktualisierenAlways refresh
Wählen Sie diese Option aus, wenn der Berichtsparameter direkt oder indirekt in einer Datasetabfrage oder einem Parameterausdruck verwendet wird.Choose this option when the report parameter is used directly or indirectly in a dataset query or parameter expression. Diese Option legt UsedInQuery auf True fest.This option sets UsedInQuery to True.

Nie aktualisierenNever refresh
Wählen Sie diese Option aus, wenn der Berichtsparameter nicht direkt oder indirekt in einer Datasetabfrage oder einem Parameterausdruck verwendet wird.Choose this option when the report parameter is not used directly or indirectly in a dataset query or parameter expression. Diese Option legt UsedInQuery auf False fest.This option sets UsedInQuery to False.

** Vorsicht *\* Verwenden Sie Nie aktualisieren mit Vorsicht.** Caution *\* Use Never Refresh with caution. Auf dem Berichtsserver wird UsedInQuery verwendet, um Cacheoptionen für Berichtsdaten und gerenderte Berichte sowie Parameteroptionen für Momentaufnahmeberichte steuern zu können.On the report server, UsedInQuery is used to help control cache options for report data and for rendered reports, and parameter options for snapshot reports. Wenn Sie Nie aktualisieren falsch festgelegt haben, können falsche Berichtsdaten oder Berichte zwischengespeichert werden oder inkonsistente Daten in Momentaufnahmeberichten entstehen.If you set Never Refresh incorrectly, you could cause incorrect report data or reports to be cached, or cause a snapshot report to have inconsistent data. Weitere Informationen finden Sie unter Berichtsdefinitionssprache (Report Definition Language, RDL) (SSRS).For more information, see Report Definition Language (SSRS).

Datasetabfrage Dataset Query

Um Daten in der Datasetabfrage zu filtern, können Sie eine Einschränkungsklausel einschließen, mit der die abgerufenen Daten begrenzt werden. Geben Sie dazu die Werte ein, die im Resultset eingeschlossen oder daraus ausgeschlossen werden sollen.To filter data in the dataset query, you can include a restriction clause that limits the retrieved data by specifying values to include or exclude from the result set.

Verwenden Sie den Abfrage-Designer für die Datenquelle, um eine parametrisierte Abfrage zu erstellen.Use the query designer for the data source to help build a parameterized query.

  • Im Falle von Transact-SQLTransact-SQL -Abfragen unterstützen verschiedene Datenquellen eine unterschiedliche Parametersyntax.For Transact-SQLTransact-SQL queries, different data sources support different syntax for parameters. Unterstützt werden Parameter, die in der Abfrage anhand der Position oder des Namens identifiziert werden.Support ranges from parameters that are identified in the query by position or by name. Weitere Informationen finden Sie in den Themen zu spezifischen externen Datenquellentypen unter Berichtsdatasets (SSRS).For more information, see topics for specific external data source types in Report Datasets (SSRS). Im relationalen Abfrage-Designer müssen Sie die Parameteroption für einen Filter auswählen, um eine parametrisierte Abfrage zu erstellen.In the relational query designer, you must select the parameter option for a filter to create a parameterized query. Weitere Informationen finden Sie unter Benutzeroberfläche des relationalen Abfrage-Designers (Berichts-Generator).For more information, see Relational Query Designer User Interface (Report Builder).

  • Für Abfragen, die auf einer mehrdimensionalen Datenquelle wie Microsoft SQL Server Analysis Services, SAP NetWeaver BI oder Hyperion Essbase basieren, können Sie angeben, ob ein Parameter auf Basis eines Filters erstellt werden soll, den Sie im Abfrage-Designer angeben.For queries that are based on a multidimensional data source such as Microsoft SQL Server Analysis Services, SAP NetWeaver BI, or Hyperion Essbase, you can specify whether to create a parameter based on a filter that you specify in the query designer. Weitere Informationen finden Sie unter Abfrage-Designer (Berichts-Generator) im Thema über den entsprechenden Abfrage-Designer für die Datenerweiterung.For more information, see the query designer topic in Query Designers (Report Builder) that corresponds to the data extension.

Parameterverwaltung für einen veröffentlichten Bericht Parameter Management for a Published Report

Wenn Sie einen Bericht entwerfen, werden Berichtsparameter in der Berichtsdefinition gespeichert.When you design a report, report parameters are saved in the report definition. Wenn Sie einen Bericht veröffentlichen, werden Berichtsparameter getrennt von der Berichtsdefinition gespeichert und verwaltet.When you publish a report, report parameters are saved and managed separately from the report definition.

Für einen veröffentlichten Bericht können Sie Folgendes verwenden:For a published report, you can use the following:

  • Berichtsparametereigenschaften.Report parameter properties. Ändern Sie Berichtsparameterwerte direkt auf dem Berichtsserver, unabhängig von der Berichtsdefinition.Change report parameter values directly on the report server independently from the report definition.

  • Zwischengespeicherte Berichte.Cached reports. Zum Erstellen eines Cacheplans für einen Bericht muss jeder Parameter über einen Standardwert verfügen.To create a cache plan for a report, each parameter must have a default value. Weitere Informationen finden Sie unter Zwischenspeichern von Berichten (SSRS).For more information, see Caching Reports (SSRS).

  • Zwischengespeicherte freigegebene Datasets.Cached shared datasets. Zum Erstellen eines Cacheplans für ein freigegebenes Dataset muss jeder Parameter über einen Standardwert verfügen.To create a cache plan for a shared dataset, each parameter must have a default value. Weitere Informationen finden Sie unter Zwischenspeichern von Berichten (SSRS).For more information, see Caching Reports (SSRS).

  • Verknüpfte Berichte.Linked reports. Sie können verknüpfte Berichte mit voreingestellten Parameterwerten erstellen, um Daten für verschiedene Zielgruppen zu filtern.You can create linked reports with preset parameter values to filter data for different audiences. Weitere Informationen finden Sie unter Erstellen eines verknüpften Berichts.For more information, see Create a Linked Report.

  • Berichtsabonnements.Report subscriptions. Sie können Parameterwerte angeben, um Daten unter Verwendung von Abonnements zu filtern und Berichte unter Verwendung von Abonnements zu übermitteln.You can specify parameter values to filter data and deliver reports through subscriptions. Weitere Informationen finden Sie unter Abonnements und Übermittlung (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

  • URL-ZugriffURL access. Sie können Parameterwerte in einer URL zu einem Bericht angeben.You can specify parameter values in a URL to a report. Sie können auch Berichte ausführen und Parameterwerte mit URL-Zugriff angeben.You can also run reports and specify parameter values using URL access. Weitere Informationen finden Sie unter URL-Zugriff (SSRS).For more information, see URL Access (SSRS).

    Parametereigenschaften für einen veröffentlichten Bericht bleiben im Allgemeinen erhalten, wenn Sie die Berichtsdefinition erneut veröffentlichen.Parameter properties for a published report are generally preserved if you republish the report definition. Falls die Berichtsdefinition als derselbe Bericht erneut veröffentlicht wird und die Parameternamen und Datentypen unverändert sind, bleiben die Eigenschaftseinstellungen erhalten.If the report definition is republished as the same report, and parameter names and data types remain the same, your property settings are retained. Wenn Sie Parameter in der Berichtsdefinition hinzufügen bzw. löschen oder den Datentyp oder den Namen eines vorhandenen Parameters ändern, müssen Sie möglicherweise die Parametereigenschaften in dem veröffentlichten Bericht ändern.If you add or delete parameters in the report definition, or change the data type or name of an existing parameter, you may need to change the parameter properties in the published report.

    Nicht alle Parameter können in jedem Fall geändert werden.Not all parameters can be modified in all cases. Wenn ein Berichtsparameter einen Standardwert aus einer Datasetabfrage abruft, kann der Wert für einen veröffentlichten Bericht und im Berichtsserver nicht geändert werden.If a report parameter gets a default value from a dataset query, that value cannot be modified for a published report and cannot be modified on the report server. Der zur Laufzeit verwendete Wert wird bestimmt, wenn die Abfrage ausgeführt wird oder bei ausdruckbasierten Parametern, wenn der Ausdruck ausgewertet wird.The value that is used at run time is determined when the query runs, or in the case of expression-based parameters, when the expression is evaluated.

    Die Optionen für die Berichtsausführung können die Verarbeitung von Parametern beeinflussen.Report execution options can affect how parameters are processed. Für einen Bericht, der als Momentaufnahme ausgeführt wird, sind keine Parameter zulässig, die von einer Abfrage abgeleitet sind, außer die Abfrage enthält Standardwerte für die Parameter.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

Parameter für ein Abonnement Parameters for a Subscription

Sie können ein Abonnement bedarfsgesteuert oder für eine Momentaufnahme definieren und Parameterwerte angeben, die während der Abonnementverarbeitung verwendet werden sollen.You can define a subscription for an on demand or for a snapshot and specify parameter values to use during subscription processing.

  • Bedarfsgesteuerter Bericht.On demand report. Für einen bedarfsgesteuerten Bericht können Sie einen Parameterwert angeben, der sich von dem veröffentlichten Wert unterscheidet, der für den Bericht aufgeführt ist.For an on demand report, you can specify a different parameter value than the published value for each parameter listed for the report. Angenommen, ein Telefonservicebericht verwendet den Parameter Time Period , um Kundendienstanforderungen für den aktuellen Tag, die aktuelle Woche oder den aktuellen Monat zurückzugeben.For example, suppose you have a Call Service report that uses a Time Period parameter to return customer service requests for the current day, week, or month. Wenn der Standardparameterwert für den Bericht auf todayfestgelegt ist, kann Ihr Abonnement mithilfe eines anderen Parameterwertes (z.B. week oder month) einen Bericht mit wöchentlichen oder monatlichen Zahlen erstellen.If the default parameter value for the report is set to today, your subscription can use a different parameter value (such as week or month) to produce a report that contains weekly or monthly figures.

  • Momentaufnahme.Snapshot. Für eine Momentaufnahme muss das Abonnement die für die Momentaufnahme definierten Parameterwerte verwenden.For a snapshot, your subscription must use the parameter values defined for the snapshot. Das Abonnement kann einen Parameterwert, der für eine Momentaufnahme definiert ist, nicht überschreiben.Your subscription cannot override a parameter value that is defined for a snapshot. Angenommen, Sie abonnieren einen Umsatzbericht für die Westregion, der als Berichtsmomentaufnahme ausgeführt wird, und die Momentaufnahme gibt Western als regionalen Parameterwert an.For example, suppose you are subscribing to a Western regional sales report that runs as a report snapshot, and the snapshot specifies Western as a regional parameter value. Wenn Sie in diesem Fall ein Abonnement für diesen Bericht erstellen, müssen Sie den Parameterwert Western im Abonnement verwenden.In this case, if you create a subscription to this report, you must use the parameter value Western in your subscription. Als optischer Hinweis, dass der Parameter ignoriert wird, werden die Parameterfelder auf der Abonnementseite als schreibgeschützte Felder festgelegt.To provide a visual indication that the parameter is ignored, the parameter fields on the subscription page are set to read-only fields.

    Die Optionen für die Berichtsausführung können die Verarbeitung von Parametern beeinflussen.Report execution options can affect how parameters are processed. Parametrisierte Berichte, die als Berichtsmomentaufnahmen ausgeführt werden, verwenden die für die Berichtsmomentaufnahme definierten Parameterwerte.Parameterized reports that run as report snapshots use the parameter values defined for the report snapshot. Parameterwerte werden auf der Seite für die Parametereigenschaften des Berichts definiert.Parameter values are defined in the parameter properties page of the report. Für einen Bericht, der als Momentaufnahme ausgeführt wird, sind keine Parameter zulässig, die von einer Abfrage abgeleitet sind, außer die Abfrage enthält Standardwerte für die Parameter.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

    Wenn sich nach dem Definieren des Abonnements ein Parameterwert in der Berichtsmomentaufnahme ändert, deaktiviert der Berichtsserver das Abonnement.If a parameter value changes in the report snapshot after the subscription is defined, the report server deactivates the subscription. Das Deaktivieren des Abonnements zeigt an, dass der Bericht geändert wurde.Deactivating the subscription indicates that the report has been modified. Um das Abonnement zu aktivieren, öffnen und speichern Sie das Abonnement.To activate the subscription, open and then save the subscription.

Hinweis

Datengesteuerte Abonnements können Parameterwerte verwenden, die aus einer Abonnentendatenquelle abgerufen werden.Data-driven subscriptions can use parameter values that are obtained from a subscriber data source. Weitere Informationen finden Sie unter Verwenden einer externen Datenquelle für Abonnentendaten (datengesteuertes Abonnement).For more information, see Use an External Data Source for Subscriber Data (Data-Driven Subscription).

Weitere Informationen finden Sie unter Abonnements und Übermittlung (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

Parameter und das Sichern von Daten Parameters and Securing Data

Gehen Sie beim Verteilen von parametrisierten Berichten, die vertrauliche Informationen enthalten, mit Vorsicht vor.Use caution when distributing parameterized reports that contain confidential or sensitive information. Ein Benutzer kann auf einfache Weise einen Berichtsparameter durch einen anderen Wert ersetzen. Dies führt dazu, dass unbeabsichtigt Informationen veröffentlicht werden.A user can easily replace a report parameter with a different value, resulting in information disclosure that you did not intend.

Eine sichere Alternative zum Verwenden von Parametern für Mitarbeiterdaten oder persönliche Daten besteht darin, Daten basierend auf Ausdrücken auszuwählen, die das UserID -Feld aus der Users-Auflistung enthalten.A secure alternative to using parameters for employee or personal data is to select data based on expressions that include the UserID field from the Users collection. Die Users-Auflistung stellt eine Methode bereit, um die Identität des Benutzers, der den Bericht ausführt, abzurufen und diese Identität zum Abrufen von benutzerspezifischen Daten zu verwenden.The Users collection provides a way to get the identity of the user running the report, and use that identity to retrieve user-specific data.

Wichtig

Verwenden Sie in einem Bericht, der einen Parameter vom Typ Stringenthält, eine Liste der verfügbaren Werte (wird auch als Liste der gültigen Werte bezeichnet), und stellen Sie sicher, dass Benutzer, die den Bericht ausführen, nur über die Berechtigungen verfügen, die zum Anzeigen der Daten im Bericht erforderlich sind.In any report that includes a parameter of type String, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. Wenn Sie einen Parameter vom Typ Stringdefinieren, wird für den Benutzer ein Textfeld bereitgestellt, das jeden beliebigen Wert annehmen kann.When you define a parameter of type String, the user is presented with a text box that can take any value. Mit einer Liste der verfügbaren Werte werden die Werte eingeschränkt, die eingegeben werden können.An available values list limits the values that can be entered. Wenn der Berichtsparameter an einen Datasetparameter gebunden ist und Sie keine Liste mit verfügbaren Werten verwenden, kann ein Benutzer des Berichts SQL-Syntax in das Textfeld eingeben. Damit öffnet er den Bericht und Ihren Server potenziell für einen SQL-Injection-Angriff.If the report parameter is tied to a dataset parameter and you do not use an available values list, it is possible for a report user to type SQL syntax into the text box, potentially opening the report and your server to a SQL injection attack. Wenn der Benutzer über Berechtigungen zum Ausführen der neuen SQL-Anweisung verfügt, können daraus unerwünschte Ergebnisse auf dem Server resultieren.If the user has sufficient permissions to execute the new SQL statement, it may produce unwanted results on the server.

Wenn ein Berichtsparameter nicht an einen Datasetparameter gebunden ist und die Parameterwerte im Bericht enthalten sind, können die Benutzer des Berichts Ausdruckssyntax oder eine URL in den Parameterwert eingeben und den Bericht für Excel oder HTML rendern.If a report parameter is not tied to a dataset parameter and the parameter values are included in the report, it is possible for a report user to type expression syntax or a URL into the parameter value, and render the report to Excel or HTML. Wenn anschließend ein anderer Benutzer den Bericht anzeigt und auf die gerenderten Parameterinhalte klickt, führt der Benutzer möglicherweise unbeabsichtigt das bösartige Skript bzw. den bösartigen Link aus.If another user then views the report and clicks the rendered parameter contents, the user may inadvertently execute the malicious script or link.

Um das Risiko der versehentlichen Ausführung schädlicher Skripts zu minimieren, sollten gerenderte Berichte nur aus vertrauenswürdigen Quellen geöffnet werden.To mitigate the risk of inadvertently running malicious scripts, open rendered reports only from trusted sources. Weitere Informationen zum Sichern von Berichten finden Sie unter Sichere Berichte und Ressourcen.For more information about securing reports, see Secure Reports and Resources.

Themen zur Vorgehensweise How-To Topics

In diesem Abschnitt finden Sie Prozeduren, in denen Schritt für Schritt das Arbeiten mit Parametern und Filtern erläutert wird.This section lists procedures that show you, step by step, how to work with parameters and filters.

Konfigurieren von SSRS-Berichtsparametern (Quiz)Configuring SSRS Report Parameters (quiz)

Tutorial: Hinzufügen eines Parameters zum Bericht (Berichts-Generator)Tutorial: Add a Parameter to Your Report (Report Builder)

BerichtsparameterkonzepteReport Parameters Concepts

Berichtsbeispiele (Berichts-Generator und SSRS)Report Samples (Report Builder and SSRS)

Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)Expression Uses in Reports (Report Builder and SSRS)

Ausdrücke (Berichts-Generator und SSRS)Expressions (Report Builder and SSRS)

Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS)Filter, Group, and Sort Data (Report Builder and SSRS)

Sicherheit (Berichts-Generator)Security (Report Builder)

Interaktive Sortierung, Dokumentstrukturen und Links (Berichts-Generator und SSRS)Interactive Sort, Document Maps, and Links (Report Builder and SSRS)

Drillthrough, Drilldown, Unterberichte und geschachtelte Datenbereiche (Berichts-Generator und SSRS)Drillthrough, Drilldown, Subreports, and Nested Data Regions (Report Builder and SSRS)