Rapportparameters in Power BI Report Builder

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

In dit artikel worden de algemene toepassingen voor Power BI Report Builder-rapportparameters, de eigenschappen die u kunt instellen en nog veel meer beschreven. Met rapportparameters kunt u rapportgegevens beheren, gerelateerde rapporten met elkaar verbinden en de rapportpresentatie variëren. U kunt rapportparameters gebruiken in gepagineerde rapporten die u in Report Builder maakt.

Algemene toepassingen voor parameters

Hier volgen enkele van de meest voorkomende manieren om parameters te gebruiken.

Gepagineerde rapportgegevens beheren:

• Filter gepagineerde rapportgegevens in de gegevensbron door gegevenssetquery's te schrijven die variabelen bevatten.

• Hiermee kunnen gebruikers waarden opgeven om de gegevens in een gepagineerd rapport aan te passen. Geef bijvoorbeeld twee parameters op voor de begindatum en einddatum voor verkoopgegevens.

Rapportpresentatie variëren:

• Hiermee kunnen gebruikers waarden opgeven om het uiterlijk van een rapport aan te passen. Geef bijvoorbeeld een Booleaanse parameter op om aan te geven of alle geneste rijgroepen in een tabel moeten worden uitgevouwen of samengevouwen.

• Gebruikers toestaan rapportgegevens en weergaven aan te passen door parameters in een expressie op te geven.

Een rapport met parameters weergeven

Wanneer u een rapport met parameters bekijkt, wordt op de werkbalk van de rapportviewer elke parameter weergegeven, zodat u interactief waarden kunt opgeven. In de volgende afbeelding ziet u het parametergebied voor een rapport met parameters@ReportMonth, , @ReportYear, @EmployeeID@ShowAll, @ExpandTableRows, , @CategoryQuotaen @SalesDate.

1. Deelvenster Parameters. Op de werkbalk van de rapportviewer wordt een prompt en standaardwaarde voor elke parameter weergegeven. U kunt de indeling van parameters in het deelvenster Parameters aanpassen.

2. @SalesDate parameter. De parameter @SalesDate is het gegevenstype DateTime. De prompt Selecteer de datum wordt naast het tekstvak weergegeven. Als u de datum wilt wijzigen, typt u een nieuwe datum in het tekstvak, gebruikt u het agenda-besturingselement of selecteert u Naar vandaag gaan.

3. @ShowAll parameter. De parameter @ShowAll is het gegevenstype Booleaanse waarde. Gebruik de keuzerondjes om Waar of Onwaar op te geven.

4. De greep parametergebied weergeven of verbergen. Selecteer deze pijl op de werkbalk van de rapportviewer om het deelvenster Parameters weer te geven of te verbergen.

5. @CategoryQuota parameter. De parameter @CategoryQuota is gegevenstype Float, dus er wordt een numerieke waarde gebruikt. @CategoryQuota is ingesteld om meerdere waarden toe te staan.

6. Rapport weergeven. Nadat u parameterwaarden hebt ingevoerd, selecteert u Rapport weergeven om het rapport uit te voeren. Als alle parameters standaardwaarden hebben, wordt het rapport automatisch uitgevoerd in de eerste weergave.

Bekijk hoe uw klanten werken met parameters in uw gepagineerde rapporten in het artikel Parameters weergeven voor gepagineerde rapporten in de Power BI-service.

Parameters maken

U kunt rapportparameters op verschillende manieren maken.

Notitie

Niet alle gegevensbronnen ondersteunen parameters.

Gegevenssetquery of opgeslagen procedure met parameters

Voeg een gegevenssetquery toe die variabelen of een opgeslagen procedure voor gegevenssets bevat die invoerparameters bevat. Er wordt een gegevenssetparameter gemaakt voor elke variabele of invoerparameter en er wordt een rapportparameter gemaakt voor elke parameter van de gegevensset.

In deze afbeelding van Report Builder ziet u:

1. De rapportparameters in het deelvenster Rapportgegevens .

2. De gegevensset met de parameters.

3. Het deelvenster Parameters .

4. De parameters die worden vermeld in het dialoogvenster Eigenschappen van gegevensset.

Handmatig een parameter maken

Maak handmatig een parameter vanuit het deelvenster Rapportgegevens . U kunt rapportparameters zo configureren dat een gebruiker interactief waarden kan invoeren om de inhoud of het uiterlijk van een rapport aan te passen. U kunt ook rapportparameters configureren zodat een gebruiker vooraf geconfigureerde waarden niet kan wijzigen.

Notitie

Omdat parameters onafhankelijk van de server worden beheerd, worden de bestaande parameterinstellingen in het rapport niet overschreven door het opnieuw publiceren van een hoofdrapport met nieuwe parameterinstellingen.

Parameterwaarden selecteren

De volgende opties zijn voor het selecteren van parameterwaarden in het rapport.

• Selecteer één parameterwaarde in een vervolgkeuzelijst.

• Selecteer meerdere parameterwaarden in een vervolgkeuzelijst.

• Selecteer een waarde in een vervolgkeuzelijst voor één parameter, waarmee de waarden worden bepaald die beschikbaar zijn in de vervolgkeuzelijst voor een andere parameter. Dit zijn trapsgewijze parameters. Met trapsgewijze parameters kunt u opeenvolgend parameterwaarden filteren van duizenden waarden naar een beheerbaar getal. Zie Trapsgewijze parameters gebruiken in gepagineerde rapporten voor meer informatie.

• Voer het rapport uit zonder eerst een parameterwaarde te selecteren omdat er een standaardwaarde is gemaakt voor de parameter.

Eigenschappen van rapportparameter

U kunt de eigenschappen van de rapportparameter wijzigen met behulp van het dialoogvenster Rapporteigenschappen . De volgende tabel bevat een overzicht van de eigenschappen die u voor elke parameter kunt instellen:

Eigenschappen	Beschrijving
Naam	Typ een hoofdlettergevoelige naam voor de parameter. De naam moet beginnen met een letter en kan letters, cijfers of een onderstrepingsteken (_) bevatten. De naam mag geen spaties bevatten. Voor automatisch gegenereerde parameters komt de naam overeen met de parameter in de gegevenssetquery. Handmatig gemaakte parameters zijn standaard vergelijkbaar met ReportParameter1.
Prompt	De tekst die naast de parameter op de werkbalk van de rapportviewer wordt weergegeven.
Gegevenstype	Een rapportparameter moet een van de volgende gegevenstypen zijn: Booleaanse waarde. De gebruiker selecteert Waar of Onwaar in een keuzerondje. DateTime. De gebruiker typt een nieuwe datum in het tekstvak, selecteert een datum in een agenda-besturingselement of selecteert Ga naar vandaag. Geheel getal. De gebruiker typt waarden in een tekstvak. Float. De gebruiker typt waarden in een tekstvak. Tekst. De gebruiker typt waarden in een tekstvak. Wanneer beschikbare waarden zijn gedefinieerd voor een parameter, kiest de gebruiker waarden in een vervolgkeuzelijst, zelfs wanneer het gegevenstype DateTime is.
Lege waarde toestaan	Selecteer deze optie als de waarde van de parameter een lege tekenreeks of een lege tekenreeks kan zijn. Als u geldige waarden opgeeft voor een parameter en u wilt dat een lege waarde een van de geldige waarden is, moet u deze opnemen als een van de waarden die u opgeeft. Als u deze optie selecteert, wordt er niet automatisch een lege waarde voor beschikbare waarden opgenomen.
Null-waarde toestaan	Selecteer deze optie als de waarde van de parameter null kan zijn. Als u geldige waarden opgeeft voor een parameter en u wilt dat null een van de geldige waarden is, moet u null opnemen als een van de waarden die u opgeeft. Als u deze optie selecteert, wordt er niet automatisch een null voor beschikbare waarden opgenomen.
Meerdere waarden toestaan	Geef beschikbare waarden op om een vervolgkeuzelijst te maken waaruit uw gebruikers kunnen kiezen. Dit is een goede manier om ervoor te zorgen dat alleen geldige waarden worden verzonden in de gegevenssetquery. Selecteer deze optie als de waarde voor de parameter meerdere waarden kan zijn die worden weergegeven in een vervolgkeuzelijst. Null-waarden zijn niet toegestaan. Wanneer deze optie is ingeschakeld, worden selectievakjes toegevoegd aan de lijst met beschikbare waarden in een vervolgkeuzelijst met parameters. De bovenkant van de lijst bevat een selectievakje voor Alles selecteren. Gebruikers kunnen de gewenste waarden controleren. Als de gegevens die waarden opleveren snel veranderen, is de lijst die de gebruiker ziet mogelijk niet de meest recente.
Zichtbaar	Selecteer deze optie om de rapportparameter boven aan het rapport weer te geven wanneer deze wordt uitgevoerd. Met deze optie kunnen gebruikers parameterwaarden selecteren tijdens runtime.
Verborgen	Selecteer deze optie om de rapportparameter in het gepubliceerde rapport te verbergen. De rapportparameterwaarden kunnen nog steeds worden ingesteld op een rapport-URL, in een abonnementsdefinitie of op de rapportserver.
Intern	Selecteer deze optie om de rapportparameter te verbergen. In het gepubliceerde rapport kan de rapportparameter alleen worden weergegeven in de rapportdefinitie.
Beschikbare waarden	Als u beschikbare waarden voor een parameter hebt opgegeven, worden de geldige waarden altijd weergegeven als een vervolgkeuzelijst. Als u bijvoorbeeld beschikbare waarden opgeeft voor een DateTime-parameter , wordt er een vervolgkeuzelijst voor datums weergegeven in het parametervenster in plaats van een agendabesturingselement. Om ervoor te zorgen dat een lijst met waarden consistent is tussen een rapport en subrapporten, kunt u een optie voor de gegevensbron instellen om één transactie te gebruiken voor alle query's in de gegevenssets die zijn gekoppeld aan een gegevensbron. Beveiligingsnotitie: Zorg ervoor dat u in een rapport met een parameter van het gegevenstype Tekst een lijst met beschikbare waarden (ook wel een geldige waardenlijst genoemd) gebruikt en ervoor zorgt dat elke gebruiker die het rapport uitvoert alleen de machtigingen heeft die nodig zijn om de gegevens in het rapport weer te geven.
Standaardwaarden	Stel standaardwaarden in vanuit een query of vanuit een statische lijst. Wanneer elke parameter een standaardwaarde heeft, wordt het rapport automatisch uitgevoerd in de eerste weergave.
Geavanceerd	Stel het rapportdefinitiekenmerk UsedInQuery in, een waarde die aangeeft of deze parameter direct of indirect van invloed is op de gegevens in een rapport. Automatisch bepalen wanneer moet worden vernieuwd Kies deze optie als u wilt dat de rapportprocessor een instelling voor deze waarde bepaalt. De waarde is Waar als de rapportprocessor een gegevenssetquery detecteert met een directe of indirecte verwijzing naar deze parameter of als het rapport subrapporten bevat. Altijd vernieuwen Kies deze optie wanneer de rapportparameter direct of indirect wordt gebruikt in een gegevenssetquery of parameterexpressie. Met deze optie stelt UsedInQuery in op True. Nooit vernieuwen Kies deze optie wanneer de rapportparameter niet direct of indirect wordt gebruikt in een gegevenssetquery of parameterexpressie. Met deze optie stelt UsedInQuery in op False. Waarschuwing: Gebruik nooit vernieuwen met voorzichtigheid. Op de rapportserver wordt UsedInQuery gebruikt om cacheopties voor rapportgegevens en voor weergegeven rapporten en parameteropties voor momentopnamerapporten te beheren. Als u Nooit vernieuwen onjuist instelt, kunt u ervoor zorgen dat onjuiste rapportgegevens of rapporten in de cache worden opgeslagen of dat een momentopnamerapport inconsistente gegevens bevat.

Gegevenssetquery

Als u gegevens in de gegevenssetquery wilt filteren, kunt u een beperkingscomponent opnemen waarmee de opgehaalde gegevens worden beperkt door waarden op te geven die moeten worden opgenomen of uitgesloten van de resultatenset.

Gebruik de ontwerpfunctie voor query's voor de gegevensbron om een geparameteriseerde query te bouwen.

• Voor Transact-SQL-query's ondersteunen verschillende gegevensbronnen verschillende syntaxis voor parameters. Ondersteuningsbereiken van parameters die in de query worden geïdentificeerd op positie of op naam. In de ontwerpfunctie voor relationele query's moet u de parameteroptie voor een filter selecteren om een geparameteriseerde query te maken.

• 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.

Parameterbeheer voor een gepubliceerd rapport

Wanneer u een rapport ontwerpt, worden rapportparameters opgeslagen in de rapportdefinitie. Wanneer u een rapport publiceert, worden rapportparameters afzonderlijk van de rapportdefinitie opgeslagen en beheerd.

Voor een gepubliceerd rapport kunt u de volgende parameters gebruiken:

• Rapportparametereigenschappen. Wijzig rapportparameterwaarden rechtstreeks op de rapportserver onafhankelijk van de rapportdefinitie.

• Rapportabonnementen. U kunt parameterwaarden opgeven om gegevens te filteren en rapporten te leveren via abonnementen.

Parametereigenschappen voor een gepubliceerd rapport blijven behouden als u de rapportdefinitie opnieuw publiceert. Als de rapportdefinitie opnieuw wordt gepubliceerd als hetzelfde rapport en parameternamen en gegevenstypen hetzelfde blijven, blijven uw eigenschapsinstellingen behouden. Als u parameters toevoegt of verwijdert in de rapportdefinitie of het gegevenstype of de naam van een bestaande parameter wijzigt, moet u mogelijk de parametereigenschappen in het gepubliceerde rapport wijzigen.

Niet alle parameters kunnen in alle gevallen worden gewijzigd. Als een rapportparameter een standaardwaarde ophaalt uit een gegevenssetquery, kan die waarde niet worden gewijzigd voor een gepubliceerd rapport en kan deze niet worden gewijzigd op de rapportserver. De waarde die tijdens de runtime wordt gebruikt, wordt bepaald wanneer de query wordt uitgevoerd, of in het geval van parameters op basis van expressies, wanneer de expressie wordt geëvalueerd.

Rapportuitvoeringsopties kunnen van invloed zijn op de wijze waarop parameters worden verwerkt. Een rapport dat wordt uitgevoerd als een momentopname, kan geen parameters gebruiken die zijn afgeleid van een query, tenzij de query standaardwaarden voor de parameters bevat.

Parameters voor een abonnement

U kunt een abonnement definiëren voor een rapport op aanvraag of voor een momentopname en parameterwaarden opgeven die moeten worden gebruikt tijdens de verwerking van het abonnement.

• Rapport op aanvraag. Voor een rapport op aanvraag kunt u een andere parameterwaarde opgeven dan de gepubliceerde waarde voor elke parameter die voor het rapport wordt vermeld. Stel dat u een gespreksservicerapport hebt dat gebruikmaakt van een parameter Tijdsperiode voor het retourneren van klantenserviceaanvragen voor de huidige dag, week of maand. Als de standaardparameterwaarde voor het rapport op vandaag is ingesteld, kan uw abonnement een andere parameterwaarde (zoals week of maand) gebruiken om een rapport te maken dat wekelijkse of maandelijkse cijfers bevat.

Gerelateerde inhoud

• Wat zijn gepagineerde rapporten in Power BI?
• Trapsgewijze parameters gebruiken in gepagineerde rapporten