Jaa

Raporttiparametrin välittäminen URL-osoitteessa Power BI:n sivutetuissa raporteissa

  • Artikkeli

KOSKEE: Power BI Report Builder Power BI Desktop

Voit välittää raporttiparametrit raporttiin sisällyttämällä ne sivutettujen raporttien raportin URL-osoitteeseen. Näissä URL-parametreissa ei ole etuliitettä, koska ne on välitetty suoraan raportin käsittelymoduuliin.

Kaikilla kyselyparametreilla voi olla vastaavat raporttiparametrit. Siirrät kyselyparametrin raporttiin välittämällä vastaavan raporttiparametrin. Lisätietoja on kohdassa Kyselyn luominen relaatiokyselyjen suunnittelutyökalussa (Power BI:n raportin muodostin).

Sivutetun raportin parametrisäännöt

Raporttiparametrien kirjainkoko on merkitsevä, ja ne käyttävät seuraavia erikoismerkkejä:

  • URL-merkkijonon kaikki välilyöntimerkit korvataan merkeillä "%20" URL-koodausstandardien mukaisesti.
  • URL-osoitteen parametriosan välilyöntimerkki korvataan plusmerkin (+) avulla.
  • Merkkijonon minkä tahansa osan puolipiste korvataan merkeillä "%3A".
  • Selaimet suorittavat automaattisesti asianmukaisen URL-koodauksen. Sinun ei tarvitse koodata mitään merkkejä manuaalisesti.
  • Jos et sisällytä välityspalvelimen syntaksia, lisää parametrin etuliitteeksi rp:.

Sivutetun raportin 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/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Jos haluat välittää tyhjäarvon parametrille, käytä seuraavaa syntaksia:

  
parameter:isnull=true

Esimerkiksi

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.

Muistiinpano

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 Raportin hallinnassa), 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.

Muita esimerkkejä

Seuraava esimerkki-URL-osoite sisältää moniarvoisen parametrin "myyjä". Moniarvoinen parametri toistaa parametrin nimen jokaisen 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".

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 Power BI:n raportin muodostimessa), 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 tukee enintään 2 000 merkkiä pitkiä kyselymerkkijonoja. Saatat vahingossa ylittää tämän arvon, jos tarkastelet sivutettua raporttia URL-parametrien avulla, erityisesti 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 Power BI:hin. Jos avaat raportin ennen kirjautumista, raja pienenee.

Liittyvä sisältö