Funções de condição são utilizadas na propriedade de etapa
Condição e no atributo de condição nos elementos XML do adaptador.
- Para etapas que utilizam a propriedade Condição: Se as seguintes funções
forem utilizadas no início do campo Condição, elas serão avaliadas pelo
mecanismo e nenhuma informação será enviada para o servidor selecionado,
a menos que a condição seja avaliada como true. A etapa será executada no servidor selecionado
se a condição for avaliada como verdadeira.
Importante: - Não
tente utilizar as funções em variáveis que são configuradas no ambiente shell do
recurso do servidor. A avaliação acontece no mecanismo Build Forge, portanto,
elas só funcionam em variáveis que são definidas no ambiente do Build Forge
para a etapa.
- Não use caracteres de operador nas sequências que são avaliadas.
Os caracteres de operador são =, <, >, !
- Para modelos de adaptador: as funções a seguir estão disponíveis para
uso em elementos XML do adaptador que têm um atributo de condição. Elas
são usadas para especificar como o adaptador é executado. Importante:
a função de condição deve estar entre aspas duplas no atributo de condição: condition="condition_function".
As funções a seguir estão disponíveis:
- true(expression)
- Retorna true se expression for true.
- false(expression)
- Retorna true se a expressão for falsa.
- contains(a,b)
- Retorna true se a sequência a contiver a sequência b. Os parâmetros a e b podem ser sequências literais ou variáveis. As cadeias literais não devem estar entre aspas. Se as cadeias literais estiverem entre aspas,
as aspas se tornarão parte da cadeia que é avaliada.
Nota: Antes do Rational Build Forge versão 7.1.2, essa função retornaria true se a sequência a estivesse na sequência b.
- hastext(var)
- Retorna true se a variável não estiver vazia. Var é uma variável
configurada no Build Forge.
- isempty(var)
- Retorna true se a variável estiver vazia. Var é uma variável
configurada no Build Forge.
- a eq b
- Retorna true se a for igual a b. Os parâmetros
a e b podem ser variáveis configuradas no Build Forge
ou valores literais. Tipos numéricos e de caracteres podem ser
utilizados. Use um espaço entre os parâmetros e o operador.
- a neb
- Retorna true se a não for igual a b. Os parâmetros a e b podem ser variáveis
definidas dentro do Build Forge ou dos valores literais. Tipos numéricos e de caracteres podem ser
utilizados. Tipos numéricos e de caracteres podem ser
utilizados. Use um espaço entre os parâmetros e o operador.
- a contains b
- Retorna true se a cadeia b for localizada na cadeia a. Cadeias
literais não devem estar entre aspas. Se as cadeias literais estiverem entre aspas, as aspas se tornarão parte da cadeia que é avaliada. Tipos numéricos e de caracteres podem ser
utilizados. Use um espaço entre os parâmetros e o operador.
Expressões em Funções
O parâmetro
expression
das funções true() e false() pode utilizar os seguintes operadores:
- a==b
- Testa a igualdade. Parâmetros podem ser sequências ou números. Parâmetros podem ser literais ou variáveis definidos no Build Forge.
- a eq b
- Testa a igualdade. Parâmetros podem ser sequências ou números. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Use um espaço entre os parâmetros e o operador.
- a!=b
- Testa a desigualdade. Parâmetros podem ser sequências ou números. Parâmetros podem ser literais ou variáveis definidos no Build Forge.
- a neb
- Testa a desigualdade. Parâmetros podem ser sequências ou números. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Use um espaço entre os parâmetros e o operador.
- a>b
- Testa se a é maior que b. Parâmetros devem ser
numéricos. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Literais podem utilizar operadores
aritméticos, por exemplo, 2+2.
- a<b
- Testa se a não é maior que b. Parâmetros
devem ser numéricos. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Literais podem utilizar operadores
aritméticos, por exemplo, 2+2.
- a>=b
- Testa se a é maior ou igual a b. Parâmetros devem ser
numéricos. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Literais podem utilizar operadores
aritméticos, por exemplo, 2+2.
- a<=b
- Testa se a não é maior ou igual a b. Parâmetros devem ser
numéricos. Parâmetros podem ser literais ou variáveis definidos no Build Forge. Literais podem utilizar operadores
aritméticos, por exemplo, 2+2.
- a contains b
- Testa se a cadeia b é localizada na cadeia a. Parâmetros
podem ser literais ou variáveis definidas no Build Forge. As cadeias literais não devem estar entre aspas.
Exemplos de Funções de Condição
Nos exemplos
na tabela abaixo, variáveis são configuradas da seguinte forma:
- $AVAL contém o valor String.
- $BVAL contém o valor 3.
Condição |
Avaliada como |
Observações |
A String contains $AVAL |
TRUE |
Comparação de cadeia |
A String contains "String" |
FALSE |
As aspas ao redor de String tornam-se parte da comparação. |
true(A String contains $AVAL) |
TRUE |
Comparação de cadeia |
$AVAL contains String |
TRUE |
Comparação de cadeia |
$AVAL contains "String" |
FALSE |
As aspas ao redor de String tornam-se parte da comparação. |
contains(A String,$AVAL) |
TRUE |
Comparação de cadeia |
true(A String contains "$AVAL") |
FALSE |
As aspas ao redor de $AVAL tornam-se parte da comparação; "A
String" não têm aspas ao redor da parte "String". |
A String != $AVAL |
TRUE |
Comparação de cadeia |
A String ne $AVAL |
TRUE |
Comparação de cadeia |
false("Not Here" contains $AVAL) |
TRUE |
Testar comparação de sequência |
true(2+1 == $BVAL) |
TRUE |
Expressão numérica de igualdade |
false(2+2 < $BVAL) |
TRUE |
Expressão numérica de desigualdade |
$AVAL eq $AVAL |
TRUE |
Testar comparação de sequência |
true($AVAL ne Linus) |
TRUE |
Testar comparação de sequência |
true($BVAL > 2+2) |
FALSE |
(3 > 2+2) não é true |
contains(Not Here, $AVAL) |
FALSE |
Testar comparação de sequência |