Raporttiparametrit Power BI:n raportin muodostimessa
KOSKEE: 
Power BI Report Builder 
Power BI Desktop
Tässä artikkelissa kuvataan Power BI:n raportin muodostimen raporttiparametrien yleisiä käyttötarkoituksia, määrityksessä kohteina olevia ominaisuuksia ja paljon muuta. Raporttiparametrien avulla voit hallita raportin tietoja, yhdistää toisiinsa liittyviä raportteja ja muuttaa raportin esitystapaa. Voit käyttää raporttiparametreja raportin muodostimessa luoduissa sivutetuissa raporteissa.
Parametrien yleiset käyttötarkoitukset
Seuraavassa on joitakin yleisimpiä parametrien käyttötapoja.
Sivutetun raportin tietojen hallinta:
Suodata sivutettujen raporttien tietoja tietolähteessä kirjoittamalla muuttujia sisältäviä tietojoukkokyselyjä.
Salli käyttäjien muokata sivutetun raportin tietoja määrittämällä arvoja. Anna esimerkiksi myyntitietojen alkamis- ja päättymispäivälle kaksi parametria.
Raportin esitystavan muuttaminen:
Salli käyttäjien muokata raportin ulkoasua määrittämällä arvoja. Esimerkiksi totuusarvoparametrin avulla voit määrittää, laajennetaanko vai kutistetaanko kaikki taulukon sisäkkäiset riviryhmät.
Salli käyttäjien mukauttaa raportin tietoja ja ulkoasua lisäämällä parametreja lausekkeisiin.
Parametreja sisältävän raportin tarkasteleminen
Kun tarkastelet raporttia, jossa on parametreja, raporttien katseluohjelman työkalurivi näyttää jokaisen parametrin, joten voit määrittää arvot vuorovaikutteisesti. Seuraavasta kuvasta näet raportin parametrialueen, jossa on parametrit @ReportMonth, , @ReportYear, @ShowAll@EmployeeID, @ExpandTableRows, @CategoryQuotaja @SalesDate.
Parametriruutu. Raporttien katseluohjelman työkalurivi näyttää kehotteen ja kunkin parametrin oletusarvon. Voit mukauttaa parametrien asettelua parametriruudussa.
@SalesDate-parametri. @SalesDate parametrin tietotyyppi on DateTime. Päivämäärän valintakehote näkyy tekstiruudun vieressä. Voit muokata päivämäärää kirjoittamalla uuden päivämäärän tekstiruutuun, käyttämällä kalenterin ohjausobjektia tai valitsemalla Siirry tähän päivään.
@ShowAll-parametri. @ShowAll parametrin tietotyyppi on totuusarvo. Valintapainikkeiden avulla voit määrittää arvoksi Tosi tai Epätosi.
Näytä tai piilota parametrialueen kahva. Valitse raporttien katseluohjelman työkalurivillä tämä nuoli, jos haluat näyttää tai piilottaa parametrit-ruudun.
@CategoryQuota-parametri. Parametrin @CategoryQuota on tietotyyppi liukuluku, joten sille annetaan numeerinen arvo. @CategoryQuota on määritetty sallimaan useita arvoja.
Tarkastele raporttia. Kun olet syöttämällä parametriarvot, suorita raportti valitsemalla Näytä raportti . Jos kaikilla parametreilla on oletusarvot, raportti suoritetaan automaattisesti ensimmäisellä näyttökerralla.
Lisätietoja sivutettujen raporttien parametreista on artikkelissa Sivutettujen raporttien parametrien tarkasteleminen Power BI -palvelussa.
Parametrien luominen
Voit luoda raporttiparametreja muutamalla eri tavalla.
Muistiinpano
Kaikki tietolähteet eivät tue parametreja.
Parametreja sisältävä tietojoukon kysely tai tallennettu toimintosarja
Lisää muuttujia sisältävä tietojoukkokysely tai syöteparametreja sisältävä tietojoukon tallennettu toimintosarja. Kullekin muuttujalle tai syöteparametrille luodaan tietojoukkoparametri ja kullekin tietojoukon parametrille raporttiparametri.
Raportin muodostimen kuvassa näytetään:
Raporttiparametrit raporttitietoruudussa.
Parametreja sisältävä tietojoukko.
Parametriruutu.
Tietojoukon ominaisuudet -valintaikkunassa luetellut parametrit.
Parametrin luominen manuaalisesti
Luo parametri manuaalisesti raporttitietoruudusta. Voit määrittää raporttiparametrit siten, että käyttäjä voi syöttää vuorovaikutteisesti arvoja, joiden avulla raportin sisältöä tai ulkoasua voidaan mukauttaa. Voit myös määrittää raporttiparametrit niin, että käyttäjä ei voi muuttaa esimääritettyjä arvoja.
Muistiinpano
Koska parametreja hallitaan erikseen palvelimessa, uudet parametriasetukset sisältävän pääraportin julkaiseminen uudelleen ei korvaa raportin olemassa olevia parametriasetuksia.
Parametriarvojen valinta
Seuraavat vaihtoehdot ovat parametriarvojen valitsemiseen raportissa.
Valitse yksittäinen parametriarvo avattavasta luettelosta.
Valitse useita parametriarvoja avattavasta luettelosta.
Valitse avattavasta luettelosta arvo yhdelle parametrille, joka määrittää arvot, jotka ovat käytettävissä toisen parametrin avattavassa luettelossa. Nämä ovat johdannaisparametreja. Johdannaisparametrien avulla voit suodattaa tuhansista parametriarvoista peräkkäin hallittavan määrän. Lisätietoja on kohdassa Cascading-parametrien käyttäminen sivutetuissa raporteissa.
Suorita raportti valitsematta ensin parametriarvoa, koska parametrille luotiin oletusarvo.
Raporttiparametrin ominaisuudet
Voit muuttaa raporttiparametrin ominaisuuksia raportin ominaisuudet -valintaikkunan avulla. Seuraavassa taulukossa on yhteenveto ominaisuuksista, joita voit määrittää kullekin parametrille:
| Ominaisuus | Kuvaus |
|---|---|
| Nimi | Kirjoita parametrille kirjainkoon huomioon ottava nimi. Nimen on alettava kirjaimella, ja siinä voi olla kirjaimia, numeroita tai alaviivoja (_). Nimessä ei voi olla välilyöntejä. Automaattisesti luotaville parametreille nimi vastaa tietojoukkokyselyn parametria. Manuaalisesti luodut parametrit ovat oletusarvoisesti samankaltaisia kuin Raporttiparametri1. |
| Ripeä | Raportin katseluohjelman työkalurivillä parametrin vieressä näkyvä teksti. |
| Tietotyyppi | Raporttiparametrin on oltava jokin seuraavista tietotyypeistä: Totuusarvo. Käyttäjä valitsee valintapainikkeesta Tosi tai Epätosi. Päivämäärä ja aika. Käyttäjä kirjoittaa tekstiruutuun uuden päivämäärän, valitsee päivämäärän kalenteriohjausobjektista tai valitsee siirry tähän päivään. Kokonaisluku. Käyttäjä kirjoittaa arvot tekstiruutuun. Liukuluku. Käyttäjä kirjoittaa arvot tekstiruutuun. Teksti. Käyttäjä kirjoittaa arvot tekstiruutuun. Kun käytettävissä olevat arvot on määritetty parametrille, käyttäjä valitsee arvot avattavasta luettelosta, vaikka tietotyyppi olisi päivämäärä/aika. |
| Salli tyhjä arvo | Valitse tämä vaihtoehto, jos parametrin arvo voi olla tyhjä. Jos määrität parametrin kelvolliset arvot ja haluat pitää tyhjän arvon kelvollisena arvona, se on sisällytettävä yhdeksi määrittämäksesi arvoksi. Tämän vaihtoehdon valitseminen ei automaattisesti lisää tyhjiä arvoja. |
| Salli null-arvo | Valitse tämä vaihtoehto, jos parametrin arvo voi olla tyhjäarvo. Jos määrität parametrin kelvolliset arvot ja haluat olla yksi kelvollisista arvoista, sinun on sisällytettävä tyhjäarvo yhdeksi määrittämäksesi arvoksi. Tämän vaihtoehdon valitseminen ei automaattisesti lisää nolla-arvoja. |
| Salli useita arvoja | Anna käytettävissä olevat arvot, joiden avulla voit luoda avattavan luettelon, josta käyttäjät voivat valita. Tämä on hyvä tapa varmistaa, että tietojoukkokyselyssä lähetetään vain kelvollisia arvoja. Valitse tämä vaihtoehto, jos parametrin arvo voi olla useita, avattavassa luettelossa näytettäviä arvoja. Tyhjäarvoja ei sallita. Kun tämä vaihtoehto on valittuna, parametrin käytettävissä olevien arvojen luetteloon lisätään valintaruutuja. Luettelon yläosassa on Valitse kaikki -valintaruutu. Käyttäjät voivat tarkistaa haluamansa arvot. Jos tietoja antavat arvot muuttuvat nopeasti, käyttäjän näkemä luettelo ei ehkä ole ajan tasalla. |
| Näkyvissä | Valitsemalla tämän voit näyttää raporttiparametrin raportin yläreunassa, kun raportti suoritetaan. Tämän asetuksen avulla käyttäjät voivat valita parametriarvot suorituksen aikana. |
| Piilotettu | Valitsemalla tämän voit piilottaa julkaistun raportin raporttiparametrit. Raportin parametriarvot voidaan edelleen määrittää raportin URL-osoitteessa, tilausmäärityksessä tai raporttipalvelimessa. |
| Sisäinen | Valitsemalla tämän voit piilottaa raporttiparametrin. Raporttiparametria voidaan tarkastella julkaistussa raportissa vain raportin määrityksessä. |
| Käytettävissä olevat arvot | Jos olet määrittänyt parametrille käytettävissä olevat arvot, kelvolliset arvot näkyvät aina avattavana luettelona. Jos esimerkiksi annat datetime-parametrille käytettävissä olevia arvoja, päivämäärät näkyvät parametriruudussa avattavassa luettelossa kalenteriohjausobjektin sijaan. Voit määrittää tietolähteen käyttämään yksittäistä tapahtumaa kaikissa tietolähteeseen liittyvissä tietojoukkokyselyissä. Näin voit varmistaa, että arvojen luettelo vastaa raporttia ja aliraporttia. Tietoturvahuomautus: Käytä kaikissa raporteissa, jotka sisältävät tietotyypin Text, käytettävissä olevien arvojen luetteloa (kelvollisten arvojen luetteloa). Varmista, että raporttia suorittavalla käyttäjällä on vain raportin tietojen tarkasteluoikeudet. |
| Oletusarvot | Määritä oletusarvot kyselystä tai staattisesta luettelosta. Kun jokaisella parametrilla on oletusarvo, raportti suoritetaan automaattisesti ensimmäisellä näyttökerralla. |
| Edistynyt | Määritä raportin määrityksen määritteeksi UsedInQuery. Se on arvo, joka ilmaisee, vaikuttaako parametri raportin tietoihin suoraan tai epäsuorasti. Päivitysvälin automaattinen määrittäminen Valitse tämä vaihtoehto, kun haluat raportin käsittelytoiminnon määrittävän arvon asetuksen. Arvo on True , jos raportin käsittelytoiminto havaitsee parametriin suoraan tai epäsuorasti viittaavan tietojoukkokyselyn tai jos raportissa on aliraportteja. Päivitä aina Valitse tämä vaihtoehto, kun raporttiparametria käytetään tietojoukkokyselyssä tai parametrilausekkeessa suoraan tai epäsuorasti. Tämä asetus määrittää UsedInQuery-arvoksi Tosi. Älä koskaan päivitä Valitse tämä vaihtoehto, kun raporttiparametria ei käytetä tietojoukkokyselyssä tai parametrilausekkeessa suoraan tai epäsuorasti. Tämä asetus määrittää UsedInQuery-arvoksi False. Varoitus: Älä koskaan päivitä harkiten. Raporttipalvelimella UsedInQuery-parametria käytetään raporttitietojen ja hahmonnetun raportin välimuistiasetusten sekä tilannevedosraporttien parametriasetusten hallintaan. Jos määrität Älä koskaan päivitä -parametrin virheellisesti, raporttitiedot tai raportit saatetaan tallentaa välimuistiin virheellisesti tai tilannevedosraportin tiedot saattavat olla epäyhtenäisiä. |
Tietojoukkokysely
Voit suodattaa tietojoukkokyselyn tietoja sisällyttämällä rajoituslausekkeen, joka rajoittaa noudettuja tietoja määrittämällä tulosjoukkoon sisällytettävät tai siitä pois jätettävät arvot.
Tietolähteen kyselyjen suunnittelutyökalun avulla voit luoda parametrisoidun kyselyn.
Transact-SQL-kyselyissä eri tietolähteet tukevat parametrien eri syntakseja. Tuki vaihtelee kyselyssä sijainnin tai nimen mukaan tunnistetuista parametreista. Relaatiokyselyjen suunnittelutyökalussa valitset suodattimelle parametriasetuksen, joka luo parametrisoidun kyselyn.
Microsoft SQL Server Analysis Servicesiin tai esimerkiksi monidimensioisiin tietolähteisiin perustuvissa kyselyissä voit määrittää, luodaanko kyselyjen suunnittelutyökalussa määrittämääsi suodattimeen perustuva parametri.
Julkaistun raportin parametrien hallinta
Kun suunnittelet raporttia, raporttiparametrit tallennetaan raportin määritykseen. Kun julkaiset raportin, raporttiparametrit tallennetaan ja niitä hallitaan erillään raportin määrityksestä.
Julkaistuissa raporteissa voit käyttää seuraavia parametreja:
Raporttiparametrin ominaisuudet. Muuta raporttiparametrien arvoja suoraan raporttipalvelimessa raportin määrityksestä riippumatta.
Raportin tilaukset. Voit määrittää tietojen suodattamisen parametriarvot ja toimittaa raportteja tilausten kautta.
Julkaistun raportin parametriominaisuudet säilytetään, jos julkaiset raportin määrityksen uudelleen. Ominaisuusasetukset säilytetään, jos raporttimääritys julkaistaan uudelleen ja parametrien nimet sekä tietotyypit pysyvät samoina. Jos lisäät tai poistat raporttimäärityksen parametreja tai muutat tietotyyppiä tai olemassa olevan parametrin nimeä, sinun on ehkä muutettava julkaistun raportin parametriominaisuuksia.
Kaikkia parametreja ei voi muuttaa kaikissa tapauksissa. Jos raporttiparametri saa tietojoukkokyselystä oletusarvon, kyseistä arvoa ei voi muokata julkaistuissa raporteissa eikä raporttipalvelimessa. Suorittamisen aikana käytettävä arvo määritetään kyselyn suorittamisen yhteydessä, tai jos kyseessä ovat lausekepohjaiset parametrit, kun lauseke arvioidaan.
Raportin suoritusasetukset voivat vaikuttaa siihen, miten parametreja käsitellään. Raportti, joka suoritetaan tilannevedoksena, ei voi käyttää kyselystä johdettuja parametreja, ellei kysely sisällä parametrien oletusarvoja.
Tilauksen parametrit
Voit määrittää pyydettäessä suoritettavan raportin tai tilannevedoksen tilauksen ja määrittää tilauksen käsittelyssä käytettävät parametriarvot.
- Pyydettäessä suoritettava raportti. Voit määrittää pyydettäessä suoritettavalle raportille eri parametriarvon kuin raportissa luetteloiduille julkaistuille arvoille. Oletetaan, että sinulla on palvelupuheluraportti, joka käyttää ajanjaksoparametria asiakaspalvelupyyntöjen palauttamiseen nykyiselle päivälle, viikolle tai kuukaudelle. Jos raportin oletusparametriarvoksi määritetään tänään, tilauksessa voidaan käyttää eri parametriarvoja (kuten viikko tai kuukausi) viikoittaisia tai kuukausittaisia lukuja sisältävän raportin tuottamiseen.