Előző Következő

BirtComp osztály

A BirtComp osztály értékek összehasonlításához biztosít függvényeket, például annak teszteléséhez, hogy egy érték egyenlő, nagyobb, vagy kisebb, mint egy másik érték. Az összes függvény logikai értéket ad vissza. Ez az osztály statikus. Az alkalmazás nem hozhat létre példányokat az osztályból.

BirtComp.anyOf

Ez a függvény egy vagy több értéket hasonlít összes egy mező tartalmával.

Szintaxis

boolean BirtComp.anyOf( source, target1, ..., targetN )

Paraméterek

source

Az összehasonításhoz használni kívánt tartalmat tartalmazó mező.

target

A forrásban keresendő érték(ek).

Visszatérési érték

Logikai érték. True (igaz), ha a cél érték megegyezik egy forrásban található értékkel; egyébként false (hamis) értéket ad vissza.

Példák

A következő példa ellenőrzi, hogy Canada, Mexico vagy az USA értékek szerepelnek-e a Country (ország) mezőben. Ha az országok egyike szerepel a mezőben, akkor a függvény true értéket ad vissza.

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

A következő példa ellenőrzi, hogy 2009. január 15. vagy 2009. január 31. szerepelnek-e a payDate mezőben:

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

A következő példa ellenőrzi, hogy két adott termékkód szerepel-e értékként a productCode mezőben. Ha az egyik érték megjelenik a mezőben, akkor az Obsolate (elavult) karaktersorozat jelenik meg; máskülönben a productCode mező értéke jelenik meg, ahogy a mezőben szerepel.

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

BirtComp.between

Ez a függvény megvizsgálja, hogy egy érték a két megadott érték közé esik-e.

Szintaxis

boolean BirtComp.between( source, target1, target2 )

Paraméterek

source

A megvizsgálandó érték.

target1

Az összehasonlítandó tartomány első értéke.

target2

Az összehasonlítandó tartomány második értéke.

Visszatérési érték

True értéket ad vissza, ha a source értéke a target1 és a target2 értékek közé esik; egyébként false értéket.

Példák

A következő kifejezések megvizsgálják, hogy a mező értékek egy megadott értéktartományon belül vannak-e:

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

A következő példa szállítási dátumokat számít ki. Ha egy OrderDate (rendelési dátum) értéke 2008 decemberében van (08/12/01 és 08/12/31 közé esik), akkor 5 napot kell hozzáadni az OrderDate értékéhez. Ha egy OrderDate érték nem decemberi, akkor 3 napot 3 kell hozzáadni az OrderDate értékéhez.

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

Ez a függvény megvizsgálja, hogy egy karaktersorozat érték megfelel-e egy másik karaktersorozat értéknek, adott feltételek mellet.

Szintaxis

boolean BirtComp.compareString( source1, source2, ignoreCase, trim )

Paraméterek

source1

Az összehasonlításhoz használandó első karaktersorozat érték.

source2

Az összehasonlításhoz használandó második karaktersorozat érték.

ignoreCase

Ha nem kívánja megkülönböztetni a kis- és nagybetűket, akkor adjon meg true értéket. Ha olyan összehasonlítást szeretne végezni, amelyben a kis- és nagybetűk eltérőnek számítanak, akkor adja meg a false értéket.

trim

True érték esetén a két érték összehasonlításának elvégzése előtt eltávolít minden bevezető vagy befejező üres helyet. A karaktersorozat közepén lévő üres helyeket nem távolítja el. False érték megadása esetén az összehasonlítás tartalmazza a bevezető és befejező üres helyeket is.

Visszatérési érték

True, ha a source1 érték megfelel a source2 értéknek; egyébként false értéket ad vissza.

Példák

A következő kifejezések különböző feltételekkel megadott karaktersorozatokat hasonlítanak össze.

BirtComp.compareString( "Jackson", "Jackson", false, false ) // true értéket ad vissza
BirtComp.compareString( "Jackson", "jackson", false, true ) // false értéket ad vissza
BirtComp.compareString( "Jackson", "jackson", true, false ) // true értéket ad vissza
BirtComp.compareString( "Jackson ", "jackson", true, false ) // false értéket ad vissza
BirtComp.compareString( "Jackson ", "jackson", true, true ) // true értéket ad vissza

BirtComp.equalTo

Ez a függvény megvizsgálja, hogy egy érték egyenlő-e egy másik értékkel.

Szintaxis

boolean BirtComp.equalTo( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték egyenlő a target értékkel; máskülönben false értéket ad vissza.

Példák

A következő kifejezések megvizsgálják, hogy a mező értékek egyenlőek-e a megadott értékekkel:

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

BirtComp.greaterOrEqual

Ez a függvény megvizsgálja, hogy egy érték nagyobb vagy egyenlő-e egy másik értékkel.

Szintaxis

boolean BirtComp.greaterOrEqual( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték nagyobb vagy egyenlő a target értékkel; egyébként false értéket ad vissza.

Példák

A következő kifejezések azt vizsgálják meg, hogy a mező értékek nagyobbak vagy egyenlőek-e a megadott értékekkel:

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

BirtComp.greaterThan

Ez a függvény azt vizsgálja meg, hogy az érték nagyobb-e egy másik értéknél.

Szintaxis

boolean BirtComp.greaterThan( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték nagyobb, mint a target érték; máskülönben false értéket ad vissza.

Példák

A következő kifejezések azt vizsgálják, hogy a mező értékek nagyobbak-e, mint a megadott értékek:

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

BirtComp.lessOrEqual

Ez a függvény megvizsgálja, hogy egy érték kisebb vagy egyenlő-e egy másik értékkel.

Szintaxis

boolean BirtComp.lessOrEqual( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték kisebb vagy egyenlő a target értékkel; egyébként false értéket ad vissza.

Példák

A következő kifejezések azt vizsgálják meg, hogy a mező értékek kisebbek vagy egyenlőek-e a megadott értékekkel:

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

BirtComp.lessThan

Ez a függvény azt vizsgálja meg, hogy az érték kisebb-e egy másik értéknél.

Szintaxis

boolean BirtComp.lessThan( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték kisebb, mint a target érték; máskülönben false értéket ad vissza.

Példák

A következő kifejezések azt vizsgálják, hogy a mező értékek kisebbek-e, mint a megadott értékek:

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

BirtComp.like

Ez a függvény azt vizsgálja, hogy egy karaktersorozat megfelel-e egy mintának. A mintának SQL mintaillesztési szintaxist kell használnia.

Szintaxis

boolean BirtComp.like( source, target )

Paraméterek

source

A kiértékelni kívánt karaktersorozat érték.

target

A megfeleltetni kívánt karaktersorozat minta. A mintát dupla idézőjelek (" ") közé kell zárni. A megfeleltetni kívánt karakterek beírásakor ügyeljen a kis- és nagybetűk helyes használatára. A mintában a következő speciális karaktereket használhatja:

*
*

Egy százalékjel (%) vagy aláhúzás (_) karakter literál megfeleltetéséhez szúrjon be a karakterek elé két fordított törtvonal (\\) karaktert. Például az S_10 megfeleltetéséhez használja a következő mintát:

S\\_10

Az 50% megfeleltetéséhez használja a következő mintát:

50\\%

Visszatérési érték

True, ha a source érték megfelel a target értéknek; egyébként false értéket ad vissza.

Példák

A következő példa true értéket ad vissza a productCode mező S18 kezdetű értékei esetén:

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

A következő példa true értéket ad vissza az olyan productName értékek esetén, melyekben szerepel a Ford rész-karaktersorozat és előtte egy tetszőleges karakter:

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

BirtComp.match

Ez a függvény azt vizsgálja, hogy egy karaktersorozat megfelel-e egy mintának. A mintának a JavaScript reguláris kifejezés szintaxist kell használnia.

Szintaxis

boolean BirtComp.match( source, target )

Paraméterek

source

A kiértékelni kívánt karaktersorozat érték.

target

A megfeleltetni kívánt karaktersorozat minta. A JavaScript reguláris kifejezés szintaxisban a mintát egy osztásjel (/) pár között kell megadnia. A JavaScript reguláris kifejezések által támogatott bármely speciális karaktert használja, mint például a következők:

*
*
*
*
*

Speciális karakter pontos egyeztetéséhez a speciális karakter elé fordított törtvonalat (\) kell írni. Például az S*10 megfeleltetéséhez használja a következő mintát:

/S\*10/

Visszatérési érték

True, ha a source érték megfelel a target értéknek; egyébként false értéket ad vissza.

Példák

A következő példa true értéket ad vissza a productCode mező S18 kezdetű értékei esetén:

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

A következő példa true értéket ad vissza az olyan productName értékek esetén, melyekben szerepel a Ford rész-karaktersorozat.

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

BirtComp.notBetween

Ez a függvény azt vizsgálja, hogy egy érték a két megadott nincs a két megadott érték között.

Szintaxis

boolean BirtComp.notBetween( source, target1, target2 )

Paraméterek

source

A megvizsgálandó érték.

target1

Az összehasonlítandó tartomány első értéke.

target2

Az összehasonlítandó tartomány második értéke.

Visszatérési érték

True értéket ad vissza, ha a source értéke nem esik a target1 és a target2 értékek közé; egyébként false értéket.

Példák

A következő kifejezések megvizsgálják, hogy a mező értékek egy megadott értéktartományon kívül vannak-e:

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

A következő példa szállítási dátumokat számít ki. Ha egy OrderDate (rendelési dátum) érték nem 2008 decemberi (nem 08/12/01 és 08/12/31 közötti), akkor 3 napot kell hozzáadni az OrderDate értékéhez. Ha az OrderDate érték decemberi, akkor 5 napot kell hozzáadni az OrderDate értékéhez.

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

Ez a függvény megvizsgálja, hogy egy érték nem egyenlő-e egy másik értékkel.

Szintaxis

boolean BirtComp.notEqual( source, target )

Paraméterek

source

Az összehasonlításban használandó első érték.

target

Az összehasonlításhoz használandó második érték.

Visszatérési érték

True, ha a source érték nem egyenlő a target értékkel; máskülönben false értéket ad vissza.

Példák

A következő kifejezések megvizsgálják, hogy a mező értékek nem egyenlőek-e a megadott értékekkel:

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

BirtComp.notLike

Ez a függvény azt vizsgálja, hogy egy karaktersorozat nem felel-e meg egy mintának. A mintának SQL mintaillesztési szintaxist kell használnia.

Szintaxis

boolean BirtComp.notLike( source, target )

Paraméterek

source

A kiértékelni kívánt karaktersorozat érték.

target

Az összehasonlítani kívánt karaktersorozat minta. A mintát dupla idézőjelek (" ") közé kell zárni. A megfeleltetni kívánt karakterek beírásakor ügyeljen a kis- és nagybetűk helyes használatára. A mintában a következő speciális karaktereket használhatja:

*
*

Egy százalékjel (%) vagy aláhúzás (_) karakter literál megfeleltetéséhez szúrjon be a karakterek elé két fordított törtvonal (\\) karaktert. Például az S_10 megfeleltetéséhez használja a következő mintát:

S\\_10

Az 50% megfeleltetéséhez használja a következő mintát:

50\\%

Visszatérési érték

True, ha a source érték nem felel meg a target értéknek; egyébként false értéket ad vissza

Példák

A következő példa false értéket ad vissza a productCode mező S18 kezdetű értékei esetén:

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

A következő példa false értéket ad vissza az olyan productName értékek esetén, melyekben szerepel a Ford rész-karaktersorozat és előtte egy tetszőleges karakter:

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

(c) Copyright Actuate Corporation 2013