Présentation des tâches d'adaptateur

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 :

  1. Sélectionnez Projets → Adaptateurs.
  2. Cliquez sur Ajouter adaptateur.
  3. 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.
  4. Dans Type, sélectionnez le type d'adaptateur.
  5. 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.
  6. 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.
  7. Cliquez sur Sauvegarder adaptateur.

Création d'un environnement vide

Pour créer un environnement vide :

  1. Sélectionnez Projets → Environnements.
  2. Cliquez sur Ajouter environnement.
  3. Dans Nom, entrez le nom de l'environnement. Attribuez un nom décrivant l'objet de l'environnement.
  4. 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.
  5. Cliquez sur Sauvegarder environnement.

Ajout d'adaptateurs aux projets

Pour ajouter un adaptateur au projet :

  1. Sélectionnez Projets → Liens d'adaptateur.
  2. Cliquez sur Ajouter lien adaptateur.
  3. Dans Adaptateur, sélectionnez l'adaptateur (et le modèle d'adaptateur) créé.
  4. Dans Projet, sélectionnez le projet. La liste affiche les projets n'étant pas encore liés à un adaptateur.
  5. Dans Etat, sélectionnez Actif.
  6. Dans Environnement, sélectionnez l'environnement vide créé pour le lien d'adaptateur.
  7. Dans Charger environnement, sélectionnez Oui. Les variables d'environnement de l'application dans le modèle d'adaptateur sont ajoutées à l'environnement.
  8. 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 :

  1. Sélectionnez Environnements.
  2. Pour l'environnement créé, cliquez sur l'icône Editer Icône Editer (crayon). Le panneau de affiche les variables d'environnement d'adaptateur ajoutées automatiquement à l'environnement.
  3. Examinez les valeurs par défaut des variables d'environnement fournies par le modèle d'adaptateur.
  4. 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 :
  • adduser
  • bom
  • run
  • setenv
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 :

  1. Sélectionnez Administration → Système.
  2. Dans la liste de paramètres de configuration système, sélectionnez Mode débogage de liaison.
  3. Dans Mode débogage de liaison, sélectionnez Oui.
  4. Cliquez sur Sauvegarder.
  5. Sélectionnez Travaux → Démarrage.
  6. Dans la liste de projets, sélectionnez le projet lié à l'adaptateur que vous avez créé à partir de la page Démarrage du projet.
  7. 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 :
  1. Ouvrez Travaux.
  2. Dans la liste des projets, localisez le projet lié à l'adaptateur pour afficher l'état de transmission/échec du travail.
  3. 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.

Feedback