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:
- Selecione
- Clique em Incluir Adaptador.
- 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.
- Em Tipo, selecione o tipo de adaptador.
- 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.
- Em Acesso, selecione um grupo de acesso. A capacidade de visualizar ou editar o adaptador
é restrita a esses membros do grupo.
- Clique em Salvar Adaptador.
Criando um Ambiente Vazio
Para criar um ambiente
vazio:
- Selecione
- Clique em Incluir Ambiente.
- Em Nome, insira o nome do ambiente. Atribua um nome que descreva o propósito
do ambiente.
- Em Acesso, selecione um grupo de acesso. A capacidade de visualizar ou editar o ambiente
é restrita a esses membros do grupo.
- Clique em Salvar Ambiente.
Incluindo Adaptadores em Projetos
Para incluir o adaptador
em um projeto:
- Selecione
- Clique em Incluir Link do Adaptador.
- Em Adaptador, selecione o adaptador (e modelo do adaptador) que você criou.
- Em Projeto, selecione o projeto. A lista exibe os projetos ainda não
vinculados a um adaptador.
- Em Estado, selecione Ativo.
- Em Ambiente, selecione o ambiente vazio criado para o
link do adaptador.
- Em Preencher Ambiente, selecione Sim. As variáveis de ambiente do
aplicativo no modelo do adaptador são incluídas no ambiente.
- 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:
- Selecione
- Para o ambiente criado, clique no ícone Editar
. O painel exibe as variáveis de ambiente do adaptador automaticamente incluídas no ambiente.
- Analise os valores padrão fornecidos para as variáveis de ambiente fornecidas pelo
modelo do adaptador.
- 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:
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:
- Selecione
- Na lista dos parâmetros de configuração do sistema, selecione Modo de Depuração
do Link.
- Em Modo de Depuração do Link, selecione Sim.
- Clique em Salvar.
- Selecione
- Na lista de projetos, selecione o projeto vinculado ao adaptador criado
da página Iniciar Projeto.
- Clique em Executar.
Visualizar Status e Logs de Tarefa
Para visualizar as informações de status e
log da tarefa do projeto do adaptador:
- Abra Tarefas.
- Na lista de projetos, localize o projeto vinculado ao adaptador para visualizar
o status de transmissão/falha da tarefa.
- 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.