Crie um rótulo para ter a saída da etapa listada em sua própria categoria
no log de etapas.
Antes de Iniciar
Essa tarefa supõe que você já tenha criado um seletor, um servidor e
um projeto. Supõe-se que você esteja usando um servidor com um sistema operacional que aceite
o comando
echo (por exemplo, Windows, Linux ou UNIX).
Sobre Esta Tarefa
É possível incluir um rótulo em maiúsculas no começo de cada linha da
saída. O rótulo é utilizado até que a etapa termine e um novo rótulo seja encontrado.
Um rótulo tem a seguinte sintaxe:
- Contém letras maiúsculas seguidas por dois pontos (os rótulos não podem conter espaços, pontuação, números ou letras minúsculas. SPACESHIPS:" é
válido. "Space Ships:" não é válido).
- Ter pelo menos três caracteres
É possível criar um rótulo usando o comando echo em uma etapa. O sistema reconhece o primeiro argumento para o comando echo como um rótulo se ele for seguido pela sintaxe de rótulo.
Nota: O sistema reconhece texto no começo de uma linha em qualquer saída de construção como um rótulo se ele for seguido pela sintaxe, mesmo se esse texto não for um argumento para o comando echo.
Como o exemplo mostra, é possível definir o rótulo como um nome de rótulo de saída existente, bem como novos nomes.
Procedimento
- Criar uma nova etapa em um projeto. O projeto
neste exemplo é chamado Say_hi.
- Nome da etapa LabeledLogOutput.
- Digite o seguinte texto no campo Comando:
echo SPACESHIPS: Voyager I
echo Voyager II
echo EXEC: You can add text to existing categories as well
- Executar o projeto.
- Quando a tarefa estiver concluída, visualize o log.
Resultados
Observe a caixa de opção SPACESHIPS no cabeçalho da categoria e as linhas de saída
354 e 355, que são rotuladas como SPACESHIPS.
79 7/9/10 10:24 AM EXEC Locale set to 'English_United States.1252'
250 7/9/10 10:24 AM EXEC Locale set to 'English_United States.1252'
349 7/9/10 10:24 AM EXEC Performing variable expansion on command line
353 7/9/10 10:24 AM EXEC start [C:\data\BuildForge\buildforge_projects\Say_hi\BUILD_1@RBF-14]
354 7/9/10 10:24 AM SPACESHIPS Voyager I
355 7/9/10 10:24 AM SPACESHIPS Voyager II
356 7/9/10 10:24 AM EXEC You can add text to existing categories as well
357 7/9/10 10:24 AM EXEC end [C:\data\BuildForge\buildforge_projects\Say_hi\BUILD_1@RBF-14]
Nota: É possível selecionar ou desmarcar a caixa de opção SPACESHIPS para mostrar ou ocultar a categoria.
Nota: Ao incluir texto em uma categoria EXEC, assegure-se de evitar caracteres especiais (por exemplo, parênteses).
Em alguns sistemas, poderá ser viável colocar entre aspas, mas, em geral, a melhor prática é simplesmente usar texto simples.