Poprzedni Następny

Klasa BirtComp

Klasa BirtComp udostępnia funkcje do porównywania wartości, na przykład do sprawdzania, czy wartość jest większa lub mniejsza od innej wartości lub czy wartości są sobie równe. Wszystkie funkcje zwracają wartości boolowskie. Jest to klasa statyczna. Aplikacja nie może tworzyć instancji klasy.

BirtComp.anyOf

Ta funkcja porównuje co najmniej jedną wartość z zawartością pola.

Składnia

boolean BirtComp.anyOf( źródło, cel1, ..., celN )

Parametry

źródło

Pole, którego zawartość jest używana do porównania.

cel

Wartość albo wartości do znalezienia w źródle.

Wartości zwracane

Wartość boolowska. Wartość true, jeśli wartość celu odpowiada wartości źródła. Wartość false w pozostałych przypadkach.

Przykłady

Następujący przykład pozwoli sprawdzić, czy w polu Kraj znajduje się wartość Kanada, Meksyk albo USA. Jeśli którykolwiek z tych krajów znajduje się na liście, funkcja zwróci wartość true.

BirtComp.anyOf(dataSetRow["Kraj"], "Kanada", "Meksyk", "USA")

Następujący przykład pozwala sprawdzić, czy dni 15 stycznia 2009 r. lub 31 stycznia 2009 r. są wartościami pola dataPłatności:

BirtComp.anyOf(dataSetRow["dataPłatności"], "2009-01-15", "2009-01-31")

Następujący przykład pozwala sprawdzić, czy konkretne kody produktów są wartościami pola kodProduktu. Jeśli któraś z wartości występuje w polu, zostanie wyświetlony komunikat Przestarzałe. W przeciwnym przypadku zostanie wyświetlona taka sama wartość jak ta, która jest podana w polu kodProduktu.

if (BirtComp.anyOf(dataSetRow["kodProduktu"], "S18_1749", "S18_2248" )){
  displayString = "Przestarzałe"
}else{
  dataSetRow["kodProduktu"]
}

BirtComp.between

Za pomocą tej funkcji można sprawdzić, czy wartość znajduje się między dwiema innymi wartościami.

Składnia

boolean BirtComp.between( źródło, cel1, cel2 )

Parametry

źródło

Wartość do sprawdzenia.

cel1

Pierwsza wartość zakresu, z którym ma być porównywana wartość źródłowa.

cel2

Druga wartość zakresu, z którym ma być porównywana wartość źródłowa.

Wartości zwracane

Wartość true, jeśli wartość źródłowa należy do przedziału ustalonego wartościami cel1 i cel2. W przeciwnym razie wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól znajdują się w określonym przedziale:

BirtComp.between( row["SprzedażŁącznie"], 10000, 20000 )
BirtComp.between( row["NazwaKlienta"], "A", "M" )
BirtComp.between( row["DataZamówienia"], "2009-01-01", "2009-01-31" )

Następujący przykład pozwala obliczyć daty dostawy. Jeśli wartość DataZamówienia wypada w grudniu 2008 r. (czyli między 2008-12-01 i 2008-12-31), do wartości DataZamówienia zostanie dodane pięć dni. Jeśli wartość DataZamówienia wypada w innym miesiącu, do wartości DataZamówienia zostaną dodane trzy dni.

if (BirtComp.between(row["DataZamówienia"], "2008-12-01", "2008-12-31" )){
  DataDostawy = BirtDateTime.addDay( row["DataZamówienia"], 5 )
  }
else{
  DataDostawy = BirtDateTime.addDay( row["DataZamówienia"], 3 )
  }

BirtComp.compareString

Za pomocą tej funkcji można sprawdzić, czy łańcuch jest zgodny z innym łańcuchem z uwzględnieniem podanych warunków.

Składnia

boolean BirtComp.compareString( źródło1, źródło2, ignorujWielkośćLiter, przytnij )

Parametry

źródło1

Pierwszy łańcuch w porównaniu.

źródło2

Drugi łańcuch w porównaniu.

ignorujWielkośćLiter

Parametr, dla którego należy określić wartość true, jeśli porównywanie ma być wykonywane bez rozróżniania wielkości liter. Należy określić wartość false, aby wykonać porównywanie z rozróżnianiem wielkości liter.

przytnij

Parametr, dla którego należy określić wartość true, jeśli przed porównaniem dwóch wartości mają zostać usunięte odstępy na początku i na końcu. Odstępy znajdujące się wewnątrz łańcuchów nie są usuwane. Aby w porównaniu uwzględnić odstępy początkowe lub końcowe, należy dla tego parametru określić wartość false.

Wartości zwracane

Wartość true, jeśli wartość źródło1 odpowiada wartości źródło2; w przeciwnym przypadku wartość false.

Przykłady

W następujących wyrażeniach porównano łańcuchy, określając różne warunki:

BirtComp.compareString( "Kowalski", "Kowalski", false, false ) // zwraca wartość true
BirtComp.compareString( "Kowalski", "kowalski", false, true ) // zwraca wartość false
BirtComp.compareString( "Kowalski", "kowalski", true, false ) // zwraca wartość true
BirtComp.compareString( "Kowalski ", "kowalski", true, false ) // zwraca wartość false
BirtComp.compareString( "Kowalski ", "kowalski", true, true ) // zwraca wartość true

BirtComp.equalTo

Za pomocą tej funkcji można sprawdzić, czy wartość jest równa drugiej wartości.

Składnia

boolean BirtComp.equalTo( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa jest równa wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól są równe określonym wartościom:

BirtComp.equalTo( row["SprzedażŁącznie"], 10000 )
BirtComp.equalTo( row["Kraj"], "Francja" )
BirtComp.equalTo( row["DataZamówienia"], "2009-02-15" )

BirtComp.greaterOrEqual

Za pomocą tej funkcji można sprawdzić, czy wartość jest większa od drugiej wartości lub czy jest jej równa.

Składnia

boolean BirtComp.greaterOrEqual( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa jest równa wartości docelowej lub od niej większa. W przeciwnym razie wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól są większe od określonych wartości lub czy są im równe:

BirtComp.greaterOrEqual( row["SprzedażŁącznie"], 10000 )
BirtComp.greaterOrEqual( row["KodProduktu"], "S50_4000" )
BirtComp.greaterOrEqual( row["DataZamówienia"], "2009-02-15" )

BirtComp.greaterThan

Za pomocą tej funkcji można sprawdzić, czy wartość jest większa od drugiej wartości.

Składnia

boolean BirtComp.greaterThan( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa jest większa od wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól są większe od określonych wartości:

BirtComp.greaterThan( row["SprzedażŁącznie"], 10000 )
BirtComp.greaterThan( row["NazwaKlienta"], "M" )
BirtComp.greaterThan( row["DataZamówienia"], "2009-02-15" )

BirtComp.lessOrEqual

Za pomocą tej funkcji można sprawdzić, czy wartość jest mniejsza od drugiej wartości lub czy jest jej równa.

Składnia

boolean BirtComp.lessOrEqual( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa jest równa wartości docelowej lub od niej mniejsza. W przeciwnym razie wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól są mniejsze od określonych wartości lub czy są im równe:

BirtComp.lessOrEqual( row["SprzedażŁącznie"], 10000 )
BirtComp.lessOrEqual( row["KodProduktu"], "S18_4000" )
BirtComp.lessOrEqual( row["DataZamówienia"], "2009-02-15" )

BirtComp.lessThan

Za pomocą tej funkcji można sprawdzić, czy wartość jest mniejsza od drugiej wartości.

Składnia

boolean BirtComp.lessThan( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa jest większa od wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól są mniejsze od określonych wartości:

BirtComp.lessThan( row["SprzedażŁącznie"], 10000 )
BirtComp.lessThan( row["NazwaKlienta"], "M" )
BirtComp.lessThan( row["DataZamówienia"], "2009-02-15" )

BirtComp.like

Za pomocą tej funkcji można sprawdzić, czy łańcuch jest zgodny ze wzorcem. We wzorcu musi być używana składnia dopasowywania wzorca języka SQL.

Składnia

boolean BirtComp.like( źródło, cel )

Parametry

źródło

Łańcuch do oceny.

cel

Wzorzec łańcucha do dopasowania. Wzorzec należy ująć w cudzysłów (" "). W trakcie wpisywania znaków, które mają być dopasowane, należy używać liter o odpowiedniej wielkości. We wzorcu można użyć następującego znaku specjalnego:

*
*

Aby uzyskać dopasowanie znaku procentu (%) lub podkreślenia (_), należy poprzedzić te znaki dwoma ukośnikami odwrotnymi (\\). Na przykład aby uzyskać dopasowanie łańcucha S_10, należy użyć następującego wzorca:

S\\_10

Aby uzyskać dopasowanie do łańcucha 50%, należy użyć następującego wzorca:

50\\%

Wartości zwracane

Wartość true, jeśli wartość źródłowa odpowiada wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujący przykład zwraca wartość true dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:

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

Następujący przykład zwraca wartość true dla wartości pola nazwaProduktu, które zawierają podłańcuch Ford poprzedzony jednym znakiem:

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

BirtComp.match

Za pomocą tej funkcji można sprawdzić, czy łańcuch jest zgodny ze wzorcem. We wzorcu musi być używana składnia wyrażeń regularnych języka JavaScript.

Składnia

boolean BirtComp.match( źródło, cel )

Parametry

źródło

Łańcuch do oceny.

cel

Wzorzec łańcucha do dopasowania. W wyrażeniach regularnych JavaScript wzorzec jest podawany przy użyciu pary ukośników (/). Dostępne są wszystkie znaki specjalne, które są obsługiwane przez wyrażenia regularne JavaScript, takie jak:

*
*
*
*
*

Aby zapewnić dokładną zgodność ze znakiem specjalnym, należy go poprzedzić ukośnikiem odwrotnym (\). Na przykład aby uzyskać dopasowanie łańcucha S*10, należy użyć następującego wzorca:

/S\*10/

Wartości zwracane

Wartość true, jeśli wartość źródłowa odpowiada wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujący przykład zwraca wartość true dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:

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

Następujący przykład zwraca wartość true dla wartości pola nazwaProduktu, które zawierają podłańcuch Ford:

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

BirtComp.notBetween

Za pomocą tej funkcji można sprawdzić, czy wartość nie znajduje się między dwiema innymi wartościami.

Składnia

boolean BirtComp.notBetween( źródło, cel1, cel2 )

Parametry

źródło

Wartość do sprawdzenia.

cel1

Pierwsza wartość zakresu, z którym ma być porównana wartość źródłowa.

cel2

Druga wartość zakresu, z którym ma być porównana wartość źródłowa.

Wartości zwracane

Wartość true, jeśli wartość źródłowa nie należy do przedziału ustalonego wartościami cel1 i cel2. W przeciwnym razie wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól znajdują się poza określonym przedziałem:

BirtComp.notBetween( row["SprzedażŁącznie"], 10000, 20000 )
BirtComp.notBetween( row["NazwaKlienta"], "A", "M" )
BirtComp.notBetween( row["DataZamówienia"], "2009-01-01", "2009-01-31" )

Następujący przykład pozwala obliczyć daty dostawy. Jeśli wartość DataZamówienia nie wypada w grudniu 2008 r. (czyli między 2008-12-01 i 2008-12-31), do wartości DataZamówienia zostaną dodane trzy dni. Jeśli wartość DataZamówienia wypada w grudniu, do wartości DataZamówienia zostanie dodane pięć dni.

if (BirtComp.notBetween(row["DataZamówienia"], "2008-12-01", "2008-12-31" )){
  dataDostawy = BirtDateTime.addDay( row["DataZamówienia"], 3 )
  }
else{
  dataDostawy = BirtDateTime.addDay( row["DataZamówienia"], 5 )
  }

BirtComp.notEqual

Za pomocą tej funkcji można sprawdzić, czy wartość nie jest równa drugiej wartości.

Składnia

boolean BirtComp.notEqual( źródło, cel )

Parametry

źródło

Pierwsza wartość porównania.

cel

Druga wartość porównania.

Wartości zwracane

Wartość true, jeśli wartość źródłowa nie jest równa wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujące wyrażenia pozwalają sprawdzić, czy wartości pól nie są równe określonym wartościom:

BirtComp.notEqual( row["SprzedażŁącznie"], 10000 )
BirtComp.notEqual( row["Kraj"], "Francja" )
BirtComp.notEqual( row["DataZamówienia"], "2009-02-15" )

BirtComp.notLike

Za pomocą tej funkcji można sprawdzić, czy łańcuch jest niezgodny ze wzorcem. We wzorcu musi być używana składnia dopasowywania wzorca języka SQL.

Składnia

boolean BirtComp.notLike( źródło, cel )

Parametry

źródło

Łańcuch do oceny.

cel

Wzorzec łańcucha używany do porównania. Wzorzec należy ująć w cudzysłów (" "). W trakcie wpisywania znaków, które mają być dopasowane, należy używać liter o odpowiedniej wielkości. We wzorcu można użyć następującego znaku specjalnego:

*
*

Aby uzyskać dopasowanie znaku procentu (%) lub podkreślenia (_), należy poprzedzić te znaki dwoma ukośnikami odwrotnymi (\\). Na przykład aby uzyskać dopasowanie łańcucha S_10, należy użyć następującego wzorca:

S\\_10

Aby uzyskać dopasowanie do łańcucha 50%, należy użyć następującego wzorca:

50\\%

Wartości zwracane

Wartość true, jeśli wartość źródłowa nie jest równa wartości docelowej; w przeciwnym przypadku wartość false.

Przykłady

Następujący przykład zwraca wartość false dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:

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

Następujący przykład zwraca wartość false dla wartości pola nazwaProduktu, które zawierają podłańcuch Ford poprzedzony jednym znakiem:

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

(c) Copyright Actuate Corporation 2013