Rapportparameters in Power BI Report BuilderReport parameters in Power BI Report Builder

In dit onderwerp worden de gebruikelijke toepassingen van rapportparameters van Power BI Report Builder, de eigenschappen die u kunt instellen, en nog veel meer beschreven.This topic describes the common uses for Power BI Report Builder report parameters, the properties you can set, and much more. Met behulp van rapportparameters kunt u rapportgegevens beheren, gerelateerde rapporten met elkaar verbinden en de presentatie van rapporten variëren.Report parameters enable you to control report data, connect related reports together, and vary report presentation. U kunt rapportparameters gebruiken in gepagineerde rapporten die u in Report Builder maakt.You can use report parameters in paginated reports you create in Report Builder.

Veelvoorkomende toepassingen van parametersCommon uses for parameters

Hier volgen enkele veelvoorkomende manieren om parameters te gebruiken.Here are some of the most common ways to use parameters.

Gegevens voor gepagineerde rapporten beherenControl paginated report data

  • Filter gegevens voor gepagineerde rapporten in de gegevensbron door gegevenssetquery's te schrijven die variabelen bevatten.Filter paginated report data at the data source by writing dataset queries that contain variables.

  • Stel gebruikers in staat om waarden op te geven voor het aanpassen van de gegevens op een gepagineerd rapport.Enable users to specify values to customize the data in a paginated report. Bied bijvoorbeeld twee parameters aan voor de begin- en einddatum van verkoopgegevens.For example, provide two parameters for the start date and end date for sales data.

De rapportpresentatie variërenVary report presentation

  • Stel gebruikers in staat waarden op te geven waarmee ze de weergave van het rapport kunnen aanpassen.Enable users to specify values to help customize the appearance of a report. Bied bijvoorbeeld een booleaanse parameter aan om alle geneste rijgroepen in een tabel uit te vouwen of samen te vouwen.For example, provide a Boolean parameter to indicate whether to expand or collapse all nested row groups in a table.

  • Stel gebruikers in staat om rapportgegevens en de weergave ervan aan te passen door parameters op te nemen in een expressie.Enable users to customize report data and appearance by including parameters in an expression.

Een gepagineerd rapport met parameters weergevenViewing a report with parameters

Wanneer u een rapport met parameters weergeeft, wordt elke parameter weergegeven op de werkbalk van de rapportviewer zodat u interactief waarden kunt opgeven.When you view a report that has parameters, the report viewer toolbar displays each parameter so you can interactively specify values. In de volgende illustratie ziet u het parametergebied voor een rapport met de parameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota en @SalesDate.The following illustration shows the parameter area for a report with parameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, and @SalesDate.

Rapport met parameters weergevenView report with parameters

  1. Het deelvenster Parameters Op de werkbalk van de rapportviewer wordt voor elke parameter een prompt en een standaardwaarde weergegeven.Parameters pane The report viewer toolbar displays a prompt and default value for each parameter. U kunt de indeling van de parameters aanpassen in het deelvenster Parameters.You can customize the layout of parameters in the parameters pane.

  2. @SalesDate parameter de parameter @SalesDate gegevenstype datum-/ .@SalesDate parameter The parameter @SalesDate is data type DateTime. De prompt Selecteer de datum wordt naast het tekstvak weergegeven.The prompt Select the Date appears next to the text box. U kunt de datum wijzigen door een nieuwe datum in het tekstvak te typen of het kalenderbesturingselement te gebruiken.To modify the date, type a new date in the text box or use the calendar control.

  3. @ShowAll parameter de parameter @ShowAll gegevenstype Booleaanse.@ShowAll parameter The parameter @ShowAll is data type Boolean. Gebruik de keuzerondjes om Waar of Onwaar op te geven.Use the radio buttons to specify True or False.

  4. De greep Parametergebied weergeven of verbergen Op de werkbalk van de rapportviewer klikt u op deze pijl om het parametervenster weer te geven of te verbergen.Show or Hide Parameter Area handle On the report viewer toolbar, click this arrow to show or hide the parameters pane.

  5. @CategoryQuota parameter de parameter @CategoryQuota gegevenstype drijvende komma, zodat het duurt een numerieke waarde voordat.@CategoryQuota parameter The parameter @CategoryQuota is data type Float, so it takes a numeric value. @CategoryQuota is zo ingesteld dat er meerdere waarden zijn toegestaan.@CategoryQuota is set to allow multiple values.

  6. Rapport weergeven Nadat u parameterwaarden hebt ingevoerd, klikt u op Rapport weergeven om het rapport uit te voeren.View Report After you enter parameter values, click View Report to run the report. Als alle parameters standaardwaarden hebben, wordt het rapport bij de eerste weergave automatisch uitgevoerd.If all parameters have default values, the report runs automatically on first view.

Parameters makenCreating parameters

U kunt op verschillende manieren rapportparameters maken.You can create report parameters in a few different ways.

Notitie

Niet alle gegevensbronnen ondersteunen parameters.Not all data sources support parameters.

Een gegevenssetquery of opgeslagen procedure met parametersDataset query or stored procedure with parameters

Voeg een gegevenssetquery die variabelen bevat of een in de gegevensset opgeslagen procedure die invoerparameters bevat toe.Add a dataset query that contains variables or a dataset stored procedure that contains input parameters. Er wordt een gegevenssetparameter gemaakt voor elke variabele of invoerparameter en er wordt een rapportparameter gemaakt voor elke gegevenssetparameter.A dataset parameter is created for each variable or input parameter, and a report parameter is created for each dataset parameter.

Eigenschappen van parametergegevensset in Report BuilderReport Builder Parameter Dataset Properties

Op deze afbeelding van Report Builder is het volgende te zien:This image from Report Builder shows:

  1. De rapportparameters in het deelvenster Rapportgegevens.The report parameters in the Report Data pane.

  2. De gegevensset met de parameters.The dataset with the parameters.

  3. Het deelvenster Parameters.The Parameters pane.

  4. De parameters die worden weergegeven in het dialoogvenster Eigenschappen van gegevensset.The parameters listed in the Dataset Properties dialog box.

Handmatig een parameter makenCreate a parameter manually

Maak een parameter handmatig in het deelvenster Rapportgegevens.Create a parameter manually from the Report Data pane. U kunt rapportparameters configureren zodat een gebruiker interactief waarden kan invoeren om de inhoud of de weergave van een rapport aan te passen.You can configure report parameters so that a user can interactively enter values to help customize the contents or appearance of a report. U kunt ook zelf rapportparameters configureren, zodat een gebruiker vooraf geconfigureerde waarden niet kan wijzigen.You can also configure report parameters so that a user cannot change preconfigured values.

Notitie

Omdat parameters afzonderlijk op de server worden beheerd, worden de bestaande parameterinstellingen van een hoofdrapport niet overschreven als het rapport opnieuw wordt gepubliceerd met nieuwe parameterinstellingen.Because parameters are managed independently on the server, republishing a main report with new parameter settings doesn't overwrite the existing parameters settings on the report.

ParameterwaardenParameter values

Hieronder vindt u opties voor het selecteren van parameterwaarden in het rapport.The following are options for selecting parameter values in the report.

  • Eén parameterwaarde selecteren in een vervolgkeuzelijst.Select a single parameter value from a drop-down list.

  • Meerdere parameterwaarden selecteren in een vervolgkeuzelijst.Select multiple parameter values from a drop-down list.

  • Een waarde voor één parameter selecteren in een vervolgkeuzelijst, waarmee wordt bepaald welke waarden beschikbaar zijn in de vervolgkeuzelijst voor een andere parameter.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. Dit zijn trapsgewijze parameters.These are cascading parameters. Met trapsgewijze parameters kunt u achter elkaar parameterwaarden van duizenden waarden filteren tot een beheersbaar getal.Cascading parameters enables you to successively filter parameter values from thousands of values to a manageable number. Raadpleeg Trapsgewijze parameters in gepagineerde rapporten gebruiken voor meer informatie.For more information, see Use cascading parameters in paginated reports.

  • Het rapport uitvoeren zonder eerst een parameterwaarde te moeten selecteren omdat er een standaardwaarde voor de parameter is gemaakt.Run the report without having to first select a parameter value because a default value has been created for the parameter.

Eigenschappen van rapportparametersReport parameter properties

U kunt de eigenschappen van rapportparameters wijzigen in het dialoogvenster Rapporteigenschappen.You can change the report parameter properties by using the Report Properties dialog box. De volgende tabel biedt een overzicht van de eigenschappen die u voor elke parameter kunt instellen:The following table summarizes the properties that you can set for each parameter:

EigenschapProperty DescriptionDescription
NaamName Typ een hoofdlettergevoelige naam voor de parameter.Type a case-sensitive name for the parameter. De naam moet beginnen met een letter en mag letters, cijfers en onderstrepingstekens () bevatten.The name must begin with a letter and can have letters, numbers, an underscore (). De naam mag geen spaties bevatten.The name cannot have spaces. De naam van automatisch gegenereerde parameters komt overeen met de parameter in de gegevenssetquery.For automatically generated parameters, the name matches the parameter in the dataset query. Standaard zijn handmatig gemaakte parameters gelijk aan ReportParameter1.By default, manually created parameters are similar to ReportParameter1.
OptiePrompt De tekst die op de werkbalk van de rapportviewer naast de parameter wordt weergegeven.The text that appears next to the parameter on the report viewer toolbar.
GegevenstypeData type Een rapportparameter moet een van de volgende gegevenstypen hebben:A report parameter must be one of the following data types:

Booleaans.Boolean. De gebruiker selecteert Waar of Onwaar in een keuzerondje.The user selects True or False from a radio button.

Datum/tijd.DateTime. De gebruiker selecteert een datum in een kalenderbesturingselement.The user selects a date from a calendar control.

Geheel getal.Integer. De gebruiker typt waarden in een tekstvak.The user types values in a text box.

Drijvend.Float. De gebruiker typt waarden in een tekstvak.The user types values in a text box.

Tekst.Text. De gebruiker typt waarden in een tekstvak.The user types values in a text box.

Wanneer er beschikbare waarden voor een parameter zijn gedefinieerd, kiest de gebruiker waarden in een vervolgkeuzelijst, ook wanneer het gegevenstype Datum/tijd is.When available values are defined for a parameter, the user chooses values from a drop-down list, even when the data type is DateTime.
Lege waarde toestaanAllow blank value Selecteer deze optie als de waarde van de parameter een lege tekenreeks of blanco mag zijn.Select this option if the value of the parameter can be an empty string or a blank.

Als u bij het opgeven van geldige waarden voor een parameter wilt dat een lege waarde ook geldig is, moet u deze lege waarde ook opgeven.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. Bij selectie van deze optie wordt niet automatisch een lege waarde bij de beschikbare waarden opgenomen.Selecting this option doesn't automatically include a blank for available values.
De waarde null toestaanAllow null value Selecteer deze optie als de waarde van de parameter null mag zijn.Select this option if the value of the parameter can be a null.

Als u bij het opgeven van geldige waarden voor een parameter wilt dat null ook een geldige waarde is, moet u null ook opgeven.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. Bij selectie van deze optie wordt null niet automatisch bij de beschikbare waarden opgenomen.Selecting this option doesn't automatically include a null for available values.
Meerdere waarden toestaanAllow multiple values Geef beschikbare waarden op om een vervolgkeuzelijst te maken waaruit uw gebruikers kunnen kiezen.Provide available values to create a drop-down list that your users can choose from. Dit is een goede manier om ervoor te zorgen dat alleen geldige waarden worden opgegeven in de gegevenssetquery.This is a good way to ensure that only valid values are submitted in the dataset query.

Selecteer deze optie als de waarde voor de parameter mag bestaan uit meerdere waarden die worden weergegeven in een vervolgkeuzelijst.Select this option if the value for the parameter can be multiple values that are displayed in a drop-down list. De waarde null is niet toegestaan.Null values are not allowed. Wanneer deze optie is geselecteerd, worden er selectievakjes toegevoegd aan de lijst met beschikbare waarden in de vervolgkeuzelijst voor een parameter.When this option is selected, check boxes are added to the list of available values in a parameter drop-down list. Bovenaan de lijst komt het selectievakje Alles selecteren.The top of the list includes a check box for Select All. Gebruikers kunnen de gewenste waarden selecteren.Users can check the values that they want.

Als de gegevens voor de waarden snel worden gewijzigd, is de lijst die de gebruiker te zien krijgt mogelijk niet de meest recente.If the data that provides values changes rapidly, the list the user sees might not be the most current.
ZichtbaarVisible Selecteer deze optie om de rapportparameter bovenaan het rapport weer te geven wanneer het wordt uitgevoerd.Select this option to display the report parameter at the top of the report when it's run. Met deze optie kunnen gebruikers tijdens de uitvoering parameterwaarden selecteren.This option allows users to select parameter values at run time.
VerborgenHidden Selecteer deze optie om de rapportparameter te verbergen in het gepubliceerde rapport.Select this option to hide the report parameter in the published report. De waarden voor rapportparameters kunnen nog steeds worden ingesteld in een rapport-URL, in een abonnementsdefinitie of op de rapportserver.The report parameter values can still be set on a report URL, in a subscription definition, or on the report server.
InternInternal Selecteer deze optie om de rapportparameter te verbergen.Select this option to hide the report parameter. In het gepubliceerde rapport kan de rapportparameter alleen worden weergegeven in de rapportdefinitie.In the published report, the report parameter can only be viewed in the report definition.
Beschikbare waardenAvailable values Als u de beschikbare waarden voor een parameter hebt opgegeven, worden de geldige waarden altijd in een vervolgkeuzelijst weergegeven.If you have specified available values for a parameter, the valid values always appear as a drop-down list. Als u bijvoorbeeld beschikbare waarden opgeeft voor een DateTime-parameter, wordt er een vervolgkeuzelijst voor datums weergegeven in het deelvenster in plaats van een kalenderbesturingselement.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.

U kunt ervoor zorgen dat een lijst met waarden consistent blijft binnen rapporten en subrapporten door voor de gegevensbron de optie in te stellen dat er een enkele transactie wordt gebruikt voor alle query's in de gegevenssets die zijn gekoppeld aan een gegevensbron.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.

Beveiligingsopmerking Zorg er voor elk rapport met een parameter van het gegevenstype Tekst voor dat u een lijst met beschikbare/geldige waarden gebruikt en dat elke gebruiker die het rapport uitvoert alleen beschikt over de machtigingen die nodig zijn om de gegevens in het rapport weer te geven.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.
StandaardwaardenDefault values Stel standaardwaarden in via een query of een statische lijst.Set default values from a query or from a static list.

Wanneer elke parameter een standaardwaarde heeft, wordt het rapport bij de eerste weergave automatisch uitgevoerd.When each parameter has a default value, the report runs automatically on first view.
GeavanceerdAdvanced Stel het rapportdefinitiekenmerk UsedInQuery in. Dat is een waarde die aangeeft of deze parameter direct of indirect invloed heeft op de gegevens in een rapport.Set the report definition attribute UsedInQuery, a value that indicates whether this parameter directly or indirectly affects the data in a report.

Automatisch bepalen wanneer moet worden vernieuwdAutomatically determine when to refresh
Kies deze optie als u wilt dat de instelling van deze waarde door de rapportprocessor wordt bepaald.Choose this option when you want the report processor to determine a setting for this value. De waarde is Waar als er een gegevenssetquery met een directe of indirecte verwijzing naar deze parameter wordt gedetecteerd, of als het rapport subrapporten bevat.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.

Altijd vernieuwenAlways refresh
Selecteer deze optie wanneer de rapportparameter direct of indirect wordt gebruikt in een gegevenssetquery of parameterexpressie.Choose this option when the report parameter is used directly or indirectly in a dataset query or parameter expression. Met deze optie stelt u UsedInQuery in op Waar.This option sets UsedInQuery to True.

Nooit vernieuwenNever refresh
Selecteer deze optie wanneer de rapportparameter niet direct of indirect wordt gebruikt in een gegevenssetquery of parameterexpressie.Choose this option when the report parameter is not used directly or indirectly in a dataset query or parameter expression. Met deze optie stelt u UsedInQuery in op Onwaar.This option sets UsedInQuery to False.

Waarschuwing Pas op met het gebruik van Nooit vernieuwen.Caution Use Never Refresh with caution. Op de rapportserver wordt UsedInQuery gebruikt bij het beheren van cacheopties voor rapportgegevens en voor weergegeven rapporten en van parameteropties voor momentopnamerapporten.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. Als u Nooit vernieuwen verkeerd instelt, kan dit leiden tot onjuiste rapportgegevens, ertoe leiden dat rapporten in de cache worden opgeslagen of dat momentopnamerapporten inconsistente gegevens bevatten.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.

GegevenssetqueryDataset query

Als u gegevens in de gegevenssetquery wilt filteren, kunt u een component opnemen om de opgehaalde gegevens te beperken door op te geven welke waarden moeten worden opgenomen in- of uitgesloten van de resultatenset.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.

Gebruik de queryontwerpfunctie voor de gegevensbron bij het maken van een geparameteriseerde query.Use the query designer for the data source to help build a parameterized query.

  • Voor Transact-SQL-query's bieden verschillende gegevensbronnen ondersteuning voor verschillende syntaxissen voor parameters.For Transact-SQL queries, different data sources support different syntax for parameters. De ondersteuning varieert van parameters die in de query worden geïdentificeerd op basis van de positie of op basis van de naam.Support ranges from parameters that are identified in the query by position or by name. In de ontwerpfunctie voor relationele query's moet u de parameteroptie voor een filter selecteren om een geparameteriseerde query te maken.In the relational query designer, you must select the parameter option for a filter to create a parameterized query.

  • Voor query's die zijn gebaseerd op een multidimensionale gegevensbron, zoals Microsoft SQL Server Analysis Services, kunt u opgeven of u een parameter wilt maken op basis van een filter dat u opgeeft in de ontwerpfunctie voor query's.For queries that are based on a multidimensional data source such as Microsoft SQL Server Analysis Services, you can specify whether to create a parameter based on a filter that you specify in the query designer.

Parameters voor een gepubliceerd rapport beherenParameter management for a published report

Wanneer u een rapport ontwerpt, worden de rapportparameters opgeslagen in de rapportdefinitie.When you design a report, report parameters are saved in the report definition. Wanneer u een rapport publiceert, worden de rapportparameters afzonderlijk van de rapportdefinitie opgeslagen en beheerd.When you publish a report, report parameters are saved and managed separately from the report definition.

Voor een gepubliceerd rapport kunt u gebruikmaken van de volgende items:For a published report, you can use the following:

  • Eigenschappen van rapportparameters.Report parameter properties. Wijzig waarden voor rapportparameters rechtstreeks op de rapportserver, onafhankelijk van de rapportdefinitie.Change report parameter values directly on the report server independently from the report definition.

  • Rapportabonnementen.Report subscriptions. U kunt parameterwaarden opgeven om gegevens te filteren en rapporten te leveren via abonnementen.You can specify parameter values to filter data and deliver reports through subscriptions.

Parametereigenschappen voor een gepubliceerd rapport blijven behouden als u de rapportdefinitie opnieuw publiceert.Parameter properties for a published report are preserved if you republish the report definition. Als de rapportdefinitie opnieuw wordt gepubliceerd als hetzelfde rapport en de parameternamen en gegevenstypen gelijk blijven, blijven de instellingen voor de eigenschappen behouden.If the report definition is republished as the same report, and parameter names and data types remain the same, your property settings are retained. Als u parameters toevoegt aan of verwijdert uit de rapportdefinitie of als u de naam van een bestaande parameter wijzigt, moet u de parametereigenschappen in het gepubliceerde rapport mogelijk wijzigen.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.

Niet alle parameters kunnen in alle gevallen worden gewijzigd.Not all parameters can be modified in all cases. Als een rapportparameter een standaardwaarde krijgt via een gegevenssetquery, kan die waarde niet worden gewijzigd voor een gepubliceerd rapport en niet worden gewijzigd op de rapportserver.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. De waarde die tijdens de uitvoering wordt gebruikt, wordt bepaald wanneer de query wordt uitgevoerd, of voor parameters op basis van een expressie wanneer de expressie wordt geëvalueerd.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.

Uitvoeringsopties voor een rapport kunnen invloed hebben op de verwerkingswijze van parameters.Report execution options can affect how parameters are processed. Een rapport dat wordt uitgevoerd als een momentopname kan niet gebruikmaken van parameters die worden opgehaald via een query, tenzij de query standaardwaarden voor de parameters bevat.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.

Parameters voor een abonnementParameters for a subscription

U kunt een abonnement voor een rapport op aanvraag of voor een momentopname definiëren en opgeven welke parameterwaarden moeten worden gebruikt tijdens de verwerking van het abonnement.You can define a subscription for an on demand or for a snapshot and specify parameter values to use during subscription processing.

  • Rapport op aanvraag.On-demand report. Voor een rapport op aanvraag kunt u een andere parameterwaarde opgeven dan de gepubliceerde waarde die voor elke parameter voor het rapport is vermeld.For an on-demand report, you can specify a different parameter value than the published value for each parameter listed for the report. Stel bijvoorbeeld dat u een rapport Belservice hebt, waarmee op basis van de parameter Periode de klantenserviceaanvragen van de huidige dag, week of maand worden geretourneerd.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. Als de standaardwaarde van de parameterwaarde voor het rapport is ingesteld op Vandaag, kan er in uw abonnement een andere parameterwaarde worden gebruikt (zoals Week of Maand) om een rapport met week- of maandcijfers te produceren.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.

Volgende stappenNext steps