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. |