Een rapportparameter doorgeven binnen een URL voor een gepagineerd Power BI-rapport

  • Artikel

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

U kunt rapportparameters doorgeven aan een rapport door ze op te slaan in een rapport-URL voor gepagineerde rapporten. Deze URL-parameters worden niet voorafgegaan omdat ze rechtstreeks worden doorgegeven aan de rapportverwerkingsengine.

Alle queryparameters kunnen overeenkomende rapportparameters hebben. U geeft een queryparameter door aan een rapport door de bijbehorende rapportparameter door te geven. Zie Een query maken in de relationele ontwerpfunctie voor query's (Power BI Report Builder) voor meer informatie.

Gepagineerde rapportparameterregels

Rapportparameters zijn hoofdlettergevoelig en gebruiken de volgende speciale tekens:

  • Spatietekens in de URL-tekenreeks worden vervangen door de tekens %20, volgens url-coderingsstandaarden.
  • Een spatieteken in het parametergedeelte van de URL wordt vervangen door een plusteken (+).
  • Een puntkomma in een deel van de tekenreeks wordt vervangen door de tekens %3A.
  • Browsers moeten automatisch de juiste URL-codering uitvoeren. U hoeft geen van de tekens handmatig te coderen.
  • Als u de proxysyntaxis niet opneemt, moet u de parameter vooraf laten gaan door rp:.

Voorbeelden van gepagineerde rapportparameters

Als u een rapportparameter in een URL wilt instellen, gebruikt u de volgende syntaxis:

  
rp:parameter=value

Als u bijvoorbeeld twee parameters wilt opgeven: 'Verkoper' en 'Staat', gedefinieerd in een rapport in Mijn werkruimte, gebruikt u de volgende URL:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Als u dezelfde twee parameters wilt opgeven die zijn gedefinieerd in een rapport in een app, gebruikt u de volgende URL:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Gebruik de volgende syntaxis om een null-waarde voor een parameter door te geven:

  
parameter:isnull=true

Bijvoorbeeld:

rp:SalesOrderNumber:isnull=true

Als u een Booleaanse waarde wilt doorgeven, gebruikt u 0 voor onwaar en 1 voor waar. Als u een Float-waarde wilt doorgeven, neemt u het decimaalteken van de landinstelling van de server op.

Notitie

Als uw rapport een rapportparameter bevat met een standaardwaarde en de waarde van de eigenschap Prompt onwaar is (de eigenschap Gebruiker vragen is niet geselecteerd in Report Manager), kunt u geen waarde doorgeven voor die rapportparameter binnen een URL. Dit biedt beheerders een optie om te voorkomen dat eindgebruikers de waarden van bepaalde rapportparameters toevoegen of wijzigen.

Aanvullende voorbeelden

Het volgende URL-voorbeeld bevat een parameter met meerdere waarden 'Verkoper'. De indeling voor een parameter met meerdere waarden is het herhalen van de parameternaam voor elke waarde.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

In het volgende URL-voorbeeld wordt één parameter van SellStartDate doorgegeven met de waarde 7/1/2005.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Overwegingen en beperkingen

  • Als uw rapport een rapportparameter bevat met een standaardwaarde en de waarde van de eigenschap Prompt onwaar is (dat wil gezegd, de eigenschap Gebruiker vragen is niet geselecteerd in Power BI Report Builder), kunt u geen waarde doorgeven voor die rapportparameter binnen een URL. Dit biedt beheerders de mogelijkheid om te voorkomen dat eindgebruikers de waarden van bepaalde rapportparameters toevoegen of wijzigen.
  • Power BI biedt geen ondersteuning voor een queryreeks van meer dan 2000 tekens. U kunt deze waarde per ongeluk overschrijden als u URL-parameters gebruikt om uw gepagineerde rapport weer te geven, met name als uw queryreeks meerdere parameterwaarden bevat. Verminder het aantal tekens tot minder dan 2000 tekens om het rapport correct te laden.
  • De limiet in de querytekenreeks wordt geëvalueerd nadat u bent aangemeld bij Power BI. Als u het rapport opent voordat u zich aanmeldt, wordt de limiet verlaagd.

Gerelateerde inhoud