Créez un libellé pour que le résultat de l'étape soit répertorié dans sa propre catégorie dans le journal d'étape.
Avant de commencer
Cette tâche suppose que vous avez déjà créé un sélecteur, un serveur,
et un projet et que vous utilisez un serveur fonctionnant sous un système
d'exploitation prenant en charge la commande
echo (par exemple,
Windows, Linux ou UNIX).
Pourquoi et quand exécuter cette tâche
Vous pouvez inclure un libellé en majuscules au début de toute ligne de données
de sortie. Le libellé est utilisé jusqu'à la fin de l'étape ou jusqu'à ce que le processeur rencontre un nouveau libellé.
Un
libellé possède la syntaxe suivante :
- Il contient uniquement des lettres majuscules suivies par deux points (les
libellés ne peuvent pas contenir d'espaces, de signes de ponctuation, de
nombres ou de minuscules. "SPACESHIPS:" est
valide. "Space Ships:" ne l'est pas).
- Il comporte au moins trois caractères
Vous pouvez créer un libellé à
l'aide de la commande echo lors d'une étape. Le système reconnaît le
premier argument de la commande echo comme un libellé s'il est conforme à
la syntaxe des libellés.
Remarque : Le système reconnaît le texte au début d'une
ligne dans toute sortie de compilation comme un libellé s'il est conforme à la
syntaxe, même si ce texte n'est pas un argument de la commande echo.
Comme l'exemple le montre, vous pouvez définir le libellé sur un nom de libellé de sortie existant ou sur de nouveaux noms.
Procédure
- Créez une nouvelle étape dans un projet. Le projet de cet
exemple est appelé Say_hi.
- Donnez à l'étape un nom au format LabeledLogOutput.
- Entrez le texte suivant dans la zone d'entrée des commandes :
echo SPACESHIPS: Voyager I
echo Voyager II
echo EXEC: You can add text to existing categories as well
- Exécutez le projet.
- Lorsque le travail est terminé, consultez le journal.
Résultats
Cochez la case SPACESHIPS dans l'en-tête de catégorie et les lignes
de sortie 354 et 355, appelées 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]
Remarque : Vous
pouvez cocher ou décocher la case SPACESHIPS pour afficher ou masquer la
catégorie.
Remarque : Lorsque vous ajoutez du texte à une catégorie EXEC, évitez
d'utiliser des caractères spéciaux (par exemple, des parenthèses).
Sur certains systèmes, ceux-ci ne sont autorisés uniquement s'ils se trouvent entre
guillemets. Cependant, il est généralement conseillé d'utiliser seulement du texte
simple.