Fonctions d'expression prises en charge

Les fonctions d'expression décrites dans cette section sont prises en charge et gérées par Monitor Server dans WebSphere Business Monitor.

Les tableaux ci-après recensent toutes les fonctions d'expression qui peuvent être utilisées dans le modèle de mesure métier modélisé et qui sont gérées par Monitor Server pour calculer les valeurs des unités de mesure et des indicateurs clés de performance qui s'afficheront dans les tableaux de bord. Les tableaux contiennent également le comportement de sortie de chaque variation de type de données de la liste d'arguments de la fonction.

absolute-value (com.ibm.btools.expression.absoluteValue)

Liste d'arguments : Long

Variations Sortie
Une valeur longue La valeur absolue de cette valeur longue

Liste d'arguments : Double

Variations Sortie
Une valeur double précision La valeur absolue de cette valeur double précision
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NaN (*)Double.NaN

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

Liste d'arguments : Double

Variations Sortie
Une valeur double précision La valeur de transtypage d'entier de la valeur double précision
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)

Liste d'arguments : Double

Variations Sortie
Une valeur double précision La partie fractionnaire de la valeur double précision
Double.NaN (*)Double.NaN
Double.NEGATIVE_INFINITY (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY

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

Liste d'arguments : Booléen : test, Chaîne : thenTerm, Chaîne : elseTerm

Variations Sortie
Booléen, Chaîne, Chaîne Si test a pour valeur true, thenTerm est renvoyé ; sinon, elseTerm est renvoyé.

Liste d'arguments : booléen : test, double précision : thenTerm, double précision : elseTerm

Variations Sortie
Booléen, Double précision, Double précision Si test a pour valeur true, thenTerm est renvoyé ; sinon, elseTerm est renvoyé.

Liste d'arguments : booléen : test, booléen : thenTerm, booléen : elseTerm

Variations Sortie
Booléen, booléen, booléen Si test a pour valeur true, thenTerm est renvoyé ; sinon, elseTerm est renvoyé.

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

Liste d'arguments : Encapsuleur d'événement : cbe, Chaîne : propertyName

Variations Sortie
Encapsuleur d'événement, Chaîne Vérifie si la propriété donnée se trouve dans le CBE, et si elle est définie. Cette méthode ne renvoie pas la valeur true sauf si la propriété est trouvée et est définie dans le CBE. L'utilisateur doit vérifier si une propriété est définie. Elle peut être associée à un autre chemin si elle n'est pas définie, à l'aide de la fonction if-then-else. Une propriété utilisée dans une expression et non définie dans un événement provoque l'envoi par Monitor Server d'une exception matérielle et la suspension de celui-ci.

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

Liste d'arguments : long : var1, long : var2

Variations Sortie
long, long Renvoie la valeur maximale.

Liste d'arguments : double précision : var1, double précision : var2

Variations Sortie
double, double Renvoie la valeur maximale.

Double.NaN, double

Ou

double, Double.NaN

(*)Renvoie Double.NaN

Double.POSITIVE_INFINITY, double

Ou

double, Double.POSITIVE_INFINITY

(*)Renvoie Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY, Double.NEGATIVE_INFINITY (*)Renvoie Double.NEGATIVE_INFINITY

Double.NEGATIVE_INFINITY, double

Ou

double, Double.NEGATIVE_INFINITY

Renvoie l'autre valeur double précision.

Liste d'arguments : Double précision : var1, long : var2

Variations Sortie
double précision, long Renvoie la valeur maximale.
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 )

Liste d'arguments : long : var1, double précision : var2

Variations Sortie
long, double précision Renvoie la valeur maximale.
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)

Liste d'arguments : long : var1, long : var2

Variations Sortie
long, long Renvoie la valeur minimale.

Liste d'arguments : double précision : var1, double précision : var2

Variations Sortie
précision double, précision double Renvoie la valeur maximale.

Double.NaN, double

Ou

double, Double.NaN

(*)Renvoie Double.NaN

Double.NEGATIVE_INFINITY, double

Ou

double, Double.NEGATIVE_INFINITY

(*)Renvoie Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, Double.POSITIVE_INFINITY (*)Renvoie Double.POSITIVE_INFINITY

Liste d'arguments : Double précision : var1, long : var2

Variations Sortie
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

Liste d'arguments : long : var1, double précision : var2

Variations Sortie
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)

Liste d'arguments : Chaîne : text, Chaîne : subText

Variations Sortie
Chaîne, Chaîne Recherche subText dans le texte et renvoie la valeur true si subText est contenu dans le texte ; sinon, renvoie la valeur false.

"", Chaîne

Ou

Chaîne, ""

false

NULL, Chaîne

Ou

Chaîne, NULL

Emet NullPointerException

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

Liste d'arguments : Chaîne : text, Chaîne : subText

Variations Sortie
Chaîne, Chaîne Si le texte commence par subText, la valeur true est renvoyée ; sinon, la valeur false est renvoyée.
"", Chaîne false
Chaîne, "" true

NULL, Chaîne

Ou

Chaîne, NULL

Emet NullPointerException

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

Liste d'arguments :Chaîne : text

Variations Sortie
Chaîne Renvoie le texte en majuscules.
"" ""
NULL Emet NullPointerException

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

Liste d'arguments :Chaîne : text

Variations Sortie
Chaîne Renvoie le texte en minuscules.
"" ""
NULL Emet NullPointerException

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

Liste d'arguments :Chaîne : s1, Chaîne : s2

Variations Sortie
Chaîne, Chaîne Renvoie s1 + s2
NULL, Chaîne "NULL" + s2
Chaîne, NULL s1 + "NULL"
NULL, NULL "NULLNULL"
"", Chaîne s2
Chaîne, "" s1

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

Liste d'arguments :Encapsuleur d'événement : currentEvent

Variations Sortie
Encapsuleur d'événement Renvoie l'heure de création de l'événement en millisecondes.

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

Liste d'arguments :Encapsuleur d'événement : currentEvent

Variations Sortie
Encapsuleur d'événement Renvoie la date de création de l'événement en millisecondes.

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

Liste d'arguments :Encapsuleur d'événement : currentEvent

Variations Sortie
Encapsuleur d'événement Renvoie la date et l'heure de création de l'événement en millisecondes.

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

Liste d'arguments :Chaîne : list, Chaîne : addedItem, Booléen : duplicate

Variations Sortie
Chaîne, Chaîne, booléen Un élément est ajouté dans une liste d'éléments séparés par des virgule. Si duplicate a pour valeur true, les doublons sont acceptés dans la liste ; sinon, la liste ne les accepte pas.
Chaîne, "", (false ou true) La liste se terminant par une virgule, par exemple, "hhh,kkk,"
"", élément, (false ou true) Une chaîne contenant un élément
"", "",(false ou true) "", chaîne vide
NULL, Chaîne, (false ou true) Une chaîne contenant un élément
Chaîne, NULL, (false ou true) Emet NullPointerException

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

Liste d'arguments :Chaîne : list, Chaîne : removedItem, booléen : allOccurences

Variations Sortie
Chaîne, Chaîne, booléen Supprime un élément de la liste d'éléments séparés par des virgules. Une option permet de définir si toutes les occurrences de la liste doivent être supprimées.
NULL, Chaîne, (false ou true) ""
"", Chaîne, (false ou true) ""
Chaîne, "", (false ou true) Chaîne de la liste
Chaîne, NULL, (false ou true) Emet NullPointerException

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

Liste d'arguments :précision double : number

Variations Sortie
Précision double Renvoie la chaîne du numéro défini.
Double.POSITIVE_INFINITY Infinité
Double.NEGATIVE_INFINITY -Infinité
Double.NaN NaN

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

Liste d'arguments :long : date

Variations Sortie
long Convertit la date définie en une valeur de date-d'heure

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

Liste d'arguments :long : date

Variations Sortie
long La valeur de date-d'heure est tronquée et la date est supprimée. La date tronquée est alors remplacée par des millisecondes.

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

Liste d'arguments :long : date

Variations Sortie
long Convertit la valeur de date/d'heure définie en une valeur d'heure. La date prend la valeur zéro et l'heure est représentée en millisecondes.

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

Liste d'arguments :Chaîne : string

Variations Sortie
Chaîne Renvoie la valeur d'entier de la chaîne de texte définie.
Une chaîne non formatée Emet NumberFormatException
NULL Emet NullPointerException

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

Liste d'arguments :Chaîne : string

Variations Sortie
Chaîne Renvoie le nombre trouvé dans la chaîne sous la forme d'une précision double.
Une chaîne non formatée Emet NumberFormatException
NULL Emet NullPointerException

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

Liste d'arguments :Chaîne : string, Chaîne : format

Variations Sortie
Chaîne, Chaîne Formate la chaîne définie en un format de date. Le format de date du système étant représenté sous forme de valeur longue, cette méthode renvoie une valeur longue.

Chaîne, NULL

Ou

NULL, Chaîne

Emet NullPointerException

Chaîne, ""

Ou

"", ""

Ou

"", Chaîne

Emet ParseException

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

Liste d'arguments :Chaîne : string, Chaîne : format

Variations Sortie
Chaîne, Chaîne Formate la chaîne définie en un format de date ; le format de date du système étant représenté sous forme de valeur longue, cette méthode renvoie une valeur longue.

Chaîne, NULL

Ou

NULL, Chaîne

Emet NullPointerException

Chaîne, ""

Ou

"", ""

Ou

"", Chaîne

Emet ParseException
Important : Cette fonction peut générer une exception IllegalArgumentException. Pour les unités de mesure de modélisation remplies à partir de l'événement, utilisez plutôt la fonction text-to-datetime.

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

Liste d'arguments :Chaîne : string, Chaîne : format

Variations Sortie
Chaîne, Chaîne Formate la chaîne définie en un format de date ; le format de date du système étant représenté sous forme de valeur longue, cette méthode renvoie une valeur longue.

Chaîne, NULL

Ou

NULL, Chaîne

Emet NullPointerException

Chaîne, ""

Ou

"", ""

Ou

"", Chaîne

Emet ParseException

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

Liste d'arguments :Chaîne : string, Chaîne : format

Variations Sortie
Chaîne, Chaîne Formate la chaîne définie en un format de durée. Le format de durée du système étant représenté sous forme de valeur longue, cette méthode renvoie une valeur longue. Le format doit être jjj-hh-mm-ss ; si un autre format est utilisé, une exception NoSuchElementException est générée.
"", Chaîne Emet NoSuchElementException
NULL, Chaîne Emet NullPointerException

Copyright IBM Corporation 2005, 2006. All Rights Reserved.