Referência das Variáveis do Sistema

As variáveis definidas pelo sistema estão disponíveis para serem utilizadas em variáveis.

O sistema define valores automaticamente para as seguintes variáveis em cada etapa de uma tarefa. Essas variáveis são somente leitura. Seus valores para a tarefa estão listados nas linhas ENV do log de etapas. As primeiras quatro são notificações no nível do projeto. Todas as outras variáveis BF_ são utilizadas no nível da etapa.

Variável no Nível do Projeto Valor
BF_D Data. Pode ser utilizada em tags. O formato é determinado pela Tag: configuração do sistema do Formato de Data.
BF_J Dia do ano. Pode ser utilizada em tags.
BF_T Hora. Pode ser utilizada em tags. O formato é determinado pela Tag: configuração do sistema do Formato de Hora.
BF_W Dia da semana, representado por um número de 0 (Domingo) a 6 (Sábado).
Variável no Nível da Etapa Valor
BF_D Data. Pode ser utilizada em tags. O formato é determinado pela Tag: configuração do sistema do Formato de Data.
BF_J Dia do ano. Pode ser utilizada em tags.
BF_T Hora. Pode ser utilizada em tags. O formato é determinado pela Tag: configuração do sistema do Formato de Hora.
BF_W Dia da semana, representado por um número de 0 (Domingo) a 6 (Sábado).
BF_AGENT_PLATFORM Cadeia que identifica a plataforma do sistema operacional na qual o agente está sendo executado.
BF_AGENT_VERSION Número da versão do agente do servidor atual.
t Variável de tag padrão, que começa com 1 e é incrementada para cada tarefa. Pode ser utilizada em tags, que são representadas por BF_TAG.
BF_BID Número do ID da tarefa, exclusivo para tarefas do mesmo projeto.
BF_CALLER_ Prefixo aplicado a variáveis aprovadas em um projeto em cadeia a partir de um projeto de chamada.
BF_CLASS Classe do Build Forge do projeto
BF_ENGINE Uma cadeia que identifica com exclusividade o mecanismo. Esse valor é armazenado também em um arquivo no diretório de instalação: engine.id. Exemplo: D8531015-6C07-1014-8CA0-BD58317220B3.
BF_HOST Nome do host do servidor lógico (nome do host TCP/IP). (Esta variável faz parte do ambiente do servidor.)
BF_ITERATION Número de vezes que uma etapa em um Loop While foi iniciada com êxito. Ele é incrementado quando a Condição para a etapa for avaliada como true. Um reinício de tarefa utiliza o valor dessa variável como a iteração para reiniciar.
BF_ITERATION_MAX Número máximo de vezes que um Loop While pode ser executado. Ele é definido nas propriedades da etapa. Se esse número de iterações for atingido, então BF_ITERATION_MAX_REACHED será definido como Sim.
BF_ITERATION_MAX_REACHED

Não criado ou definido por padrão. O ID exclusivo (BF_SSID) da etapa de Loop While é anexado a esta variável quando iterações de loop While atingem BF_ITERATION_MAX. Se várias etapas do Loop While em um projeto atingirem o BF_ITERATION_MAX, essa variável conterá vários valores, um para cada etapa que atingir o máximo de iterações.

BF_LASTGOODRUN Data da última tarefa aprovada do mesmo projeto ou da última tarefa, se não houver tarefa aprovada.
BF_LASTGOODTAG Tag da última tarefa aprovada (ou da última tarefa, se não houver tarefa armazenada do mesmo projeto).
BF_LASTGOODUNIX Igual a BF_LASTGOODRUN, mas expressa a data no formato UNIX®.
BF_LASTRUN Data da execução anterior da tarefa atual.
BF_LASTTAG Cadeia de tags da tarefa anterior do mesmo projeto.
BF_LASTUNIX Igual a BF_LASTRUN, mas expressa a data no formato UNIX.
BF_ONFAIL Sinalizador de Parada/Continuação para a etapa.
BF_PID Número do ID do projeto.
BF_PROJECTNAME Nome do projeto desta tarefa.
BF_PROJECTNAME_PHYS Nome do projeto, conforme utilizado para criar o diretório do projeto. O sistema altera os caracteres especificados na configuração do sistema Caracteres Inválidos do Diretório Relativo para caracteres sublinhados, para criar o diretório do projeto. Por exemplo, se a configuração incluir um espaço, então um projeto denominado Meu Projeto receberá um diretório do projeto denominado Meu_Projeto.
BF_ROOT Diretório de trabalho de base para a tarefa, tomado das propriedades da tarefa. Consulte também BF_STEP_ROOT.
BF_SERVER O nome do servidor em que a tarefa atual está executando (esta variável faz parte do ambiente do servidor).
BF_SERVER_ROOT Caminho designado para o servidor lógico nas propriedades de servidor (esta variável faz parte do ambiente do servidor).
BF_SID O número de sequência do resultado da etapa dentro da construção.
BF_SPID Contém o ID do projeto de chamada se a tarefa atual foi chamada por outra tarefa. Se nenhum valor for igual a BF_PID.
BF_STEPNAME Nome da etapa. Defina nas propriedades da etapa.
BF_STEP_ROOT Diretório de trabalho de base para a etapa, tomado das propriedades da etapa. Consulte também BF_ROOT.
BF_SSID O ID da etapa, um identificador exclusivo da etapa atual do projeto.
BF_TAG Tag da tarefa. As definições de tag podem conter variáveis. Essa variável contém o valor resultante da interpretação dessas variáveis no momento em que a tarefa é iniciada.
BF_TAG_PHYS Tag da tarefa, com sublinhados que substituem quaisquer espaços que estivessem no valor BF_TAG. Se uma etapa tiver a opção Absoluta selecionada, então BF_TAG_PHYS será igual a BF_TAG.
BF_USER Nome de usuário do proprietário da tarefa.

Feedback