Lausekkeet Power BI:n raportin muodostimessa
KOSKEE: 
Power BI Report Builder 
Power BI Desktop
Lausekkeita käytetään yleisesti Power BI:n raporttien muodostimessa tietojen noutamiseen, laskemiseen, näyttämiseen, ryhmittelyun, lajitteluun, suodattamiseen, parametrisoitumiseen ja muotoiluun.
Monet raporttikohteiden ominaisuudet voidaan määrittää lausekkeille. Lausekkeiden avulla voit hallita raportin sisältöä, rakennetta ja vuorovaikutteisuutta. Lausekkeet kirjoitetaan Microsoft Visual Basicilla ja tallennetaan raporttimääritykseen, ja raportinkäsittely arvioi ne, kun raportti suoritetaan.
Toisin kuin Microsoft Excel ja vastaavat sovellukset, joissa tietoja käsitellään suoraan laskentataulukossa, raportissa voit käsitellä lausekkeita, jotka toimivat tietojen paikkamerkeinä. Jos haluat nähdä arvioitujen lausekkeiden todelliset tiedot, sinun on esikatselettava raporttia. Kun raportti suoritetaan, raportinkäsittely arvioi jokaisen lausekkeen yhdistäessään raporttitietoja ja raportin asettelun elementtejä, kuten taulukoita ja kaavioita.
Kun suunnittelet raporttia, monet raporttikohteita koskevat lausekkeet määritetään puolestasi. Kun esimerkiksi vedät kentän tietoruudusta raportin suunnittelualueella olevaan taulukkosoluun, tekstiruudun arvoksi asetetaan kentän yksinkertainen lauseke. Seuraavassa kuvassa Raportin tiedot -ruudussa näkyvät tietojoukon kenttien tunnus, nimi, myyntialue, koodi ja myynti. Taulukkoon on lisätty kolme kenttää: [Name], [Code], ja [Sales]. Suunnittelualueen merkintä [Name] tarkoittaa pohjana olevaa lauseketta =Fields!Name.Value.
Kun esikatselet raporttia, raportinkäsittely yhdistää taulukon tietoalueen tietoyhteyden todellisiin tietoihin ja näyttää taulukossa rivin jokaista tulosjoukon riviä kohden.
Voit lisätä lausekkeita manuaalisesti valitsemalla suunnittelualueella olevan kohteen sekä määrittämällä kohteen ominaisuudet pikavalikoiden ja valintaikkunoiden avulla. Kun näet avattavassa luettelossa (fx) -painikkeen tai arvon <Expression> , tiedät, että voit määrittää ominaisuuden lausekkeen.
Yksinkertaisten ja monimutkaisten lausekkeiden ymmärtäminen
Lausekkeet alkavat yhtäläisyysmerkillä (=) ja ne kirjoitetaan Microsoft Visual Basicilla. Lausekkeet voivat sisältää yhdistelmän vakioita, operaattoreita ja viittauksia sisäisiin arvoihin (kentät, kokoelmat ja funktiot) sekä ulkoista tai mukautettua koodia.
Lausekkeiden avulla voit määrittää useiden raporttikohteiden ominaisuudet. Yleisimmät ominaisuudet ovat tekstiruutujen ja paikkamerkkitekstien arvot. Jos tekstiruutu sisältää vain yhden lausekkeen, lauseke on yleensä tekstiruutuominaisuuden arvo. Jos tekstiruutu sisältää useita lausekkeita, jokainen lauseke on paikkamerkkitekstin arvo tekstiruudussa.
Lausekkeet näkyvät oletusarvoisesti raportin suunnittelualueella yksinkertaisina tai monimutkaisina lausekkeina.
Yksinkertainen: Yksinkertainen lauseke sisältää viittauksen sisäisessä kokoelmassa yhteen kohteeseen, esimerkiksi tietojoukon kenttään, parametriin tai sisäiseen kenttään. Suunnittelualueella yksinkertainen lauseke näkyy hakasulkeissa. Esimerkiksi
[FieldName]vastaa pohjana olevaa lauseketta=Fields!FieldName.Value. Yksinkertaiset lausekkeet luodaan puolestasi automaattisesti, kun luot raportin asettelun ja vedät kohteita raportin tietoruudusta suunnittelualueelle. Lisätietoja eri sisäisiä kokoelmia edustavista symboleista on kohdassa Yksinkertaisten lausekkeiden etuliitesymbolien ymmärtäminen.Monimutkainen: Monimutkainen lauseke sisältää viittauksia useisiin sisäisiin viittauksiin, operaattoreihin ja funktiokutsuihin. Monimutkainen lauseke näkyy muodossa
<<Expr>>, kun lausekkeen arvo sisältää enemmän kuin yksinkertaisen viittauksen. Voit tarkastella lauseketta viemällä hiiren osoittimen sen päälle ja käyttämällä työkaluvihjettä. Voit muokata lauseketta avaamalla sen Lauseke-valintaikkunassa.
Seuraavassa kuvassa näytetään tyypillinen yksinkertainen ja monimutkainen lauseke sekä tekstiruudulle että paikkamerkkitekstille.
Jos haluat näyttää lausekkeiden tekstin sijaan malliarvot, käytä muotoilua tekstiruudun tai paikkamerkin tekstiin. Seuraavassa kuvassa esitetään raportin suunnittelualue, jonka on poistettu näyttävän malliarvot:
Yksinkertaisten lausekkeiden etuliitesymbolien ymmärtäminen
Yksinkertaisissa lausekkeissa käytetään symboleja ilmaisemaan, onko viittaus kenttä, parametri, sisäinen kokoelma tai ReportItems-kokoelma . Seuraavassa taulukossa on esimerkkejä näytön ja lausekkeen tekstistä:
| Nimike | Näytä tekstiesimerkki | Lausekkeen tekstiesimerkki |
|---|---|---|
| Tietojoukon kentät | [Sales] [SUM(Sales)] [FIRST(Store)] |
=Fields!Sales.Value=Sum(Fields!Sales.Value)=First(Fields!Store.Value) |
| Raporttiparametrit | [@Param] [@Param.Label] |
=Parameters!Param.Value =Parameters!Param.Label |
| Sisäiset kentät | [&ReportName] |
=Globals!ReportName.Value |
| Tekstiruudussa käytetyt literaalimerkit | \[Sales\] |
[Sales] |
Monimutkaisten lausekkeiden kirjoittaminen
Lausekkeet voivat sisältää viittauksia funktioihin, operaattoreihin, vakioihin, kenttiin, parametreihin, sisäisiin kokoelmiin sekä upotettuun mukautettuun koodiin tai mukautettuihin kokoonpanoihin.
Seuraavassa taulukossa luetellaan viittausten tyyppejä, jotka voit sisällyttää lausekkeeseen:
| Viitteet | Kuvaus | Esimerkki: |
|---|---|---|
| Vakiot | Tässä artikkelissa kuvataan vakiot, joita voit käyttää vuorovaikutteisesti ominaisuuksille, jotka edellyttävät vakioarvoja, kuten fontin värejä. | ="Blue" |
| Operaattorit | Kuvailee operaattorit, joiden avulla voit yhdistää viittauksia lausekkeisiin. Esimerkiksi & -operaattoria käytetään merkkijonojen ketjuttamiseen. | ="The report ran at: " & Globals!ExecutionTime & "." |
| Sisäiset kokoelmat | Kuvailee sisäiset kokoelmat, jotka voit sisällyttää lausekkeeseen, kuten Fields, Parametersja Variables. |
=Fields!Sales.Value=Parameters!Store.Value=Variables!MyCalculation.Value |
| Sisäiset raportti- ja koostefunktiot | Kuvailee sisäiset funktiot, kuten Sum tai Previous, joita voit käyttää lausekkeissa. |
=Previous(Sum(Fields!Sales.Value)) |
| Mukautetut koodi- ja kokoonpanoviittaukset raportin muodostimen lausekkeissa | Tässä artikkelissa kuvataan, miten voit käyttää sisäisiä CLR-luokkia xref:System.Math ja xref:System.Convert, muita CLR-luokkia, Visual Basic -suorituskirjastoja tai ulkoisen kokoonpanon menetelmiä.Tässä artikkelissa kuvataan, miten voit käyttää raporttiin upotettua mukautettua koodia tai koodia, jonka käännät ja asennat mukautettuna kokoonpanona sekä raportin asiakkaalle että raporttipalvelimelle. |
=Sum(Fields!Sales.Value)=CDate(Fields!SalesDate.Value)=DateAdd("d",3,Fields!BirthDate.Value) =Code.ToUSD(Fields!StandardCost.Value) |
Lausekkeiden vahvistaminen
Kun luot lausekkeen tietylle raporttikohteen ominaisuudelle, lausekkeeseen sisällytettävät viittaukset riippuvat siitä, mitä arvoja raporttikohteen ominaisuus hyväksyy, ja laajuudesta, jossa ominaisuus arvioidaan. Esimerkkejä:
Lauseke
[Sum]laskee oletusarvoisesti lausekkeen arviointihetkellä laajuuteen kuuluvien tietojen summan. Taulukkosolussa laajuus määräytyy rivi- ja sarakeryhmien jäsenyyden mukaan.Fontti-ominaisuuden arvon arvo täytyy antaa tulokseksi fontin nimi.
Lausekkeen syntaksi vahvistetaan suunnittelun aikana. Lausekkeen vaikutusalueen vahvistus suoritetaan, kun julkaiset raportin. Todellisista tiedoista riippuvaisten vahvistusten virheet voidaan havaita vain suorituksen aikana. Jotkin näistä lausekkeista tuottavat #Error virhesanomana hahmonnetussa raportissa.