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:
- Cuando se especifica un nombre de grupo, funciona de manera similar al mandato .set.
Establece la variable en el registro maestro en la base de datos, no en la copia utilizada
en el paso actual. El adaptador ejecutándose en el paso actual no es
consciente del cambio. No puede crear nuevas variables de esta
manera.
- Cuando no se especifica un nombre de grupo, funciona como el mandato
.bset. Establece el valor de la variable en el entorno del trabajo de
ejecución. El cambio está disponible para todos los pasos en el trabajo. Puede crear nuevas variables de esta manera.
- Cuando no se especifica el nombre de grupo y se especifica una variable temporal
(type="temp"), establece una variable temporal para que sea utilizada por la lógica del adaptador
únicamente. La variable no persiste una vez se ha ejecutado
el paso del adaptador. Puede crear nuevas variables de esta manera.
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:" />