Podporované výrazové funkce

Zde popsané výrazové funkce jsou podporovány a ovládány komponentou Monitor Server v produktu WebSphere Business Monitor.

Výčet v následujících tabulkách zahrnuje veškeré výrazové funkce, které lze použít pro modelovaný model obchodních ukazatelů a které jsou ovládány komponentou Monitor Server tak, aby prováděly výpočet hodnot metriky a KPI, které budou zobrazeny v komponentě Dashboards. Tabulky rovněž uvádějí výstupní chování každého druhu datových typů uvedeného v seznamu argumentů funkcí.

absolutní hodnota (com.ibm.btools.expression.absoluteValue)

Seznam argumentů: Dlouhý

Odchylky Výstup
Hodnota typu Dlouhý Absolutní hodnota této hodnoty typu Dlouhý

Seznam argumentů: Double (Dvojitý)

Odchylky Výstup
Hodnota typu Dvojitý Absolutní hodnota této hodnoty typu Dvojitý
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NaN (*)Double.NaN

integer-part (com.ibm.btools.expression.integerValue)

Seznam argumentů: Double (Dvojitý)

Odchylky Výstup
Hodnota typu Dvojitý Celé číslo přetypuje hodnotu typu Dvojitý
Double.NaN 0
Double.MAX_VALUE Integer.MAX_VALUE
Double.MIN_VALUE 0
Double.NEGATIVE_INFINITY Integer.MIN_VALUE
Double.POSITIVE_INFINITY Integer.MAX_VALUE

decimal-part (com.ibm.btools.expression.fractionalValue)

Seznam argumentů: Double (Dvojitý)

Odchylky Výstup
Hodnota typu Dvojitý Zlomková část hodnoty typu double
Double.NaN (*)Double.NaN
Double.NEGATIVE_INFINITY (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY

if-then-else (com.ibm.btools.expression.ifthenelse)

Seznam argumentů: bBoolean: test, String: thenTerm, String: elseTerm

Odchylky Výstup
Boolean, String, String Jestliže test je true, vráceno thenTerm; jinak je vráceno elseTerm.

Seznam argumentů: boolean: test, double: thenTerm, double: elseTerm

Odchylky Výstup
Boolean, double, double Jestliže test je true, vráceno thenTerm; jinak je vráceno elseTerm.

Seznam argumentů: boolean: test, boolean: thenTerm, boolean: elseTerm

Odchylky Výstup
Boolean, boolean, boolean Jestliže test je true, vráceno thenTerm; jinak je vráceno elseTerm.

attribute-is-set (com.ibm.btools.expression.bom.ome.isSet)

Seznam argumentů: EventWrapper: cbe, String: propertyName

Odchylky Výstup
EventWrapper, String Ověřuje, zda se daná vlastnost nalézá v CBE, a jestliže je nalezena, ověří, zda je nastavena. Tato metoda nevrátí true, pokud vlastnost není nalezena a nastavena v CBE. Uživatel musí zkontrolovat, zda-li je vlastnost nastavena. Pokud není nastavena pomocí funkce if-then else, může k ní vést alternativní cesta. Vlastnost použitá ve výrazu, ale nenastavená v událostech způsobí, že komponenta Monitor Server vyhodí trvalou výjimku a jeho činnost se pozastaví.

greater-value (com.ibm.btools.expression.maxValue)

Seznam argumentů: long: var1, long: var2

Odchylky Výstup
long, long Vrací maximální hodnotu.

Seznam argumentů: double: var1, double: var2

Odchylky Výstup
double, double Vrací maximální hodnotu.

Double.NaN, double

nebo

double, Double.NaN

(*)Vrací Double.NaN

Double.POSITIVE_INFINITY, double

nebo

double, Double.POSITIVE_INFINITY

(*)Vrací Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY, Double.NEGATIVE_INFINITY (*)Vrací Double.NEGATIVE_INFINITY

Double.NEGATIVE_INFINITY, double

nebo

double, Double.NEGATIVE_INFINITY

Vrací další hodnotu typu double.

Seznam argumentů: Double: var1, long: var2

Odchylky Výstup
double, long Vrací maximální hodnotu.
Double.POSITIVE_INFINITY, long (*)Double.POSITIVE_INFINITY
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, Long.MAX_VALUE ( (double) Long.MAX_VALUE )
Double.NEGATIVE_INFINITY, Long.MIN_VALUE ( (double) Long.MIN_VALUE )

Seznam argumentů: long: var1, double: var2

Odchylky Výstup
long, double Vrací maximální hodnotu.
long, Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
long, Double.NaN (*)Double.NaN
Long.MAX_VALUE, Double.NEGATIVE_INFINITY ((double) Long.MAX_VALUE)
Long.MIN_VALUE, Double.NEGATIVE_INFINITY ((double) Long.MIN_VALUE)

lesser-value (com.ibm.btools.expression.minValue)

Seznam argumentů: long: var1, long: var2

Odchylky Výstup
long, long Vrací minimální hodnotu.

Seznam argumentů: double: var1, double: var2

Odchylky Výstup
double, double Vrací maximální hodnotu.

Double.NaN, double

nebo

double, Double.NaN

(*)Vrací Double.NaN

Double.NEGATIVE_INFINITY, double

nebo

double, Double.NEGATIVE_INFINITY

(*)Vrací Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, Double.POSITIVE_INFINITY (*)Vrací Double.POSITIVE_INFINITY

Seznam argumentů: Double: var1, long: var2

Odchylky Výstup
Double.MIN_VALUE, Long.MIN_VALUE ( (double) Long.MIN_VALUE )
Double.MAX_VALUE, Long.MAX_VALUE ( (double) Long.MAX_VALUE )
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, long (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, long (double) long

Seznam argumentů: long: var1, double: var2

Odchylky Výstup
Double.MIN_VALUE, Long.MIN_VALUE ( (double) Long.MIN_VALUE )
Double.MAX_VALUE, Long.MAX_VALUE ( (double) Long.MAX_VALUE )
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, long (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, long (double) long

includes-specified-text (com.ibm.btools.expression.containsText)

Seznam argumentů: String: text, String: subText

Odchylky Výstup
String, String Vyhledá subText v textu a vrátí hodnotu true, jestliže je subText obsažen v daném textu; jinak vrátí false.

"", String

nebo

String, ""

false

null, String

nebo

String, null

Vyhodí NullPointerException

starts-with-specified-text (com.ibm.btools.expression.startsWithText)

Seznam argumentů: String: text, String: subText

Odchylky Výstup
String, String Pokud text začíná subText, vrátí se true; jinak se vrátí false.
"", String false
String, "" true

null, String

nebo

String, null

Vyhodí NullPointerException

to-uppercase (com.ibm.btools.expression.toUpperCase)

Seznam argumentů:String: text

Odchylky Výstup
String Vrací text velkými písmeny.
"" ""
null Vyhodí NullPointerException

to-lowercase (com.ibm.btools.expression.toLowerCase)

Seznam argumentů:String: text

Odchylky Výstup
String Vrací text malými písmeny.
"" ""
null Vyhodí NullPointerException

Concatenate (com.ibm.btools.expression.concat )

Seznam argumentů:String: s1, String: s2

Odchylky Výstup
String, String Vrací s1 + s2
null, String "null" + s2
String, null s1 + "null"
null, null "nullnull"
"", String s2
String, "" s1

current-event-creation-time (com.ibm.btools.expression.currentTime)

Seznam argumentů:EventWrapper: currentEvent

Odchylky Výstup
EventWrapper Vrací čas vytvoření události v milisekundách.

current-event-creation-date (com.ibm.btools.expression.currentTime)

Seznam argumentů:EventWrapper: currentEvent

Odchylky Výstup
EventWrapper Vrací datum vytvoření události v milisekundách.

current-event-creation-datetime (com.ibm.btools.expression.currentTime)

Seznam argumentů:EventWrapper: currentEvent

Odchylky Výstup
EventWrapper Vrací datum a čas vytvoření události v milisekundách.

Add-To-String-List (com.ibm.btools.expression.bom.ome.addToList)

Seznam argumentů:String: list, String: addedItem, Boolean: duplicate

Odchylky Výstup
String, String, boolean Prvek je přidán do seznamu prvků oddělených čárkami. Pokud je duplikát true, je přijat do seznamu; v ostatních případech seznam duplikáty nepřijme.
String, "", (false nebo true) Seznam s čárkou na konci, např. "hhh,kkk,"
"", prvek, (false nebo true) Řetězec obsahující prvek
"", "",(false nebo true) "", prázdný řetězec
null, String, (false nebo true) Řetězec obsahující prvek
String, null, (false nebo true) Vyhodí NullPointerException

Remove-From-String-List (com.ibm.btools.expression.bom.ome.removeFromList.string)

Seznam argumentů:String: list, String: removedItem, boolean: allOccurences

Odchylky Výstup
String, String, boolean Odebere prvek ze seznamu prvků oddělených čárkami. Lze zvolit možnost odebrat všechny výskyty v daném seznamu.
null, String, (false nebo true) ""
"", String, (false nebo true) ""
String, "", (false nebo true) Řetězec seznamu
String, null, (false nebo true) Vyhodí NullPointerException

number-to-text (com.ibm.btools.expression.bom.ome.numberToString)

Seznam argumentů:double: number

Odchylky Výstup
Double Vrací řetězec daného čísla
Double.POSITIVE_INFINITY Nekonečno
Double.NEGATIVE_INFINITY -Nekonečno
Double.NaN NaN

date-to-datetime (com.ibm.btools.expression.bom.ome.dateToDateTime)

Seznam argumentů:long: date

Odchylky Výstup
long Převede dané datum na datum/čas.

datetime-to-date (com.ibm.btools.expression.bom.ome.dateTimeToDate)

Seznam argumentů:long: date

Odchylky Výstup
long Datum/čas bude zkrácen odebráním data. Zkrácený datový údaj je pak převedeno na milisekundy.

datetime-to-time (com.ibm.btools.expression.dateTimeToTime)

Seznam argumentů:long: date

Odchylky Výstup
long Převádí dané datum/čas na čas. Nastaví hodnotu data na nulu, čas je vyjádřen v milisekundách.

text-to-integer (com.ibm.btools.expression.bom.ome.textToInteger)

Seznam argumentů:String: string

Odchylky Výstup
String Vrací hodnotu typu Celé číslo daného textu řetězce.
Neformátovaný řetězec Vyhodí NumberFormatException
null Vyhodí NullPointerException

text-to-number (com.ibm.btools.expression.bom.ome.stringToNumber)

Seznam argumentů:String: string

Odchylky Výstup
String Vrací číslo nalezené v řetězci ve formě double (Dvojitý).
Neformátovaný řetězec Vyhodí NumberFormatException
null Vyhodí NullPointerException

text-to-date (com.ibm.btools.expression.bom.ome.stringToDate)

Seznam argumentů:String: string, String: format

Odchylky Výstup
String, String Naformátuje daný řetězec do formátu Datum. Jelikož je formát Datum v systému vyjádřen jako Dlouhý, vrací tato metoda typ Dlouhý (long).

String, null

nebo

null, String

Vyhodí NullPointerException

String, ""

nebo

"", ""

nebo

"", String

Vyhodí ParseException

text-to-time (com.ibm.btools.expression.bom.ome.stringToTime)

Seznam argumentů:String: string, String: format

Odchylky Výstup
String, String Naformátuje daný řetězec do formátu Datum; jelikož je formát Datum v systému vyjádřen jako typ Dlouhý (long), vrací tato metoda typ Dlouhý.

String, null

nebo

null, String

Vyhodí NullPointerException

String, ""

nebo

"", ""

nebo

"", String

Vyhodí ParseException
Důležité: Tato funkce může způsobit výjimku IllegalArgumentException. Při modelování metriky, která je plněna z události, použijte místo toho funkci text-to-datetime.

text-to-datetime (com.ibm.btools.expression.bom.ome.stringToDateTime)

Seznam argumentů:String: string, String: format

Odchylky Výstup
String, String Naformátuje daný řetězec do formátu Datum; jelikož je formát Datum v systému vyjádřen jako typ Dlouhý (long), vrací tato metoda typ Dlouhý.

String, null

nebo

null, String

Vyhodí NullPointerException

String, ""

nebo

"", ""

nebo

"", String

Vyhodí ParseException

text-to-duration (com.ibm.btools.expression.stringToDuration)

Seznam argumentů:String: string, String: format

Odchylky Výstup
String, String Naformátuje daný řetězec do formátu Trvání. Jelikož je formát Trvání v systému vyjádřen jako typ Dlouhý (long), vrací tato metoda typ Dlouhý. Formát musí být uveden jako dddd-hh-mm-ss; pokud je uveden v jiném tvaru, dojde k výjimce NoSuchElementException.
"", String Vyhodí NoSuchElementException
null, String Vyhodí NullPointerException

Copyright IBM Corporation 2005, 2006. Všechna práva vyhrazena.