Vihjeitä ja esimerkkejä
Mittarikaava
Määritä mittarin kaava tekstimuodossa. Se voi koostua esimääritetyistä toiminnoista.
Yksittäiset toiminnot jaetaan kahteen perusryhmään:
Koostamistoiminnot: Koostamistoiminnon syötteenä on arvojoukko, joiden tuloksena oleva arvo lasketaan (esimerkiksi keskiarvo, enimmäismäärä jne.)
Skalaaritoiminnot: Skalaaritoiminnon syötteenä on vähintään yksi arvo, jonka tuloksena oleva arvo lasketaan (esimerkiksi numeron absoluuttinen arvo, veron osan selvittäminen jne.).
Toiminnot voivat käyttää vakioita, joita voidaan yhdistellä käyttämällä unaari- tai binaarioperaattoreita (kuten yhteenlaskua tai vähennyslasku) tai asettamalla niitä sisäkkäin.
Skalaaritoimintoihin kuuluu myös toimintoja, joilla selvitetään arvo joko suoraan käytettävissä olevana määritteenä tai johdettujen tilastotietojen (tapahtuman kesto) muodossa.
Tietyt toiminnot tukevat myös sen kontekstin määrittämistä, jota varten toiminto arvioidaan. Tämä on tärkeää koostamistoiminnoille, jotka voivat koostaa arvoja esimerkiksi vain tietylle aktiviteetille tai kaikille aktiviteeteille tai tapahtumille. Myös mittarin kontekstista tuloksena olevaa implisiittistä kontekstia tai päätoiminnon kontekstia tuetaan.
Mittarikaava voi palauttaa jonkin tuetuista tietotyypeistä. Tiettyjen kaavojen tietotyypit määritetään tässä artikkelissa kaavan syntaksimäärityksen vieressä.
Koostamistoiminnot
Koostamistoiminnot ovat kunkin mittarin perusta. Yleisimmät koostetoiminnot:
- COUNT: Palauttaa koostettujen arvojen määrän (
incl. COUNTIF, COUNTUNIQUE
). - SUM: Palauttaa koostettujen arvojen summan (
incl. SUMIF
). - AVG: Palauttaa koostettujen arvojen keskiarvon.
- MIN: Palauttaa koostettujen arvojen vähimmäisarvon.
- MAX: Palauttaa koostettujen arvojen enimmäisarvon.
Koostamistoimintojen vapaaehtoinen parametri toimii toiminnon kontekstina ja skalaaritoimintona syötearvon muokkaamista varten. Tuettujen laskentakontekstien täydellinen luettelo kuvataan Laskentakontekstissa.
Skalaaritoiminnot
Skalaaritoimintojen tarkoituksena on saada yksi arvo ja sen muunnos haluttuun tilaan. Tällä hetkellä tuetut toiminnot voidaan jakaa useisiin tyyppeihin:
- Matemaattinen – tähän kuuluvat toiminnot, joilla selvitetään esimerkiksi numeron itseisarvo ja pyöristys.
- Päivämäärä ja aika – sisältää päivämäärää käsittelevät toiminnot, kuten päivämäärän osan noutaminen ja päivämäärien laskeminen yhteen.
- Merkkijono – sisältää merkkijonon tietojen käsittelemisen toimintoja, kuten alimerkkijonon noutaminen ja merkkijonojen jakaminen.
- Tilastollinen: Sisältää toimintoja, joilla noudetaan erilaisia tilastotietoja, kuten tapausten määrä ja tapausten odotustaika.
- Muut: Sisältää muut toiminnot, kuten tapahtumaa, tapausta ja johdettuja tilastotietoja käyttävät toiminnot.
Määritteiden nimet
Jos määritteen nimeä käytetään toiminnon parametrina, siihen voi viitata kolmella tavalla:
Käytä määritteen nimeä suoraan (esimerkiksi
Resource
).Käytä GETVALUE("määritteen nimi") -toimintoa (esimerkiksi
GETVALUE("Resource")
).Käytä suoraan määritteen lyhennettyä nimeä (esimerkiksi määritteeseen
attribute "Resource ID"
voidaan viitata nimelläResourceID
).
Toista muotoa käytetään, kun määritteen nimi ei ole nimeämiskäytännön mukainen. Määritteiden nimeämiskäytäntö määritetään seuraavasti:
Määritteen nimen on alettava kirjainmerkillä tai alaviivalla.
Määritteen nimi voi sisältää merkkejä vain seuraavista Unicode-vakioluokista: kirjainmerkki (Lu, Ll, Lt, Lm, Lo tai Nl), yhdistävä merkki (Mn tai Mc), desimaaliluku (Nd), yhdysmerkki (Pc) tai muotoilumerkki (Cf).
Lisätietoja edellä mainituista Unicode-merkkiluokista on kohdassa Unicode-standardi, versio 3.0, osio 4.5.
Kolmatta muotoa käytetään valinnaisesti, kun määritteen nimi on nimeämiskäytännön mukainen, mutta sisältää myös välilyöntimerkkejä. Toisen muodon GETVALUE("attribute name"
) käyttämisen sijaan voidaan poistaa välilyöntimerkkejä ja käyttää lyhennettyä versiota attributename
. Molemmat muodot ovat samanarvoisia.
Esimerkkejä KELVOLLISISTA määritteiden nimistä
DocumentCategory
DocCat
DocCat23
Esimerkkejä VIRHEELLISISTÄ määritteiden nimistä
Document.Category
Document Category
23DocCat
Esimerkkejä mittarikaavasta
Aktiviteetin suhteellisen keston laskeminen kaaviossa:
AVG (DURATION()) / AVG (VIEWCASES, DURATION())