Vorige Volgende

Klasse BirtComp

De klasse BirtComp biedt functies voor het vergelijken van waarden, bijvoorbeeld om te controleren of een waarde gelijk, groter dan of kleiner dan een andere waarde is. Alle functies leveren booleaanse waarden op. Dit is een statische klasse. De toepassing kan geen instances van de klasse maken.

BirtComp.anyOf

Deze functie vergelijkt een of meer waarden met de inhoud van een veld.

Syntaxis

BirtComp.anyOf( bron, doel1, ..., doelN )

Parameters

bron

Een veld met inhoud die voor de vergelijking kan worden gebruikt.

doel

De waarde of waarden die in de bron worden gezocht.

Resultaat

Booleaans. Retourneert true (waar) als de doelwaarde overeenkomt komt de bronwaarde; retourneert false (onwaar) als dit niet het geval is.

Voorbeelden

In het volgende voorbeeld wordt gecontroleerd of Canada, Mexico, en USA waarden in het veld Land zijn. Als een van de landen in het veld voorkomt, retourneert de functie de waarde true.

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

In het volgende voorbeeld wordt gecontroleerd of 15 jan 2009 en 31 jan 2009 waarden zijn in het veld payDate:

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

In het volgende voorbeeld wordt gecontroleerd of twee specifieke productcodes waarden in het veld productCode zijn. Als een van deze waarden in het veld wordt weergegeven, wordt de tekenreeks Verouderd afgebeeld; als dit niet het geval is, wordt de waarde van productCode weergegeven zoals in het veld.

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

BirtComp.between

Deze functie controleert of er een waarde tussen twee opgegeven waarden voorkomt.

Syntaxis

BirtComp.between( bron, doel1, doel2 )

Parameters

bron

De te controleren waarde.

doel1

De eerste waarde in het waardebereik waarin de controle wordt uitgevoerd.

doel2

De tweede waarde in het waardebereik waarin de controle wordt uitgevoerd.

Resultaat

Retourneert true (waar) als de bronwaarde zich tussen waarden doel1 en doel2 bevindt; boolean false (onwaar) als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of veldwaarden zich binnen een opgegeven waardebereik bevinden:

BirtComp.between( row["VerkoopTotaal"], 10000, 20000 )
BirtComp.between( row["KlantNaam"], "A", "M" )
BirtComp.between( row["OrderDatum"], "01-01-2009", "31-01-2009" )

In het volgende voorbeeld worden verzendingsdatums berekend. Als een waarde van OrderDatum in december 2008 valt (tussen 01-12-08 en 31-12-08), moeten er 5 dagen aan de waarde van OrderDatum worden toegevoegd. Als een waarde van OrderDatum in een andere maand dan december valt, moeten er 3 dagen aan de waarde van OrderDatum worden toegevoegd.

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

BirtComp.compareString

Deze functie controleert of een tekenreeks overeenkomt met een andere tekenreeks, rekening houdend met de opgegeven voorwaarden.

Syntaxis

BirtComp.compareString( bron1, bron2, ignoreCase, trim )

Parameters

bron1

De eerste tekenreeks voor de vergelijking.

bron2

De tweede tekenreeks voor de vergelijking.

ignoreCase

Geef true op om hoofdlettergebruik te negeren. Geef false op als er bij de vergelijking onderscheid moet worden gemaakt tussen hoofdletters en kleine letters.

trim

Geef true op om voorloop- of volgspaties te verwijderen voordat de twee waarden met elkaar worden vergeleken. Spaties midden in de tekenreeksen worden niet verwijderd. Geef false op als u tijdens de vergelijking gebruik wilt maken van voorloop- of volgspaties.

Resultaat

Retourneert true als bron1 overeenkomt met bron2; retourneert false als dit niet het geval is.

Voorbeelden

In de volgende expressies worden tekenreeksen onder verschillende voorwaarden vergeleken:

BirtComp.compareString( "Jackson", "Jackson", false, false ) // retourneert true
BirtComp.compareString( "Jackson", "jackson", false, true ) // retourneert false
BirtComp.compareString( "Jackson", "jackson", true, false ) // retourneert true
BirtComp.compareString( "Jackson ", "jackson", true, false ) // retourneert false
BirtComp.compareString( "Jackson ", "jackson", true, true ) // retourneert true

BirtComp.equalTo

Deze functie controleert of een waarde gelijk is aan een andere waarde.

Syntaxis

BirtComp.equalTo( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde gelijk is aan de doelwaarde, retourneert false als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of bepaalde veldwaarden gelijk zijn aan de opgegeven waarden:

BirtComp.equalTo( row["VerkoopTotaal"], 10000 )
BirtComp.equalTo( row["Land"], "Frankrijk" )
BirtComp.equalTo( row["OrderDatum"], "15-02-2009" )

BirtComp.greaterOrEqual

Deze functie controleert of een waarde groter dan of gelijk aan een andere waarde is.

Syntaxis

BirtComp.greaterOrEqual( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde groter is dan, of gelijk is aan de doelwaarde, retourneert false als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of veldwaarden groter zijn dan of gelijk zijn aan de opgegeven waarden:

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

BirtComp.greaterThan

Deze functie controleert of een waarde groter dan een andere waarde is.

Syntaxis

BirtComp.greaterThan( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde groter is dan de doelwaarde, retourneert false als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of bepaalde veldwaarden groter zijn dan de opgegeven waarden:

BirtComp.greaterThan( row["VerkoopTotaal"], 10000 )
BirtComp.greaterThan( row["KlantNaam"], "M" )
BirtComp.greaterThan( row["OrderDatum"], "15-02-2009" )

BirtComp.lessOrEqual

Deze functie controleert of een waarde kleiner dan of gelijk aan een andere waarde is.

Syntaxis

BirtComp.lessOrEqual( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde kleiner is dan, of gelijk is aan de doelwaarde, retourneert false als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of veldwaarden kleiner zijn dan of gelijk zijn aan de opgegeven waarden:

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

BirtComp.lessThan

Deze functie controleert of een waarde kleiner dan een andere waarde is.

Syntaxis

BirtComp.lessThan( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde kleiner is dan de doelwaarde, retourneert false als dit niet het geval is.

Voorbeelden

De volgende expressies controleren of bepaalde veldwaarden kleiner zijn dan de opgegeven waarden:

BirtComp.lessThan( row["VerkoopTotaal"], 10000 )
BirtComp.lessThan( row["KlantNaam"], "M" )
BirtComp.lessThan( row["OrderDatum"], "15-02-2009" )

BirtComp.like

Deze functie controleert of een tekenreeks overeenkomt met een patroon. Het patroon moet gebruikmaken van SQL-syntaxis voor patroonvergelijking.

Syntaxis

BirtComp.like( bron, doel )

Parameters

bron

De tekenreeks die gecontroleerd moet worden.

doel

Het reekspatroon dat overeen moet stemmen. Het patroon moet tussen dubbele aanhalingstekens staan (" "). Zorg dat u de juiste hoofdletters en kleine letters typt die overeen moeten komen. In het patroon kunt u de volgende speciale tekens gebruiken:

*
*

Om overeenkomsten te vinden met een literaal procentteken (%) of een liggend streepje (_), zorgt u dat deze tekens voorafgegaan worden door twee schuine strepen naar links (\\). Als u bijvoorbeeld overeenkomsten zoekt voor S_10, gebruikt u het volgende patroon:

S\\_10

Als u overeenkomsten zoekt voor 50%, gebruikt u het volgende patroon:

50\\%

Resultaat

Retourneert true als de bronwaarde overeenkomt met de doelwaarde; retourneert false als dit niet het geval is.

Voorbeelden

Het volgende voorbeeld retourneert true voor waarden in het veld productCode die beginnen met S18:

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

Het volgende voorbeeld retourneert true voor productNaam-waarden die de subreeks Ford bevatten, voorafgegaan door één teken:

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

BirtComp.match

Deze functie controleert of een tekenreeks overeenkomt met een patroon. Het patroon moet gebruikmaken van JavaScript-syntaxis voor expressies.

Syntaxis

BirtComp.match( bron, doel )

Parameters

bron

De tekenreeks die gecontroleerd moet worden.

doel

Het reekspatroon dat overeen moet stemmen. In de JavaScript-expressiesyntaxis kunt u een patroon opgeven tussen twee schuine strepen naar rechts. U kunt alle speciale tekens gebruiken die door JavaScript-expressies worden ondersteund, bijvoorbeeld de volgende:

*
*
*
*
*

Om een letterlijke overeenkomst met een speciaal teken te zoeken, moet het speciale teken worden voorafgegaan door een schuine streep naar links (\). Als u bijvoorbeeld overeenkomsten zoekt voor S*10, gebruikt u het volgende patroon:

/S\*10/

Resultaat

Retourneert true als de bronwaarde overeenkomt met de doelwaarde; retourneert false als dit niet het geval is.

Voorbeelden

Het volgende voorbeeld retourneert true voor waarden in het veld productCode die beginnen met S18:

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

Het volgende voorbeeld retourneert true voor productNaam-waarden die de subreeks Deur bevatten:

BirtComp.match( row["productNaam"], /Deur/ )

BirtComp.notBetween

Deze functie controleert of er een waarde niet tussen twee opgegeven waarden voorkomt.

Syntaxis

BirtComp.notBetween( bron, doel1, doel2 )

Parameters

bron

De te controleren waarde.

doel1

De eerste waarde in het waardebereik waarin de controle wordt uitgevoerd.

doel2

De tweede waarde in het waardebereik waarin de controle wordt uitgevoerd.

Resultaat

Retourneert true (waar) als de bronwaarde zich NIET tussen waarden doel1 en doel2 bevindt; false (onwaar) als dit wél het geval is.

Voorbeelden

De volgende expressies controleren of veldwaarden zich buiten een opgegeven waardebereik bevinden:

BirtComp.notBetween( row["VerkoopTotaal"], 10000, 20000 )
BirtComp.notBetween( row["KlantNaam"], "A", "M" )
BirtComp.notBetween( row["OrderDatum"], "01-01-2009", "31-01-2009" )

In het volgende voorbeeld worden verzendingsdatums berekend. Als een waarde van OrderDatum niet in december 2008 valt (niet tussen 01-12-08 en 31-12-08), moeten er 3 dagen aan de waarde van OrderDatum worden toegevoegd. Als een waarde van OrderDatum in december valt, moeten er 5 dagen aan de waarde van OrderDatum worden toegevoegd.

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

BirtComp.notEqual

Deze functie controleert of een waarde ongelijk is aan een andere waarde.

Syntaxis

BirtComp.notEqual( bron, doel )

Parameters

bron

De eerste waarde voor de vergelijking.

doel

De tweede waarde voor de vergelijking.

Resultaat

Retourneert true als de bronwaarde niet gelijk is aan de doelwaarde, retourneert false als dit wel het geval is.

Voorbeelden

De volgende expressies controleren of bepaalde veldwaarden NIET gelijk zijn aan de opgegeven waarden:

BirtComp.notEqual( row["VerkoopTotaal"], 10000 )
BirtComp.notEqual( row["Land"], "Frankrijk" )
BirtComp.notEqual( row["OrderDatum"], "15-02-2009" )

BirtComp.notLike

Deze functie controleert of een tekenreeks niet overeenkomt met een patroon. Het patroon moet gebruikmaken van SQL-syntaxis voor patroonvergelijking.

Syntaxis

BirtComp.notLike( bron, doel )

Parameters

bron

De tekenreeks die gecontroleerd moet worden.

doel

Het tekenreekspatroon voor vergelijking. Het patroon moet tussen dubbele aanhalingstekens staan (" "). Zorg dat u de juiste hoofdletters en kleine letters typt die overeen moeten komen. In het patroon kunt u de volgende speciale tekens gebruiken:

*
*

Om overeenkomsten te vinden met een literaal procentteken (%) of een liggend streepje (_), zorgt u dat deze tekens voorafgegaan worden door twee schuine strepen naar links (\\). Als u bijvoorbeeld overeenkomsten zoekt voor S_10, gebruikt u het volgende patroon:

S\\_10

Als u overeenkomsten zoekt voor 50%, gebruikt u het volgende patroon:

50\\%

Resultaat

Retourneert true als de bronwaarde niet overeenkomt met de doelwaarde, retourneert false als dit wel het geval is.

Voorbeelden

Het volgende voorbeeld retourneert false voor waarden in het veld productCode die beginnen met S18:

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

Het volgende voorbeeld retourneert false voor productNaam-waarden die de subreeks Ford bevatten, voorafgegaan door één teken:

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

(c) Copyright Actuate Corporation 2013