Um elemento <run> é utilizado dentro de um elemento <interface>
para especificar um comando nomeado a ser executado. O comando é definido posteriormente no mesmo
arquivo XML. O elemento <run> é um elemento vazio.
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.
- command
- Necessário. Especifica o nome de um comando definido para execução. O comando é nomeado e definido em um elemento <command>.
- dir
- Necessário. Especifica o diretório no qual o comando deve ser executado.
O dir é interpretado como uma extensão do caminho configurado no recurso do
servidor no qual o comando é executado.
- mode
- Opcional. Especifica o modo de execução para o comando run. Ele pode ser um dos seguintes:
- conjoined: todas as chamadas para o comando são agrupadas em uma chamada para
processo do servidor.
- parallel: as chamadas são processadas individualmente, à medida que os slots do servidor se tornam
disponíveis.
- exec: os comandos são iniciados e processados imediatamente pelo servidor.
- params
- Necessário. Especifica parâmetros a serem transmitidos para o comando. Utilize
espaços para separar os parâmetros.
- Servidor
- Necessário. Especifica o recurso do servidor no qual o comando deve
ser executado. Se estiver configurado como nulo, o comando será executado
no servidor utilizado pela etapa que executa o adaptador. Utilize server=""
para configurar o servidor como nulo.
- timeout
- Necessário. Especifica quantos segundos antes do comando expirar.
Exemplo mostrando os atributos necessários:
<run command="UpdateEnv" params="" server="" dir="/" timeout="360"/>
Exemplo:
<run command="p4_changes" params="$LAST_RUN $FILESPEC $LAST_VER"
server="$P4CLIENT" dir="/" timeout="360"/>