setenv

Utilice el elemento <setenv>para inicializar valores de variables de entorno dentro de elementos <interface> o <match>. El elemento <setenv> no contiene otros elementos.

El elemento puede utilizarse de tres maneras distintas:

Atributos:

condition
Opcional, en el formato condition="función". El valor de función es una expresión que evalúa si el mandato es verdadero o falso. Si lo evalúa como verdadero, se ejecutará el mandato. Si lo evalúa como falso, no se ejecutará. Consulte el apartado Funciones de condición.
eval
Opcional. Establecido en True o False. Si es verdadero, el adaptador intentará evaluar la expresión de atributo de valor y almacenar los resultados.
group
Opcional. Especifica el entorno de Build Forge en que está definida la variable. Cuando especifique un nombre de entorno, deberá hacer referencia a una variable existente dentro del entorno especificado.

Si especifica [ADAPTOR] como el valor, el valor será ejecutado durante la ejecución. Está establecido en el paso o enlace del adaptador que llama al adaptador.

Build Forge permite variables del mismo nombre en varios entornos. La precedencia de la herencia de entorno y la inclusión de entorno pueden afectar al modo en que se determina el valor que asignar a una variable durante el tiempo de ejecución.

name
Necesario. Especifica el nombre de la variable que será establecida. El valor puede ser una variable. En tal caso, el nombre de la variable no será establecido hasta la ejecución.
type
Opcional. Especifica el método de establecer la variable. Toma uno de los siguientes valores:
  • append texto: coloca el valor especificado después de cualquier valor existente. Si se especifica el texto opcional, dicho texto será colocado entre los valores.
  • once: la variable debe establecerse sólo una vez si ya no está establecida.
  • prepend texto: coloque el valor antes de cualquier valor existente.
  • temp: la variable sólo debe establecerse en el contexto del adaptador. Si se especifica el texto opcional, dicho texto será colocado entre los valores. Consulte los siguientes ejemplos.
value
Necesario. Es el valor de la variable. Puede ser una expresión que evaluar si el atributo eval también se ha especificado. El resultado de la evaluación se almacena como el valor.

Ejemplos:

El siguiente ejemplo evalúa la expresión en el atributo value y almacena el resultado en la variable LAST_VER. Está establecido en el mayor de $LAST_VER o en el valor de la variable $1.

<setenv group="Adaptor" name="LAST_VER" 
   value="$LAST_VER>$1?$LAST_VER:$1" eval="true" />
El siguiente ejemplo inserta un carácter de nueva línea (\n) antes de añadir datos a la variable Changes:
<setenv name="Changes" value="$4 - $1 - $6" type="temp append\n" />

El siguiente ejemplo inserta dos puntos después del valor que añade a la variable INFOPATH:

<setenv name="INFOPATH" value="/usr/local" type="temp prepend:" />

Comentarios