Cette rubrique décrit toutes les tâches nécessaires à la création d'un adaptateur de code source,
sa connexion à un projet à l'aide d'un lien d'adaptateur, puis l'exécution du projet lié à l'adaptateur
en mode test.
Création d'un adaptateur à partir d'un modèle
Pour créer un adaptateur en sélectionnant un modèle :
- Sélectionnez
- Cliquez sur Ajouter adaptateur.
- Dans Nom, entrez un nom unique d'adaptateur. Le nom d'adaptateur
doit être unique parmi l'ensemble du jeu d'adaptateurs et ne peut pas contenir
d'espaces.
- Dans Type, sélectionnez le type d'adaptateur.
- Dans Modèle, sélectionnez le modèle. La liste contient les modèles d'adaptateur
installés avec le produit Build Forge. Les adaptateurs ClearCase et ClearQuest
ne nécessitent pas de clé de licence distincte. D'autres adaptateurs sont sous licence distincte
via l'Adaptor Toolkit.
- Dans Accès, sélectionnez un groupe d'accès. L'affichage ou l'édition de l'adaptateur
est restreinte à ces membres du groupe uniquement.
- Cliquez sur Sauvegarder adaptateur.
Création d'un environnement vide
Pour créer un environnement vide :
- Sélectionnez
- Cliquez sur Ajouter environnement.
- Dans Nom, entrez le nom de l'environnement. Attribuez un nom décrivant l'objet
de l'environnement.
- Dans Accès, sélectionnez un groupe d'accès. L'affichage ou l'édition de l'adaptateur
est restreinte à ces membres du groupe uniquement.
- Cliquez sur Sauvegarder environnement.
Ajout d'adaptateurs aux projets
Pour ajouter un adaptateur au projet :
- Sélectionnez
- Cliquez sur Ajouter lien adaptateur.
- Dans Adaptateur, sélectionnez l'adaptateur (et le modèle d'adaptateur) créé.
- Dans Projet, sélectionnez le projet. La liste affiche les projets n'étant pas encore
liés à un adaptateur.
- Dans Etat, sélectionnez Actif.
- Dans Environnement, sélectionnez l'environnement vide créé pour le
lien d'adaptateur.
- Dans Charger environnement, sélectionnez Oui. Les variables
d'environnement de l'application dans le modèle d'adaptateur sont ajoutées à l'environnement.
- Cliquez sur Sauvegarder pour lier l'adaptateur au projet. L'adaptateur et
le projet sont ajoutés à la liste des liens d'adaptateur.
Modification de variables d'environnement
Pour modifier les variables d'environnement :
- Sélectionnez
- Pour l'environnement créé, cliquez sur l'icône Editer
. Le panneau de affiche les variables d'environnement d'adaptateur ajoutées automatiquement
à l'environnement.
- Examinez les valeurs par défaut des variables d'environnement fournies par le
modèle d'adaptateur.
- Modifiez les valeurs par défaut de votre application de code source (si nécessaire)
pour exécuter le projet d'adaptateur.
Attribut de condition
L'attribut de condition
permet d'appliquer les conditions à certaines propriétés d'adaptateur à l'aide des opérateurs
de comparaison Perl. Pour la comparaison, utilisez des littéraux chaîne, des nombres ou des variables.
La syntaxe de la condition est la
suivante :
condition="true(<valeurl> <opérateur> <valeurr>)"
condition="false(<valeurl> <opérateur> <valeurr>)"
condition="hastext(variable)"
condition="isempty(variable)"
Indiquez l'un des quatre types suivants :
Type |
Description |
true |
L'évaluation réussit si les valeurl et valeurr sont identiques. |
false |
L'évaluation réussit si les valeurl et valeurr ne sont pas identiques. |
hastext |
L'évaluation réussit si la longueur de
la valeur est supérieure à 0. |
isempty |
L'évaluation réussit si la longueur de
la valeur est de 0. |
La valeurl et la valeurr peuvent être des chaînes, des nombres ou des variables contenant des chaînes ou des nombres. L'opérateur de condition peut être tout opérateur de condition Perl compatible. Les opérateurs de condition sont des nombres ou des chaînes. Pour éviter de recevoir des résultats imprévisibles, vous devez utiliser
l'opérateur approprié.
Opérateurs chaîne |
Opérateurs numériques |
eq |
== |
ne |
!= |
gt |
> |
lt |
< |
ge |
>= |
le |
<= |
L'utilisation d'opérateurs numériques avec des chaînes ne permet pas d'obtenir des résultats corrects, de même pour les opérateurs de comparaison de type chaîne utilisés avec des valeurs numériques.
Par exemple : condition="true("PASS"=="FAIL")
Cette condition renverra toujours la valeur true, ce qui est incorrect.
Exemples
de conditions :
- condition="true($BF_SERVER eq "TEST_BOX") - Exécute l'élément seulement si la variable de serveur de génération contient TEST_BOX.
- condition="false($BF_BID <=141) - Exécute la génération uniquement si la
balise de génération est supérieure ou égale à 141.
Propriétés d'adaptateur prenant en charge les conditions :
Vérifiez bien le fichier DTD de votre installation Build Forge actuelle pour obtenir des informations actualisées sur les propriétés prenant en charge l'attribut de condition.
Pour les propriétés qui les prennent en charge, l'entrée est similaire à la suivante :
<!ATTLIST
adduser condition CDATA #IMPLIED>
L'adaptateur DTD
se trouve dans le répertoire %BF_HOME%\interface sous Windows, et dans le répertoire $BF_HOME/Platform/interface
sous UNIX, sous le nom de fichier interface.dtd.
Exécution des adaptateurs en mode test
Pour exécuter
l'adaptateur en mode test :
- Sélectionnez
- Dans la liste de paramètres de configuration système, sélectionnez Mode
débogage de liaison.
- Dans Mode débogage de liaison, sélectionnez Oui.
- Cliquez sur Sauvegarder.
- Sélectionnez
- Dans la liste de projets, sélectionnez le projet lié à l'adaptateur que vous avez créé
à partir de la page Démarrage du projet.
- Cliquez sur Exécuter.
Affichage des états de travail et des journaux
Pour afficher les états de travail et
les informations de consignation pour le projet d'adaptateur :
- Ouvrez Travaux.
- Dans la liste des projets, localisez le projet lié à l'adaptateur pour afficher l'état
de transmission/échec du travail.
- Pour afficher les journaux de travail :
- Sélectionnez le Nom de balise du projet d'adaptateur pour accéder aux informations des journaux de travail.
- Sélectionnez la nomenclature pour accéder au rapport de nomenclature.