Las funciones de condición se utilizan en la propiedad de paso Condición
y en el atributo condition en los elementos XML del adaptador.
- Para aquellos pasos que utilicen la propiedad Condición: si las siguientes funciones se utilizan
en la parte inicial del campo Condición, serán evaluadas por el
motor y no se enviará ninguna información al servidor seleccionado a no ser que la condición
sea cierta. El paso se ejecuta en el servidor seleccionado
si la condición es cierta.
Importante: - No intente utilizar las funciones en variables establecidas
en el entorno de shell en el recurso de servidor. La evaluación tiene lugar en el motor
de Build Forge, por lo que sólo funcionan en variables definidas en el entorno
de Build Forge del paso.
- No utilice caracteres de operador en series que están evaluadas.
Los caracteres de operador son =, <, >, !
- Para plantillas de adaptador: las siguientes funciones están disponibles para ser utilizadas
en elementos XML del adaptador con un atributo de condición. Se utilizan para especificar
cómo se ejecuta el adaptador. Importante: la función de
condición debe encerrarse entre comillas en el atributo condition:
condition="función_condición".
Las siguientes funciones están disponibles:
- true(expresión)
- Devuelve true si la expresión es verdadera.
- false(expresión)
- Devuelve true si la expresión es falsa.
- contains(a,b)
- Devuelve true si la serie a contiene la serie b. Los parámetros a y b
pueden ser series literales o variables. Las series literales no deben ir rodeadas
entre comillas. Si las series literales se rodean de comillas, las comillas pasarán a formar parte
de la serie evaluada.
Nota: Antes de la versión 7.1.2 de Rational Build Forge,
esta función devolvía true si la serie a estaba en la serie b.
- hastext(var)
- Devuelve true si la variable no está vacía. Var es una variable
definida dentro de Build Forge.
- isempty(var)
- Devuelve true si la variable está vacía. Var es una variable
definida dentro de Build Forge.
- a eq b
- Devuelve true si a es igual a b. Los parámetros a y b
pueden ser variables definidas dentro de Build Forge o valores literales. Pueden utilizarse tipos de caracteres
y números. Utilice un espacio entre los parámetros y el operador.
- a ne b
- Devuelve true si a no es igual a b. Los parámetros
a y b pueden ser variables definidas dentro de Build
Forge o valores literales. Pueden utilizarse tipos de caracteres
y números. Pueden utilizarse tipos de caracteres
y números. Utilice un espacio entre los parámetros y el operador.
- a contains b
- Devuelve true si se encuentra la serie b en la series a. Las series
literales no deben rodearse de comillas. Si las series literales se rodean de comillas, las comillas pasarán a formar parte
de la serie evaluada. Pueden utilizarse tipos de caracteres
y números. Utilice un espacio entre los parámetros y el operador.
Expresiones en funciones
El parámetro
Expresión
de las funciones true() y false() puede utilizar los siguientes operadores:
- a==b
- Prueba igualdad. Los parámetros pueden ser series o números. Los parámetros pueden ser literales
o variables definidas en Build Forge.
- a eq b
- Prueba igualdad. Los parámetros pueden ser series o números. Los parámetros pueden ser literales
o variables definidas en Build Forge. Utilice un espacio entre los parámetros y el operador.
- a!=b
- Prueba la no igualdad. Los parámetros pueden ser series o números. Los parámetros pueden ser literales
o variables definidas en Build Forge.
- a ne b
- Prueba la no igualdad. Los parámetros pueden ser series o números. Los parámetros pueden ser literales
o variables definidas en Build Forge. Utilice un espacio entre los parámetros y el operador.
- a>b
- Prueba que a sea mayor que b. Los parámetros deben
ser numéricos. Los parámetros pueden ser literales
o variables definidas en Build Forge. Los literales pueden utilizar operadores aritméticos como, por ejemplo, 2+2.
- a<b
- Prueba que a no sea mayor que b. Los parámetros deben
ser numéricos. Los parámetros pueden ser literales
o variables definidas en Build Forge. Los literales pueden utilizar operadores aritméticos como, por ejemplo, 2+2.
- a>=b
- Prueba que a sea mayor o igual que b. Los parámetros deben ser numéricos. Los parámetros pueden ser literales
o variables definidas en Build Forge. Los literales pueden utilizar operadores aritméticos como, por ejemplo, 2+2.
- a<=b
- Prueba que a no sea mayor o igual que b. Los parámetros deben ser numéricos. Los parámetros pueden ser literales
o variables definidas en Build Forge. Los literales pueden utilizar operadores aritméticos como, por ejemplo, 2+2.
- a contains b
- Prueba que la serie b esté en la serie a. Los parámetros pueden ser
literales o variables definidas en Build Forge. Las series literales no deben ir rodeadas
entre comillas.
Ejemplos de funciones Condition.
En los ejemplos en la siguiente
tabla, las variables se definen como sigue:
- $AVAL contiene el valor Serie.
- $BVAL contiene el valor 3.
Condición |
Resulta en |
Notas |
Una serie contains $AVAL |
TRUE |
Comparación de serie |
Una serie contains "Serie" |
FALSE |
Las comillas alrededor de Serie se convierten en parte de la comparación. |
true(Una serie contains $AVAL) |
TRUE |
Comparación de serie |
$AVAL contains Serie |
TRUE |
Comparación de serie |
$AVAL contains "Serie" |
FALSE |
Las comillas alrededor de Serie se convierten en parte de la comparación. |
contains(Una serie,$AVAL) |
TRUE |
Comparación de serie |
true(Una serie contains "$AVAL") |
FALSE |
Las comillas alrededor de $AVAL se convierten en parte de la
comparación; "Una serie" no tiene comillas alrededor de la parte
"Serie". |
Una serie != $AVAL |
TRUE |
Comparación de serie |
Una serie ne $AVAL |
TRUE |
Comparación de serie |
false("Not Here" contains $AVAL) |
TRUE |
Comparación de la serie de prueba |
true(2+1 == $BVAL) |
TRUE |
Expresión numérica de igualdad |
false(2+2 < $BVAL) |
TRUE |
Expresión numérica de no igualdad |
$AVAL eq $AVAL |
TRUE |
Comparación de la serie de prueba |
true($AVAL ne Linus) |
TRUE |
Comparación de la serie de prueba |
true($BVAL > 2+2) |
FALSE |
(3 > 2+2) is not true |
contains(Not Here, $AVAL) |
FALSE |
Comparación de la serie de prueba |