Sobre o Painel Ambientes

Use o painel Ambientes para criar e gerenciar ambientes para seus projetos. Para visualizar o painel, selecione Ambientes.

Lista de ambientes mostrados no painel Ambientes

No painel Ambientes, você pode também clicar em um ambiente para exibir e editar suas variáveis.

Guia Detalhes

Propriedades de Ambiente

Especifique as seguintes propriedades de ambiente:

Nome
O nome para o ambiente.
Acesso
O grupo de acesso de usuários que podem usar esse ambiente.

Propriedades da Variável

No painel Ambientes, selecione uma variável para visualizar o painel Variáveis. Use o painel Variáveis para especificar as seguintes propriedades:

Nome
Nomes de variáveis podem utilizar apenas caracteres alfanuméricos (a-z, A-Z, 0-9) e o caractere de sublinhado ( _ ) em um nome. O comprimento máximo é de 255 bytes:
  • Conjuntos de caracteres de byte único: 255 caracteres
  • Conjuntos de caracteres de byte duplo: 127 caracteres
Valor
Os valores de variáveis têm as seguintes características:
  • Comprimento: Os valores podem ter qualquer comprimento (até o limite do sistema operacional, se houver um).
  • Caracteres especiais: Os caracteres %, $, [, ], {, }, \, " e ' têm significados especiais para o pré-analisador (antes da avaliação do SO) e para avaliação no sistema operacional. Evite utilizá-los. Salve-os com uma barra invertida (\) para transmiti-los. Consulte o Interpretação de Variáveis em Etapas.

    Se um valor estiver entre aspas simples, os nomes das variáveis são passados como literais ao invés de interpretados. Por exemplo, uma designação de variável MyEnv='$env' faz com que a cadeia $env seja designada como MyEnv, ao invés do valor da variável $env.

  • Variáveis nos valores: Se uma variável estiver em um valor de variável, essa variável será interpretada quando uma etapa usando a variável for executada.
  • Valores suspensos: Para especificar itens para uma variável suspensa, configure o tipo de variável como Lista Suspensa, salve a variável e depois edite. Clique na guia Opções Suspensas para incluir itens na lista suspensa. Consulte o Criando Pull-downs para uma Variável.
  • Comandos com ponto como valores: Alguns comandos com pontos podem ser utilizados como o valor de uma variável de ambiente; nesses casos, o sistema substitui o comando com ponto por outros valores. Consulte o Utilizando Comandos com Ponto em Variáveis.
  • Retornos de linha: As variáveis não armazenam retornos de linha. Você pode designar um valor de várias linhas a uma variável, conforme mostrado no seguinte exemplo. O conteúdo do arquivo text.txt é designado à variável test:
    .bset env "test = `type text.txt`"
    As linhas do arquivo são concatenadas. Por exemplo, suponha que o conteúdo do arquivo fosse o seguinte:
    Primeira linha
    E segunda linha
    O valor a variável se torna o seguinte:
    Primeira linha E segunda linha
Tipo
As variáveis são designadas a um destes tipos:
  • Padrão - O padrão. A variável pode ter um valor e uma ação designada.
  • Inclusão - O valor da variável aponta para outro ambiente para inclusão. Todas as variáveis do ambiente são incluídas.
    Nota: O tipo de variável Incluir substitui a funcionalidade .include fornecida em liberações anteriores.
  • Lista Suspensa - A variável contém um conjunto de valores entre os quais os usuários podem escolher. Depois que uma variável da lista suspensa for criada, será possível selecioná-la e clicar na guia Opções Suspensas para incluir valores.
Ação

Uma das seguintes:

  • Definida: A opção padrão. O valor especificado é designado para a variável. A variável é criada se ela ainda não existir.
  • Definida se não definida: Essa ação designa o valor para a variável somente se a variável ainda não tiver um valor. Consulte o Sobre Variáveis.
  • Anexar: O valor é anexado ao valor atual para a variável. O delimitador PATH específico do SO é incluído entre os valores:
    • Windows: ponto e vírgula (;)
    • UNIX ou Linux: dois pontos (:)
  • Pré-anexar: O valor é inserido na frente do valor atual. O delimitador PATH específico do SO é incluído entre os valores:
    • Windows: ponto e vírgula (;)
    • UNIX ou Linux: dois pontos (:)
  • Limpar: O valor é configurado para uma sequência vazia. Se a propriedade Valor contiver um valor, ele não será utilizado.
  • Excluir/Não Configurado: A variável é excluída do ambiente aplicado atual. Se a propriedade Valor contiver um valor, ele não será utilizado.
  • Designar Oculto: O valor é criptografado no banco de dados e exibido como "*****" nos logs e interface com o usuário. Use essa opção para armazenar informações confidenciais.

    As variáveis Designar Oculto são protegidas contra edição, por padrão. Se você não tiver a permissão Editar Tags Ocultas configurada, não será possível editar esses valores. No entanto, é possível excluí-los e recriá-los se as permissões estiverem configuradas. Se a permissão Editar Tags Ocultas estiver configurada, os valores poderão ser editados e depois inseridos para uso. Esse comportamento evita que você exiba o valor de uma variável Designar Oculto alterando seu tipo para Configurado.

    Se o valor de Ação da variável de ambiente for Designar Oculto, os valores de Tipo e Ação da variável não poderão ser alterados. Se o valor de ação da variável de ambiente não for Designar Oculto, não será possível alterar a Ação para Designar Oculto.

    A variável de ambiente Assign Hidden não pode funcionar com o agente 7.1.x. Se desejar usar as variáveis de ambiente Assign Hidden, atualize o agente para a versão correspondente. Por exemplo, se a versão do console for 8.0.0.1, atualize a versão do agente para 8.0.0.1.

    Nota: O aumento do comprimento do seu valor o deixará mais seguro.
    Nota: Se você tiver variáveis ocultas designadas anteriores, é possível editá-las e salvá-las novamente para criptografá-las na página Ambientes da interface com o usuário do Build Forge. Você também tem a opção de criptografar no modo em lote usando o utilitário bfassignhiddenmigration. A instalação do Build Forge 8.0 não alterará os valores ocultos designados. Se você não salvou novamente ou atualizou o valor das variáveis ocultas designadas anteriores a partir da liberação Build Forge 7.x, não será possível usar o novo recurso oculto designado. O comportamento é idêntico ao uso do mecanismo Perl na liberação 7.x, mas o valor oculto designado é apresentado como texto não criptografado nos novos logs da etapa do mecanismo Java™. É recomendado salvar novamente os valores ocultos designados anteriores ou usar o utilitário bfassignhiddenmigration para criptografar todos os valores ocultos designados. Para obter mais informações sobre o utilitário bfassignhiddenmigration, consulte o tópico Referência bfassignhiddenmigration.
    Nota: Se uma variável em uma etapa for configurada como Designar Oculto, as outras variáveis na etapa serão padronizadas para Designar Oculto.
    Nota: Se você configurar as variáveis ocultas designadas com os caracteres Multi-Byte Character System (MBCS), por exemplo, (chinês, japonês ou coreano) no Build Forge 7.x, o utilitário de migração oculto não será atualizado automaticamente. É recomendado substituir as variáveis por caracteres ASCII para melhorar a segurança. Uma falha nesse procedimento lhe proíbe de experimentar novas variáveis ocultas designadas porque os comportamentos são idênticos no Build Forge 7.x.
No Projeto
Define como uma variável é usada quando você inicia manualmente uma tarefa. Essa propriedade afeta apenas as variáveis que são utilizadas em ambientes designados a um projeto. A propriedade não afeta variáveis quando a tarefa está em execução. O valor pode ser um dos seguintes:
  • Normal: A variável se comporta normalmente quando designada a um projeto.
  • Necessário: Um valor deve existir para a variável. As variáveis com essa propriedade são realçadas no painel Iniciar. Um valor definido na definição de variável é suficiente. Se um valor não for definido, uma tarefa não poderá ser iniciada com rapidez ou iniciada.

    Se uma tarefa contiver variáveis Necessárias, ela será iniciada pelo planejador ao invés de um usuário, as variáveis serão deixadas inalteradas se não tiverem atualmente um valor ou espaço em branco, se elas não tiverem um valor.

  • Somente leitura: O valor não pode ser alterado.
  • Suprimir Exibição: A variável não é exibida no painel Iniciar Tarefa. Entretanto, a variável existe e pode ser utilizada nas etapas.
  • Deve Alterar: O valor da variável deve ser alterado. As variáveis de nível superior com essa propriedade são realçadas no painel Início; se um novo valor não for inserido, a tarefa não poderá ser iniciada rapidamente ou iniciada.
    Nota: Se uma tarefa que contém variáveis Alteração Obrigatória for iniciada pelo planejador em vez de por um usuário, os valores da variável não serão alterados. Além disso, se uma tarefa que contém variáveis Alteração Obrigatória for iniciada por uma propriedade de classe, os valores da variável não serão alterados. As propriedades de classe incluem Iniciar ao limpar, Iniciar ao entrar e Iniciar ao sair.

Guia Captura Instantânea

Uma captura instantânea de ambiente é uma instância de um ambiente. A guia Captura Instantânea fornece o nome da captura instantânea. Use essa guia para visualizar ou alterar o nome da captura instantânea e os comentários da captura instantânea.


Feedback