Utilize o elemento <setenv>para inicializar valores
da variável de ambiente dentro de elementos <interface> ou <match>. O elemento <setenv> não contém outros
elementos.
O elemento pode ser utilizado de três maneiras diferentes:
- Quando você especifica um nome do grupo, ele funciona de forma
semelhante ao comando .set.
Ele configura o valor da variável no registro principal no banco de dados, e
não a cópia utilizada pela etapa atual. A mudança não é vista pelo
adaptador em execução na etapa atual. Você não pode criar variáveis
novas desta maneira.
- Quando você não especifica um nome do grupo, ele funciona como o
comando .bset. Ele configura o valor da variável no ambiente da tarefa
em execução. A mudança fica disponível para todas as etapas na tarefa. É possível criar novas variáveis desta maneira.
- Quando você não especifica o nome do grupo e especifica uma
variável temporária (type="temp"), ele configura uma variável temporária
para o uso apenas da lógica do adaptador. A variável não persiste após a
execução da etapa do adaptador. É possível criar novas variáveis desta maneira.
Atributos:
- condition
- Opcional, na forma condition="function". O valor functioné uma expressão que
avalia como true ou false. Se for avaliada como true, o comando será executado. Se for avaliada como false, ele não será executado.
Consulte o Funções de Condição.
- eval
- Opcional. Configurada como True ou False. Se for true, o adaptador tentará
avaliar a expressão de atributo de valor e armazenar os resultados.
- group
- Opcional. Especifica o ambiente do Build Forge no qual a variável
está definida. Quando especifica um nome de ambiente, você deve se
referir a uma variável existente no ambiente especificado.
Se você
especificar [ADAPTOR] como o valor, o valor será configurado no tempo
de execução.
É configurado para o ambiente da etapa ou link adaptador que chama o
adaptador.
O Build Forge permite variáveis com o mesmo nome em
vários ambientes. A precedência da herança do ambiente e da inclusão
do ambiente pode afetar a forma como se determina o valor a ser designado
à variável no tempo de execução.
- name
- Necessário. Especifica o nome da variável a ser configurada. O valor pode
ser uma variável. Nesse caso, o nome da variável não será configurado até o
tempo de execução.
- type
- Opcional. Especifica o método de configuração da variável. Ele
utiliza um dos seguintes valores:
- append text: coloque o valor especificado após qualquer valor existente. Se o text opcional for especificado, esse texto
será colocado entre os valores.
- once: a variável só deve ser configurada se ainda não tiver sido configurada.
- prepend text: coloque o valor antes de qualquer valor existente.
- temp: a variável só deve ser configurada no contexto do adaptador.
Se o text opcional for especificado, esse texto será colocado entre os valores. Consulte os exemplos abaixo.
- value
- Necessário. É o valor configurado na variável. Pode ser uma
expressão a ser avaliada se o atributo eval também estiver especificado.
O resultado da avaliação é armazenado como o valor.
Exemplos:
O exemplo a seguir avalia a expressão no atributo de valor e
armazena o resultado na variável LAST_VER. Ele é configurado para
o máximo de $LAST_VER ou para o valor na variável $1.
<setenv group="Adaptor" name="LAST_VER"
value="$LAST_VER>$1?$LAST_VER:$1" eval="true" />
O exemplo a seguir insere um caractere de nova linha (\n) antes de
anexar dados à variável Changes:
<setenv name="Changes" value="$4 - $1 - $6" type="temp append\n" />
O exemplo a seguir insere dois pontos após o valor anexado como prefixo à
variável INFOPATH:
<setenv name="INFOPATH" value="/usr/local" type="temp prepend:" />