Del via

URL-parametre i sideinddelte rapporter i Power BI

  • Artikel

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

Du kan sende kommandoer til sideinddelte rapporter i Power BI ved at føje en parameter til en URL-adresse. Du kan f.eks. have fået vist rapporten ved hjælp af et bestemt sæt rapportparameterværdier. Du indkapsler disse oplysninger i URL-adressen ved hjælp af foruddefinerede URL-adgangsparametre. Du kan yderligere tilpasse, hvordan Power BI behandler rapporten, ved at integrere parametre for gengivelsesformater eller for udseendet af værktøjslinjen i rapporten. Du kan derefter indsætte denne URL-adresse direkte i en mail eller på en webside, så andre oplever din rapport på samme måde i browseren.

Her er handlinger, du kan udføre via URL-adgangsparametre:

  • Send rapportparametre til en rapport.
  • Start eksporten af rapportindholdet i et understøttet filformat.
  • Skjul eller få vist ruden med parametre.
  • Angiv indstillingen DeviceInfo .

Du kan se en komplet liste over kommandoer og indstillinger, der er tilgængelige via URL-adgang, under Reference til URL-adgangsparameter i denne artikel.

Url-adgangsbegreber

URL-anmodninger til Power BI indeholder parametre, der behandles af tjenesten. Den måde, som tjenesten håndterer URL-anmodninger på, afhænger af parametre, parameterpræfikser og typer af elementer, der er inkluderet i URL-adressen. Funktionaliteten for URL-adresser til sideinddelte rapporter er kompatibel med de fleste browsere og programmer, der understøtter standardadresseadresser.

URL-adgangssyntaks

URL-anmodninger kan indeholde flere parametre, der er angivet i en vilkårlig rækkefølge. Parametre adskilles med et &-tegn (&). Navne- og værdipar adskilles af et lighedstegn (=). Eksempler:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value

Syntaksbeskrivelse

powerbiservicereporturl

Den Power BI-tjeneste URL-adresse til din sideinddelte rapport. Eksempler:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Bruges til at adskille powerbiservicereporturl og URL-adgangsparametrene.

&

Bruges til at adskille navne- og værdipar for URL-adgangsparametre.

præfiks

Et præfiks for URL-parameteren, der angiver en handling i Power BI-tjeneste. For eksempel rp: eller rdl:.

parameter

Parameternavnet.

værdi

URL-tekst, der svarer til værdien af den parameter, der bruges.

Reference til URL-rapportparameter

Du kan overføre rapportparametre til en rapport ved at inkludere dem i en URL-adresse til en sideinddelt rapport.

Rapportparametre (rp:)

Du kan se eksempler på overførsel af rapportparametre i en URL-adresse under Overfør en rapportparameter i en URL-adresse.

Bemærk

Rapportparametre kræver parameterpræfikset rp: og skelner mellem store og små bogstaver.

Reference til URL-adgangsparameter

Du kan bruge følgende parametre som en del af en URL-adresse til at konfigurere udseendet af dine sideinddelte rapporter i Power BI. De mest almindelige parametre er angivet i dette afsnit. Der skelnes mellem store og små bogstaver i parametrene, og de starter med parameterpræfikset rdl: , hvis de er relateret til outputformatet.

Rapportkommandoer (rdl:)

Eksportér format

Angiver det format, en rapport skal gengives og eksporteres i.

  • Eksempel: rdl:format=PDF

Tilgængelige værdier:

  • PPTX (PowerPoint)
  • MHTML
  • BILLEDE
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

Rapportvisning

Angiver den type visning, der bruges til at vise rapporten.

  • rdl:reportView

Tilgængelige værdier:

  • interactive (standard): indlæser rapporten i interaktiv tilstand.
  • pageView: indlæser rapporten i sidevisningstilstand.

Parameterpanel

Angiver, om parameterpanelet er lukket eller åbent, når rapporten indlæses, eller om den er helt skjult.

  • rdl:parameterPanel

Tilgængelige værdier:

  • skjult: indlæser rapporten med parameterpanelet lukket. Parameterknappen er aktiveret, så brugerne kan vælge den knap, der skal udvides.
  • hidden: indlæser rapporten med parameterpanelet lukket, og parameterknappen er deaktiveret.
  • expanded (standard): indlæser rapporten med parameterpanelet åbent, og parameterknappen er aktiveret.

Enhedsoplysninger

Du kan angive yderligere outputparametre for følgende eksportformater.

  • PDF/ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV:

    Bemærk

    I forbindelse med disse strengværdier skal du se indstillinger for CSV-enhedsoplysninger.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD):

    • rdl:AutoFit=string –> Sand/Falsk/Aldrig/Standard
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false

  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Encoding=string
    • rdl:Indrykket=sand/falsk
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Du kan føje rdl:targetSameWindow=true til url-adressen til linket i din rapport for at få Power BI til at åbne dette link i det samme browservindue. Du kan få oplysninger om, hvordan du føjer links til en rapport, under Føj et link til en URL-adresse.

Relateret indhold