Visão Geral da Tarefa do Adaptador

Esse tópico abrange todas as tarefas necessárias para criar um adaptador do código-fonte, conectá-lo a um projeto com um link de adaptador e executar o projeto vinculado ao adaptador no modo de teste.

Criando um Adaptador Selecionando um Modelo

Para criar um adaptador selecionando um modelo:

  1. Selecione Projetos → Adaptadores.
  2. Clique em Incluir Adaptador.
  3. Em Nome, insira um nome exclusivo para o adaptador. O nome do adaptador deve ser exclusivo em todo o conjunto de adaptadores e não pode conter espaços.
  4. Em Tipo, selecione o tipo de adaptador.
  5. Em Modelo, selecione o modelo. A lista contém os modelos de adaptadores instalados com o produto Build Forge. Os adaptadores ClearCase e ClearQuest não requerem uma chave de licença separada. Outros adaptadores são separadamente licenciados por meio do Kit de Ferramentas do Adaptador.
  6. Em Acesso, selecione um grupo de acesso. A capacidade de visualizar ou editar o adaptador é restrita a esses membros do grupo.
  7. Clique em Salvar Adaptador.

Criando um Ambiente Vazio

Para criar um ambiente vazio:

  1. Selecione Projetos → Ambientes.
  2. Clique em Incluir Ambiente.
  3. Em Nome, insira o nome do ambiente. Atribua um nome que descreva o propósito do ambiente.
  4. Em Acesso, selecione um grupo de acesso. A capacidade de visualizar ou editar o ambiente é restrita a esses membros do grupo.
  5. Clique em Salvar Ambiente.

Incluindo Adaptadores em Projetos

Para incluir o adaptador em um projeto:

  1. Selecione Projetos → Links do Adaptador.
  2. Clique em Incluir Link do Adaptador.
  3. Em Adaptador, selecione o adaptador (e modelo do adaptador) que você criou.
  4. Em Projeto, selecione o projeto. A lista exibe os projetos ainda não vinculados a um adaptador.
  5. Em Estado, selecione Ativo.
  6. Em Ambiente, selecione o ambiente vazio criado para o link do adaptador.
  7. Em Preencher Ambiente, selecione Sim. As variáveis de ambiente do aplicativo no modelo do adaptador são incluídas no ambiente.
  8. Clique em Salvar para vincular o adaptador ao projeto. O adaptador e o projeto são incluídos na lista de links do adaptador.

Editando Variáveis de Ambiente

Para editar variáveis de ambiente:

  1. Selecione Ambientes.
  2. Para o ambiente criado, clique no ícone Editar Ícone editar, um lápis. O painel exibe as variáveis de ambiente do adaptador automaticamente incluídas no ambiente.
  3. Analise os valores padrão fornecidos para as variáveis de ambiente fornecidas pelo modelo do adaptador.
  4. Altere os valores padrão do seu aplicativo de código-fonte conforme necessário para executar o projeto do adaptador.

Atributo de Condição

O atributo de condição permite que condições sejam aplicadas a algumas propriedades do adaptador usando operadores de comparação Perl. Cadeias literais, números ou variáveis podem ser utilizados para a comparação.

A sintaxe para o atributo de condição é:

condition="true(<lvalue> <operator> <rvalue>)"
condition="false(<lvalue> <operator> <rvalue>)"
condition="hastext(variable)"
condition="isempty(variable)"

Especifique um dos quatro tipos:

Tipo Descrição
true A avaliação será bem-sucedida se lvalue e rvalue forem iguais.
false A avaliação será bem-sucedida se lvalue e rvalue não forem iguais.
hastext A avaliação será bem-sucedida se o comprimento do valor for maior que 0.
isempty A avaliação será bem-sucedida se o comprimento do valor for 0.
O lvalue e o rvalue podem ser sequências, números ou variáveis contendo sequências ou números. O operador de condição é qualquer operador de condição compatível com Perl. Existem operações de condição de sequência e número. É necessário usar o operador apropriado ou receberá resultados imprevisíveis.
Operadores de Sequência Operadores Numéricos
eq ==
ne !=
gt >
lt <
ge >=
le <=

O uso de operadores numéricos com sequências não retornará resultados corretos e os mesmos manterão true para o uso de operadores de comparação de sequências em valores numéricos.

Por exemplo: condition="true("PASS"=="FAIL")

A condição acima sempre retornará true, que é incorreto.

Exemplos de condições:
  • condition="true($BF_SERVER eq "TEST_BOX") - Executa o item apenas se a variável do servidor do build contiver TEST_BOX.
  • condition="false($BF_BID <=141) - Executa a construção apenas se a tag de construção for maior do que 141 ou não for inferior a 141.
Propriedades do adaptador que suportam condições:
  • adduser
  • bom
  • run
  • setenv
Verifique duas vezes o DTD de sua instalação atual do Build Forge para obter informações atualizadas nas quais as propriedades suportam o atributo de condição.

Você verá uma entrada semelhante à seguinte para as propriedades que suportam as condições:

<!ATTLIST adduser condition CDATA #IMPLIED>

O DTD do adaptador está localizado em %BF_HOME%\interface para Windows e em $BF_HOME/Platform/interface para UNIX como o arquivo interface.dtd.

Executando Adaptadores em Modo de Teste

Para executar o adaptador em modo de teste:

  1. Selecione Administração → Sistema.
  2. Na lista dos parâmetros de configuração do sistema, selecione Modo de Depuração do Link.
  3. Em Modo de Depuração do Link, selecione Sim.
  4. Clique em Salvar.
  5. Selecione Tarefas → Iniciar.
  6. Na lista de projetos, selecione o projeto vinculado ao adaptador criado da página Iniciar Projeto.
  7. Clique em Executar.

Visualizar Status e Logs de Tarefa

Para visualizar as informações de status e log da tarefa do projeto do adaptador:
  1. Abra Tarefas.
  2. Na lista de projetos, localize o projeto vinculado ao adaptador para visualizar o status de transmissão/falha da tarefa.
  3. Para visualizar os logs da tarefa:
    • Selecione o Nome da Guia do projeto do adaptador para acessar as informações de log da tarefa.
    • Selecione a Lista de Materiais para acessar o relatório BOM.

Feedback