Edellinen Seuraava

BirtComp-luokka

BirtComp-luokan funktioiden avulla voit verrata arvoja esimerkiksi testaamalla, onko arvo yhtä suuri, pienempi kuin vai suurempi kuin toinen arvo. Kaikki funktiot palauttavat totuusarvon. Tämä luokka on staattinen. Sovellus ei voi luoda luokan ilmentymiä.

BirtComp.anyOf

Tämä funktio vertaa ainakin yhtä arvoa kentän sisältöön.

Syntaksi

totuusarvo BirtComp.anyOf( lähde, kohde1, ..., kohdeN )

Parametrit

lähde

Kenttä, jonka sisältöä käytetään vertailussa.

kohde

Lähteestä haettavat arvot.

Palautukset

Totuusarvo. Tosi, jos kohdearvo vastaa lähdettä, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraava esimerkki testaa, löytyykö Country-kentästä Canada-, Mexico- tai USA-merkkijonoja. Jos kentässä on jokin näistä maan nimistä, funktio palauttaa tosi (true) -arvon.

BirtComp.anyOf(dataSetRow["Country"], "Canada", "Mexico", "USA")

Seuraava esimerkki testaa, onko payDate-kentässä päivämääräarvoja 15.1.2009 tai 31.1.2009:

BirtComp.anyOf(dataSetRow["payDate"], "2009-01-15", "2009-01-31")

Seuraava esimerkki testaa, onko productCode-kentässä kahta määritettyä tuotekoodia. Jos kentässä on jompikumpi arvoista, näkyviin tulee merkkijono "Obsolete". Muussa tapauksessa näkyviin tulee kentän productCode-arvo.

if (BirtComp.anyOf(dataSetRow["PRODUCTCODE"], "S18_1749", "S18_2248" )){
  displayString = "Obsolete"
}else{
  dataSetRow["PRODUCTCODE"]
}

BirtComp.between

Tämä funktio testaa, onko arvo kahden määritetyn arvon välissä.

Syntaksi

totuusarvo BirtComp.between( lähde, kohde1, kohde2 )

Parametrit

lähde

Testattava arvo.

kohde1

Verrattavan arvovälin aloitusarvo.

kohde2

Verrattavan arvovälin lopetusarvo.

Palautukset

Tosi, jos lähdearvo on kohde1- ja kohde2-arvojen välisellä arvoalueella, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot määritetyllä arvoalueella:

BirtComp.between( row["SalesTotal"], 10000, 20000 )
BirtComp.between( row["CustomerName"], "A", "M" )
BirtComp.between( row["OrderDate"], "2009-01-01", "2009-01-31" )

Seuraava esimerkki laskee toimituspäivät. Jos OrderDate-kentän (tilauspäivämäärä) arvo on joulukuussa 2008 (1.12.08 - 31.12.08), OrderDate-arvoon lisätään viisi päivää. Jos OrderDate-kentän arvo on muussa kuussa kuin joulukuussa, OrderDate-arvoon lisätään kolme päivää.

if (BirtComp.between(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }

BirtComp.compareString

Tämä funktio testaa, vastaako merkkijonoarvo toista, määritettyjen ehtojen mukaista merkkijonoarvoa.

Syntaksi

totuusarvo BirtComp.compareString( lähde1, lähde2, kirjainkoko, lyhennys )

Parametrit

lähde1

Ensimmäinen vertailussa käytettävä merkkijonoarvo.

lähde2

Toinen vertailussa käytettävä merkkijonoarvo.

kirjainkoko

Määritä arvoksi true, jos haluat ettei kirjainkokoa tarkisteta vertailussa. Määritä arvoksi false, jos haluat tarkistaa kirjainkoon vertailussa.

lyhennys

Määritä arvoksi true, jos haluat poistaa merkkijonoja edeltävät tai niiden jälkeiset tyhjämerkit ennen arvojen vertailua. Merkkijonon sisäisiä tyhjämerkkejä ei poisteta. Määritä arvoksi false, jos haluat huomioida merkkijonoa edeltävät ja sen jälkeiset tyhjämerkit vertailussa.

Palautukset

Tosi, jos lähde1-arvo vastaa lähde2-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla verrataan merkkijonoja eri vertailuehdoin:

BirtComp.compareString( "Jackson", "Jackson", false, false ) // palauttaa tosi (true) -arvon
BirtComp.compareString( "Jackson", "jackson", false, true ) // palauttaa epätosi (false) -arvon
BirtComp.compareString( "Jackson", "jackson", true, false ) // palauttaa tosi (true) -arvon
BirtComp.compareString( "Jackson ", "jackson", true, false ) // palauttaa epätosi (false) -arvon
BirtComp.compareString( "Jackson ", "jackson", true, true ) // palauttaa tosi (true) -arvon

BirtComp.equalTo

Tämä funktio testaa, onko arvo yhtä suuri kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.equalTo( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo vastaa kohde-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot yhtä suuret kuin määritetyt arvot:

BirtComp.equalTo( row["SalesTotal"], 10000 )
BirtComp.equalTo( row["Country"], "France" )
BirtComp.equalTo( row["OrderDate"], "2009-02-15" )

BirtComp.greaterOrEqual

Tämä funktio testaa, onko arvo suurempi tai yhtä suuri kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.greaterOrEqual( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo on suurempi tai yhtä suuri kuin kohde-arvo, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot suuremmat tai samat kuin määritetyt arvot:

BirtComp.greaterOrEqual( row["SalesTotal"], 10000 )
BirtComp.greaterOrEqual( row["ProductCode"], "S50_4000" )
BirtComp.greaterOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.greaterThan

Tämä funktio testaa, onko arvo suurempi kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.greaterThan( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo on suurempi kuin kohde-arvo, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot suuremmat kuin määritetyt arvot:

BirtComp.greaterThan( row["SalesTotal"], 10000 )
BirtComp.greaterThan( row["CustomerName"], "M" )
BirtComp.greaterThan( row["OrderDate"], "2009-02-15" )

BirtComp.lessOrEqual

Tämä funktio testaa, onko arvo pienempi tai yhtä suuri kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.lessOrEqual( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo on pienempi tai yhtä suuri kuin kohde-arvo, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot pienemmät tai yhtä suuret kuin määritetyt arvot:

BirtComp.lessOrEqual( row["SalesTotal"], 10000 )
BirtComp.lessOrEqual( row["ProductCode"], "S18_4000" )
BirtComp.lessOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.lessThan

Tämä funktio testaa, onko arvo pienempi kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.lessThan( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo on pienempi kuin kohde-arvo, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot pienemmät kuin määritetyt arvot:

BirtComp.lessThan( row["SalesTotal"], 10000 )
BirtComp.lessThan( row["CustomerName"], "M" )
BirtComp.lessThan( row["OrderDate"], "2009-02-15" )

BirtComp.like

Tämä funktio testaa, vastaako merkkijonoarvo arvo mallia. Mallin on oltava SQL-mallivastinesyntaksin mukainen.

Syntaksi

totuusarvo BirtComp.like( lähde, kohde )

Parametrit

lähde

Arvioitava merkkijonoarvo.

kohde

Merkkijonomalli, johon arvoa verrataan. Kirjoita mallikaava lainausmerkkeihin (" "). Kirjoita vastaavuustarkistuksen merkit oikeassa kirjainkoossa. Voit käyttää mallissa seuraavia erikoismerkkejä:

*
*

Jos haluat käyttää vertailumallissa prosenttimerkkiä (%) tai alaviivaa (_), kirjoita niiden eteen kaksi kenoviivaa (\\). Jos esimerkiksi haluat käyttää vertailuun merkkijonoa "S_10", käytä seuraavaa mallia:

S\\_10

Jos haluat käyttää vertailuun merkkijonoa "50%", käytä seuraavaa mallia:

50\\%

Palautukset

Tosi, jos lähde-arvo vastaa kohde-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraava esimerkki palauttaa tosi (true) -arvon niille productCode-kentän arvoille, jotka alkavat merkkijonolla "S18":

BirtComp.like( row["productCode"], "S18%" )

Seuraava esimerkki palauttaa tosi (true) -arvon niille productName-kentän arvoille, joissa on merkkijono "Ford" ja jokin muu merkki kyseisen merkkijonon edellä:

BirtComp.like( row["productName"], "_Ford%" )

BirtComp.match

Tämä funktio testaa, vastaako merkkijonoarvo arvo mallia. Mallin on oltava JavaScript-kielen säännöllisten lausekkeiden syntaksin mukainen.

Syntaksi

totuusarvo BirtComp.match( lähde, kohde )

Parametrit

lähde

Arvioitava merkkijonoarvo.

kohde

Merkkijonomalli, johon arvoa verrataan. JavaScript-kielen säännöllisten lausekkeiden syntaksin mukaisesti malli on kirjoitettava vinoviivoihin (/). Voit käyttää kaikkia JavaScript-kielen säännöllisissä lausekkeissa sallittuja erikoismerkkejä, kuten seuraavia:

*
*
*
*
*

Jos haluat käyttää erikoismerkkiä tavallisena haettavana merkkinä, kirjoita sen edelle kenoviiva (\). Jos esimerkiksi haluat käyttää vertailuun merkkijonoa "S*10", käytä seuraava mallia:

/S\*10/

Palautukset

Tosi, jos lähde-arvo vastaa kohde-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraava esimerkki palauttaa tosi (true) -arvon niille productCode-kentän arvoille, jotka alkavat merkkijonolla "S18":

BirtComp.match( row["productCode"], /^S18/ )

Seuraava esimerkki palauttaa tosi (true) -arvon niille productName-kentän arvoille, joissa esiintyy merkkijono "Ford":

BirtComp.match( row["productName"], /Ford/ )

BirtComp.notBetween

Tämä funktio testaa, onko arvo kahden määritetyn arvon rajaaman arvoalueen ulkopuolinen arvo.

Syntaksi

totuusarvo BirtComp.notBetween( lähde, kohde1, kohde2 )

Parametrit

lähde

Testattava arvo.

kohde1

Verrattavan arvovälin aloitusarvo.

kohde2

Verrattavan arvovälin lopetusarvo.

Palautukset

Tosi, jos lähdearvo on kohde1- ja kohde2-arvojen välisen arvoalueen ulkopuolinen arvo, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot määritettyjen arvoalueiden ulkopuolisia arvoja:

BirtComp.notBetween( row["SalesTotal"], 10000, 20000 )
BirtComp.notBetween( row["CustomerName"], "A", "M" )
BirtComp.notBetween( row["OrderDate"], "2009-01-01", "2009-01-31" )

Seuraava esimerkki laskee toimituspäivät. Jos OrderDate-kentän (tilauspäivämäärä) arvo ei ole joulukuussa 2008 (1.12.08 - 31.12.08), OrderDate-arvoon lisätään kolme päivää. Jos OrderDate-kentän arvo on joulukuussa, OrderDate-arvoon lisätään viisi päivää.

if (BirtComp.notBetween(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }

BirtComp.notEqual

Tämä funktio testaa, onko arvo eri suuri kuin toinen arvo.

Syntaksi

totuusarvo BirtComp.notEqual( lähde, kohde )

Parametrit

lähde

Ensimmäinen vertailussa käytettävä arvo.

kohde

Toinen vertailussa käytettävä arvo.

Palautukset

Tosi, jos lähde-arvo eri vastaa kohde-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraavilla lausekkeilla testataan, ovatko kenttien arvot eri suuret kuin määritetyt arvot:

BirtComp.notEqual( row["SalesTotal"], 10000 )
BirtComp.notEqual( row["Country"], "France" )
BirtComp.notEqual( row["OrderDate"], "2009-02-15" )

BirtComp.notLike

Tämä funktio testaa, onko merkkijonoarvo eri suuri kuin malli. Mallin on oltava SQL-mallivastinesyntaksin mukainen.

Syntaksi

totuusarvo BirtComp.notLike( lähde, kohde )

Parametrit

lähde

Arvioitava merkkijonoarvo.

kohde

Merkkijonomalli, johon arvoa verrataan. Kirjoita mallikaava lainausmerkkeihin (" "). Kirjoita vastaavuustarkistuksen merkit oikeassa kirjainkoossa. Voit käyttää mallissa seuraavia erikoismerkkejä:

*
*

Jos haluat käyttää vertailumallissa prosenttimerkkiä (%) tai alaviivaa (_), kirjoita niiden eteen kaksi kenoviivaa (\\). Jos esimerkiksi haluat käyttää vertailuun merkkijonoa "S_10", käytä seuraavaa mallia:

S\\_10

Jos haluat käyttää vertailuun merkkijonoa "50%", käytä seuraavaa mallia:

50\\%

Palautukset

Tosi, jos lähde-arvo ei vastaa kohde-arvoa, ja epätosi muussa tapauksessa.

Esimerkkejä

Seuraava esimerkki palauttaa epätosi (false) -arvon niille productCode-kentän arvoille, jotka alkavat merkkijonolla "S18":

BirtComp.notLike( row["productCode"], "S18%" )

Seuraava esimerkki palauttaa epätosi (false) -arvon niille productName-kentän arvoille, joissa on merkkijono "Ford" ja jokin muu merkki kyseisen merkkijonon edellä:

BirtComp.notLike( row["productName"], "_Ford%" )

(c) Copyright Actuate Corporation 2013