Raporttiparametrin välittäminen URL-osoitteessa Power BI:n sivutetuissa raporteissa
KOSKEE seuraavia: ✔️ Power BI -palvelu ✔️ Power BI -mobiilisovellus ✔️ Power BI Report Builder ✔️ Power BI Premium ❌ Power BI Desktop
Raporttiparametrit voi välittää raporttiin sisällyttämällä ne sivutetun raportin URL-osoitteeseen. Kaikilla kyselyparametreilla voi olla vastaavat raporttiparametrit. Näin ollen kyselyparametri välitetään raporttiin välittämällä vastaava raporttiparametri. Sinun on lisättävä parametrin nimeenrp:
-etuliite, jotta Power BI tunnistaa sen URL-osoitteessa.
Raporttiparametrien kirjainkoko on merkitsevä, ja niissä käytetään seuraavia erikoismerkkejä:
URL-osoitteen parametriosan välilyönti korvataan plusmerkillä (+). Esimerkki:
rp:Holiday=Christmas+Day
Merkkijonon minkä tahansa osan puolipiste korvataan merkeillä
%3A
.
Selaimet suorittavat automaattisesti asianmukaisen URL-koodauksen. Sinun ei tarvitse koodata mitään merkkejä manuaalisesti.
Edellytykset
- Jos haluat julkaista Power BI sivutetun raportin Power BI -palvelu, tarvitset Power BI Pro -käyttöoikeuden tai Premium käyttäjäkohtaisen käyttöoikeuden (PPU) ja kirjoitusoikeuden työtilaan Power BI Premium kapasiteetissa.
Parametriesimerkkejä
Jos haluat määrittää raporttiparametrin URL-osoitteeseen, käytä seuraavaa syntaksia:
rp:parameter=value
Jos haluat esimerkiksi määrittää kaksi parametria, ”myyjä” ja ”osavaltio”, jotka on määritetty omassa työtilassa olevassa raportissa, käytä seuraavaa URL-osoitetta:
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah
Jos haluat määrittää samat kaksi parametria, jotka on määritetty sovelluksessa olevassa raportissa, käytä seuraavaa URL-osoitetta:
https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/b1d5e659-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah
Jos haluat välittää tyhjäarvon parametrille, käytä seuraavaa syntaksia:
parameter:isnull=true
Esimerkki:
rp:SalesOrderNumber:isnull=true
Jos haluat välittää totuusarvon, määritä epätosi-arvoksi 0 ja tosi-arvoksi 1. Jos haluat välittää liukulukuarvon, lisää palvelimen aluekohtaisten asetusten desimaalierotin.
Muita esimerkkejä
Seuraava esimerkki-URL-osoite sisältää moniarvoisen parametrin ”myyjä”. Moniarvoinen parametri toistaa parametrin nimen kunkin arvon kohdalla.
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey
Seuraava esimerkki-URL-osoite välittää yhden SellStartDate-parametrin, jonka arvo on ”7/1/2005”, alkuperäistilassa olevalle raporttipalvelimelle.
https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005
Huomioitavat asiat ja rajoitukset
- Jos raporttisi sisältää raporttiparametrin, jolla on oletusarvo, ja Kehote-ominaisuuden arvo on epätosi (eli Kehote käyttäjälle -ominaisuutta ei ole valittu Report Managerissa), et voi välittää kyseisen raporttiparametrin arvoa URL-osoitteeseen. Tämän ansiosta järjestelmänvalvojat voivat estää loppukäyttäjiä lisäämästä tai muokkaamasta tiettyjen raporttiparametrien arvoja.
- Power BI ei tue yli 2 000 merkin kyselymerkkijonoa. Saatat vahingossa ylittää tämän arvon, jos tarkastelet sivutettua raporttia URL-parametreilla, varsinkin jos kyselymerkkijono sisältää useita parametriarvoja. Jos haluat ladata raportin oikein, pienennä merkkien määrä alle 2 000:een.
- Kyselymerkkijonon rajoitus arvioidaan, kun olet kirjautunut sisään Power BI. Jos avaat raportin ennen kirjautumista, enimmäismäärää pienennetään.