Del via

URL-parametere i paginerte rapporter i Power BI

  • Artikkel

GJELDER FOR: Power BI Report Builder Power BI Desktop

Du kan sende kommandoer til paginerte rapporter i Power BI ved å legge til en parameter i en NETTADRESSE. Du kan for eksempel ha vist rapporten ved hjelp av et bestemt sett med rapportparameterverdier. Du kapsler inn denne informasjonen i nettadressen ved hjelp av forhåndsdefinerte parametere for url-tilgang. Du tilpasser ytterligere hvordan Power BI behandler rapporten ved å bygge inn parametere for gjengivelsesformater, eller for utseendet og funksjonaliteten til rapportverktøylinjen. Deretter limer du inn denne nettadressen direkte i en e-postmelding eller nettside, slik at andre opplever rapporten på samme måte i nettleseren.

Her er handlinger du kan utføre gjennom url-tilgangsparametere:

  • Send rapportparametere til en rapport.
  • Start eksporten av rapportinnholdet i et filformat som støttes.
  • Skjule eller vise parameterruten.
  • Angi DeviceInfo-innstilling .

Hvis du vil ha en fullstendig liste over kommandoer og innstillinger som er tilgjengelige via URL-tilgang, kan du se parameterreferansen for url-tilgang i denne artikkelen.

Konsepter for url-tilgang

URL-forespørsler til Power BI inneholder parametere som behandles av tjenesten. Måten tjenesten håndterer URL-forespørsler på, avhenger av parameterne, parameterprefiksene og typene elementer som er inkludert i nettadressen. Nettadressefunksjonalitet for paginert rapport er kompatibel med de fleste nettlesere og programmer som støtter standard nettadresseadressering.

Syntaks for url-tilgang

URL-forespørsler kan inneholde flere parametere, oppført i hvilken som helst rekkefølge. Parametere er atskilt med et &ersand (&). Navn og verdipar er atskilt med et likhetstegn (=). Eksempel:

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

Syntaksbeskrivelse

powerbiservicereporturl

DEN Power Bi-tjeneste URL-adressen til den paginerte rapporten. Eksempel:

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

?

Brukes til å skille powerbiservicereporturl og url-tilgangsparameterne.

&

Brukes til å skille navn og verdipar for url-tilgangsparametere.

Prefiks

Et prefiks for URL-parameteren som angir en handling i Power Bi-tjeneste. For eksempel, rp: eller rdl:.

parameter

Parameternavnet.

verdi

URL-adressetekst som tilsvarer verdien for parameteren som brukes.

Referanse for url-rapportparameter

Du kan sende rapportparametere til en rapport ved å inkludere dem i en nettadresse for paginert rapport.

Rapportparametere (rp:)

Hvis du vil ha eksempler på å sende rapportparametere i en NETTADRESSE, kan du se Sende en rapportparameter i en NETTADRESSE.

Merk

Rapportparametere krever parameterprefikset rp: og skiller mellom store og små bokstaver.

Referanse for url-tilgangsparameter

Du kan bruke følgende parametere som en del av en nettadresse for å konfigurere utseendet og funksjonaliteten til de paginerte rapportene i Power BI. De vanligste parameterne er oppført i denne delen. Parametere skilles ikke mellom store og små bokstaver, og begynner med parameterprefikset rdl: hvis det er relatert til utdataformatet.

Rapportkommandoer (rdl:)

Eksportformat

Angir formatet du vil gjengi og eksportere en rapport i.

  • Eksempel: rdl:format=PDF

Tilgjengelige verdier:

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

Rapportvisning

Angir hvilken type visning som skal brukes til å vise rapporten.

  • rdl:reportView

Tilgjengelige verdier:

  • interaktiv (standard): laster inn rapporten i interaktiv modus.
  • pageView: laster inn rapporten i sidevisningsmodus.

Parameterpanel

Angir om parameterpanelet lukkes eller åpnes når rapporten lastes inn, eller er skjult helt.

  • rdl:parameterPanel

Tilgjengelige verdier:

  • skjult: laster inn rapporten med parameterpanelet lukket. Parameterknappen er aktivert slik at brukere kan velge knappen for å utvide.
  • skjult: laster inn rapporten med parameterpanelet lukket og parameterknappen deaktivert.
  • utvidet (standard): laster inn rapporten med parameterpanelet åpent og parameterknappen aktivert.

Enhetsinformasjon

Du kan angi flere utdataparametere for følgende eksportformater.

  • PDF / ACCESSIBLEPDF:

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

  • CSV:

    Merk

    For disse strengverdiene kan du referere til CSV-enhetsinformasjonsinnstillinger.

    • rdl:Koding=streng
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Kvalifikator=streng
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD):

    • rdl:Beste tilpassing=streng –> sann/usann/aldri/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=heltall
    • rdl:DpiY=heltall
    • rdl:EndPage=heltall
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=desimal(i)
    • rdl:MarginTop=desimal(i)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=heltall
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Koding=streng
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Du kan legge rdl:targetSameWindow=true til nettadressen for hyperkoblingen i rapporten for å få Power BI til å åpne denne hyperkoblingen i samme nettleservindu. Hvis du vil ha informasjon om hvordan du legger til hyperkoblinger i en rapport, kan du se Legge til en hyperkobling i en nettadresse.

Relatert innhold