URL-parametrit Power BI:n sivutetuissa raporteissa
KOSKEE: Power BI Report Builder Power BI Desktop
Voit lähettää komentoja Power BI:n sivutettuihin raportteihin lisäämällä parametrin URL-osoitteeseen. Olet esimerkiksi saattanut tarkastella raporttia käyttämällä tiettyä raporttiparametriarvojen joukkoa. Kapseloit nämä tiedot URL-osoitteeseen käyttämällä esimääritettyjä URL-yhteysparametreja. Voit mukauttaa myös sitä, miten Power BI käsittelee raporttia upottamalla muotojen hahmontamisparametreja tai raporttityökalurivin ulkoasua. Sen jälkeen liität tämän URL-osoitteen suoraan sähköpostiviestiin tai verkkosivulle, jotta muut kokevat raporttisi samalla tavalla selaimessa.
Voit suorittaa seuraavia toimintoja URL-yhteysparametrien kautta:
- Raporttiparametrien lähettäminen raporttiin.
- Raportin sisällön viennin aloittaminen tuetussa tiedostomuodossa.
- Parametriruudun piilottaminen tai tarkasteleminen.
- Määritä DeviceInfo-asetus .
Täydellinen luettelo URL-yhteyden kautta käytettävissä olevista komennoista ja asetuksista on tämän artikkelin kohdassa URL-yhteysparametriviite .
URL-yhteyden käsitteet
Power BI:n URL-pyynnöt sisältävät palvelun käsittelemiä parametreja. Se, miten palvelu käsittelee URL-pyyntöjä, määräytyy URL-osoitteeseen sisältyvien parametrien, parametrien etuliitteiden ja kohdetyyppien mukaan. Sivutetun raportin URL-toiminto on yhteensopiva useimpien URL-osoitteiden vakiomäärityksiä tukevien selainten ja sovellusten kanssa.
URL-yhteyden syntaksi
URL-pyynnöt voivat sisältää useita parametreja, jotka luetellaan missä tahansa järjestyksessä. Parametrit erotetaan toisistaan et-mekaanilla (&). Nimi- ja arvoparit erotetaan toisistaan yhtäläisyysmerkillä (=). Esimerkkejä:
powerbiservicereporturl?rp:parameter=value&rdl:parameter=value
Syntaksin kuvaus
powerbiservicereporturl
Sivutetun raportin Power BI -palvelun URL-osoite. Esimerkkejä:
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0
?
Käytetään erottamaan powerbiservicereporturl - ja URL-yhteysparametrit.
&
Käytetään erottamaan URL-yhteysparametrien nimi- ja arvoparit.
etuliite
URL-parametrin etuliite, joka määrittää toiminnon Power BI -palvelussa. Esimerkiksi rp:
tai rdl:
.
parametri
Parametrin nimi.
arvo
URL-teksti, joka vastaa käytettävän parametrin arvoa.
URL-raporttiparametriviittaus
Voit välittää raporttiparametrit raporttiin sisällyttämällä ne sivutetun raportin URL-osoitteeseen.
Raporttiparametrit (rp:
)
Esimerkkejä raporttiparametrien välittämisestä URL-osoitteessa on kohdassa Raporttiparametrin välittäminen URL-osoitteessa.
Muistiinpano
Raporttiparametrit edellyttävät parametrin etuliitettä rp:
, ja kirjainkoko on merkitsevä.
URL-yhteysparametriviittaus
Voit käyttää seuraavia parametreja URL-osoitteen osana ja määrittää sivutettujen raporttien ulkoasun Power BI:ssä. Yleisimmät parametrit luetellaan tässä osassa. Parametrien kirjainkoko ei ole merkitsevä, ja ne alkavat parametrin etuliitteellä rdl:
, jos ne liittyvät tulostemuotoon.
Raportin komennot (rdl:
)
Vientimuoto
Määrittää raportin hahmontamisen ja viennin muodon.
- Esimerkki:
rdl:format=PDF
Käytettävissä olevat arvot:
- PPTX (PowerPoint)
- MHTML
- KUVA
- EXCELOPENXML (EXCEL)
- WORDOPENXML (WORD)
- CSV
- ACCESSIBLEPDF (PDF)
- XML
Raporttinäkymä
Määrittää näkymän tyypin, jota käytetään raportin näyttämiseen.
rdl:reportView
Käytettävissä olevat arvot:
- interactive (oletus): lataa raportin vuorovaikutteiseen tilaan.
- pageView: lataa raportin sivunäkymätilaan.
Parametripaneeli
Määrittää, onko parametripaneeli suljettuna vai avoimena, kun raportti latautuu, vai onko se piilotettu kokonaan.
rdl:parameterPanel
Käytettävissä olevat arvot:
- collapsed: lataa raportin parametripaneeli suljettuna. Parametripainike on käytössä, jotta käyttäjät voivat valita laajennettavan painikkeen.
- hidden: lataa raportin parametripaneeli suljettuna ja parametripainike poistettuna käytöstä.
- laajennettu (oletus): lataa raportin parametripaneeli avoimena ja parametripainike käytössä.
Laitteen tiedot
Voit määrittää lisää tulosteparametreja seuraaville vientimuodoille.
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:
Muistiinpano
Viittaa näiden merkkijonoarvojen CSV-laitetietojen asetuksiin.
- rdl:Koodaus=merkkijono
- 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 –> True/False/Never/Default
- 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:Koodaus=merkkijono
- rdl:Indented=true/false
- rdl:OmitNamespace=true/false
- rdl:OmitSchema=true/false
- rdl:Schema=true/false
- rdl:UseFormattedValues=true/false
Avaa hyperlinkki samassa selainikkunassa
Voit liittää rdl:targetSameWindow=true
raportin hyperlinkin URL-osoitteeseen ja saada Power BI:n avaamaan tämän hyperlinkin samassa selainikkunassa. Lisätietoja hyperlinkkien lisäämisestä raporttiin on kohdassa Hyperlinkin lisääminen URL-osoitteeseen.