Del via

Overfør en rapportparameter i en URL-adresse til en sideinddelt rapport i Power BI

  • Artikel

GÆLDER FOR: Power BI Report Builder Power BI Desktop

Du kan overføre rapportparametre til en rapport ved at inkludere dem i en URL-adresse til en rapport for sideinddelte rapporter. Disse URL-parametre har ikke præfiks, fordi de overføres direkte til programmet til rapportbehandling.

Alle forespørgselsparametre kan have tilsvarende rapportparametre. Du sender en forespørgselsparameter til en rapport ved at overføre den tilsvarende rapportparameter. Du kan få flere oplysninger under Opret en forespørgsel i Relationsforespørgselsdesigner (Power BI Report Builder).

Regler for sideinddelte rapportparametre

Der skelnes mellem store og små bogstaver i rapportparametre, og følgende specialtegn anvendes:

  • Alle mellemrumstegn i URL-strengen erstattes med tegnene "%20" i henhold til KODNINGsstandarder for URL-adresser.
  • Et mellemrumstegn i parameterdelen af URL-adressen erstattes med et plustegn (+).
  • Et semikolon i en del af strengen erstattes med tegnene "%3A".
  • Browsere skal automatisk udføre den korrekte URL-kodning. Du behøver ikke at kode nogen af tegnene manuelt.
  • Hvis du ikke inkluderer proxysyntaksen, skal du foranfikse parameteren med rp:.

Eksempler på sideinddelte rapportparametre

Hvis du vil angive en rapportparameter i en URL-adresse, skal du bruge følgende syntaks:

  
rp:parameter=value

Hvis du f.eks. vil angive to parametre" "Salesperson" og "State", der er defineret i en rapport i Mit arbejdsområde, skal du bruge 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 angive de samme to parametre, der er defineret i en rapport i en app, skal du bruge 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 overføre en null-værdi for en parameter, skal du bruge følgende syntaks:

  
parameter:isnull=true

Eksempel

rp:SalesOrderNumber:isnull=true

Hvis du vil overføre en boolesk værdi, skal du bruge 0 for false og 1 for true. Hvis du vil overføre en flydende værdi, skal du inkludere decimalseparatoren for serverens landestandard.

Bemærk

Hvis rapporten indeholder en rapportparameter, der har en standardværdi, og værdien af egenskaben Prompt er falsk (dvs. egenskaben Spørg bruger ikke er valgt i Rapportstyring), kan du ikke overføre en værdi for den pågældende rapportparameter i en URL-adresse. Dette giver administratorer mulighed for at forhindre slutbrugere i at tilføje eller ændre værdierne for visse rapportparametre.

Yderligere eksempler

Følgende eksempel på URL-adresse indeholder parameteren "Salesperson" med flere værdier. Formatet for en parameter med flere værdier er at gentage parameternavnet for hver værdi.

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

I følgende eksempel på URL-adresse overføres en enkelt parameter for SellStartDate med værdien "7/1/2005".

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

Overvejelser og begrænsninger

  • Hvis din rapport indeholder en rapportparameter, der har en standardværdi, og værdien af egenskaben Prompt er falsk (dvs. egenskaben Spørg bruger ikke er valgt i Power BI Report Builder), kan du ikke overføre en værdi for den pågældende rapportparameter i en URL-adresse. Dette giver administratorer mulighed for at forhindre slutbrugere i at tilføje eller ændre værdierne for visse rapportparametre.
  • Power BI understøtter ikke en forespørgselsstreng på mere end 2.000 tegn. Du kan utilsigtet overskride denne værdi, hvis du bruger URL-parametre til at få vist din sideinddelte rapport, især hvis forespørgselsstrengen indeholder flere parameterværdier. Hvis du vil indlæse rapporten korrekt, skal du reducere antallet af tegn til under 2.000.
  • Grænsen i forespørgselsstrengen evalueres, når du er logget på Power BI. Hvis du åbner rapporten, før du logger på, reduceres grænsen.
  • De understøttede datoformater til overførsel af rapportparametre i en URL-adresse er ISO (ÅÅÅÅ-MM-DD) og en-US (MM/DD/ÅÅÅÅ).

Relateret indhold