setenv

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:

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:" />

Feedback