Dela via

Skicka en rapportparameter i en URL för en sidnumrerad Power BI-rapport

  • Artikel

GÄLLER FÖR: Power BI Report Builder Power BI Desktop

Du kan skicka rapportparametrar till en rapport genom att inkludera dem i en rapport-URL för sidnumrerade rapporter. Dessa URL-parametrar är inte prefix eftersom de skickas direkt till rapportbearbetningsmotorn.

Alla frågeparametrar kan ha motsvarande rapportparametrar. Du skickar en frågeparameter till en rapport genom att skicka motsvarande rapportparameter. Mer information finns i Skapa en fråga i Relationsfrågedesignern (Power BI Report Builder).

Regler för sidnumrerade rapportparametrar

Rapportparametrar är skiftlägeskänsliga och använder följande specialtecken:

  • Blankstegstecken i URL-strängen ersätts med tecknen %20 enligt URL-kodningsstandarder.
  • Ett blankstegstecken i parameterdelen av URL:en ersätts med ett plustecken (+).
  • Ett semikolon i någon del av strängen ersätts med tecknen %3A.
  • Webbläsare bör automatiskt utföra rätt URL-kodning. Du behöver inte koda något av tecknen manuellt.
  • Om du inte inkluderar proxysyntaxen prefixar du parametern med rp:.

Exempel på sidnumrerade rapportparametrar

Om du vill ange en rapportparameter i en URL använder du följande syntax:

  
rp:parameter=value

Om du till exempel vill ange två parametrar, "Säljare" och "Tillstånd", som definieras i en rapport i Min arbetsyta, använder du följande URL:

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

Om du vill ange samma två parametrar som definierats i en rapport i en app använder du följande 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

Om du vill skicka ett null-värde för en parameter använder du följande syntax:

  
parameter:isnull=true

Exempel:

rp:SalesOrderNumber:isnull=true

Om du vill skicka ett booleskt värde använder du 0 för false och 1 för true. Om du vill skicka ett float-värde inkluderar du decimalavgränsaren för serverspråket.

Kommentar

Om rapporten innehåller en rapportparameter som har ett standardvärde och värdet för egenskapen Fråga är falskt (dvs. egenskapen Fråga användare är inte markerad i Rapporthanteraren) kan du inte skicka ett värde för rapportparametern i en URL. Detta ger administratörer ett alternativ för att hindra slutanvändare från att lägga till eller ändra värdena för vissa rapportparametrar.

Ytterligare exempel

Följande URL-exempel innehåller en parameter med flera värden "Säljare". Formatet för en parameter med flera värden är att upprepa parameternamnet för varje värde.

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

I följande URL-exempel skickas en enda parameter av SellStartDate med värdet "7/1/2005".

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

Beaktanden och begränsningar

  • Om rapporten innehåller en rapportparameter som har ett standardvärde och värdet för egenskapen Prompt är falskt (dvs. egenskapen Fråga användare är inte markerad i Power BI Report Builder) kan du inte skicka ett värde för rapportparametern i en URL. Detta ger administratörer möjlighet att hindra slutanvändare från att lägga till eller ändra värdena för vissa rapportparametrar.
  • Power BI stöder inte en frågesträng på mer än 2 000 tecken. Du kan oavsiktligt överskrida det här värdet om du använder URL-parametrar för att visa din sidnumrerade rapport, särskilt om frågesträngen innehåller flera parametervärden. Om du vill läsa in rapporten korrekt minskar du antalet tecken till under 2 000.
  • Gränsen i frågesträngen utvärderas när du har loggat in på Power BI. Om du öppnar rapporten innan du loggar in minskas gränsen.

Relaterat innehåll