Sende en rapportparameter i en nettadresse for en paginert Power BI-rapport
GJELDER FOR: Power BI Report Builder Power BI Desktop
Du kan sende rapportparametere til en rapport ved å inkludere dem i en nettadresse for rapporter for paginerte rapporter. Disse URL-parameterne er ikke prefikset fordi de sendes direkte til rapportbehandlingsmotoren.
Alle spørringsparametere kan ha tilsvarende rapportparametere. Du sender en spørringsparameter til en rapport ved å sende den tilsvarende rapportparameteren. Hvis du vil ha mer informasjon, kan du se Bygge en spørring i relasjonsspørringsutforming (Power BI Report Builder).
Parameterregler for paginert rapport
Rapportparametere skiller mellom store og små bokstaver og bruker følgende spesialtegn:
- Eventuelle mellomromstegn i url-strengen erstattes med tegnene %20, i henhold til standarder for nettadressekoding.
- Et mellomromstegn i parameterdelen av URL-adressen erstattes med et plusstegn (+).
- Et semikolon i en hvilken som helst del av strengen erstattes med tegnene %3A.
- Nettlesere skal automatisk utføre riktig nettadressekoding. Du trenger ikke å kode noen av tegnene manuelt.
- Hvis du ikke inkluderer proxy-syntaksen, prefikser du parameteren med rp:.
Eksempler på sideformatert rapportparameter
Hvis du vil angi en rapportparameter i en NETTADRESSE, bruker du følgende syntaks:
rp:parameter=value
Hvis du for eksempel vil angi to parametere, «Selger» og «Stat», definert i en rapport i Mitt arbeidsområde, bruker du følgende URL-adresse:
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah
Hvis du vil angi de samme to parameterne som er definert i en rapport i en app, bruker du følgende URL-adresse:
https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah
Hvis du vil sende en nullverdi for en parameter, bruker du følgende syntaks:
parameter:isnull=true
Eksempel:
rp:SalesOrderNumber:isnull=true
Hvis du vil sende en boolsk verdi, bruker du 0 for usann og 1 for sann. Hvis du vil sende en flytverdi , må du inkludere desimalskilletegnet for de nasjonale innstillingene for serveren.
Merk
Hvis rapporten inneholder en rapportparameter som har en standardverdi, og verdien for ledetekstegenskapen er usann (det vil si at egenskapen Spør bruker ikke er valgt i Rapportbehandling), kan du ikke sende en verdi for denne rapportparameteren i en URL-adresse. Dette gir administratorer et alternativ for å hindre sluttbrukere i å legge til eller endre verdiene for bestemte rapportparametere.
Flere eksempler
Følgende nettadresseeksempel inneholder en flerverdiparameter «Selger». Formatet for en flerverdiparameter er å gjenta parameternavnet for hver verdi.
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey
Følgende nettadresseeksempel sender én enkelt parameter for SellStartDate med verdien «01.07.2005».
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005
Hensyn og begrensninger
- Hvis rapporten inneholder en rapportparameter som har en standardverdi, og verdien for ledetekstegenskapen er usann (det vil si at egenskapen Spør bruker ikke er valgt i Power BI Report Builder), kan du ikke sende en verdi for denne rapportparameteren i en NETTADRESSE. Dette gir administratorer muligheten til å hindre sluttbrukere i å legge til eller endre verdiene for bestemte rapportparametere.
- Power BI støtter ikke en spørringsstreng på mer enn 2000 tegn. Du kan utilsiktet overskride denne verdien hvis du bruker NETTADRESSE-parametere til å vise den paginerte rapporten, spesielt hvis spørringsstrengen inneholder flere parameterverdier. Hvis du vil laste inn rapporten på riktig måte, reduserer du antall tegn til under 2000.
- Grensen i spørringsstrengen evalueres etter at du er logget på Power BI. Hvis du åpner rapporten før du logger på, reduseres grensen.