Rational Build Forge et Rational ClearQuest

BuildForge est compatible avec Rational ClearQuest pour mettre à jour les enregistrements de génération.

Build Forge présente deux intégrations à ClearQuest :

Ces fonctions sont complètement indépendantes les unes des autres. Plus précisément, l'adaptateur est associé à un environnement créé pour lui. Les variables de cet environnement sont indépendantes de celles définies pour activer des enregistrements de génération automatiques.

Configuration de la génération automatique d'enregistrements de génération

Le système peut créer automatiquement des enregistrements de génération dans votre base de données IBM Rational® ClearQuest®, avec des liens vers les enregistrements d'erreurs. Par ailleurs, lorsqu'un travail aboutit, le système peut mettre à jour la base de données ClearQuest, en notant que le travail est terminé et en enregistrant l'heure de fin et un récapitulatif des étapes effectuées. Cette fonction nécessite la version 7.0 ou ultérieure de Rational ClearQuest.

Lorsque vous configurez un projet pour mettre à jour une base de données ClearQuest, le système effectue, crée ou met à jour les enregistrements de génération suivants :
Démarrage du travail
Lorsque le système lance un travail, il crée un enregistrement de génération ClearQuest. L'enregistrement de génération est à l'état Soumis et inclut l'URL du journal de travail, l'heure de démarrage, le nom et l'identificateur d'édition, ainsi qu'une entrée de journal indiquant "Génération XYZ démarrée". Si un adaptateur de contrôle des sources annule le travail (par exemple parce qu'aucune modification de source n'est trouvée), aucun enregistrement de génération ClearQuest n'est créé.
Remarque : Si un projet est mis en séquence par un autre projet, un ID génération ClearQuest unique est attribué au nouveau projet, qui lui est propre.
Réussite/échec du travail
Lorsqu'un travail réussit ou échoue, le système modifie l'état de la génération dans ClearQuest pour le définir sur Terminé ou Echoué, définit l'heure de fin de génération, et stocke un récapitulatif des étapes dans le journal de génération ClearQuest. Ce récapitulatif inclut le nom, l'état du résultat et le serveur de chaque étape.
Redémarrage du travail
Lorsqu'un travail est redémarré, le système modifie l'état de génération dans ClearQuest pour le définir sur Soumis et crée une entrée de journal de génération ClearQuest indiquant “Génération XYZ redémarrée.”

Configurez la mise à jour automatique de l'enregistrement de génération via des variables d'environnement spéciales. Pour lier un projet à une base de données ClearQuest, assurez-vous que les variables du tableau suivant sont incluses dans l'environnement du projet.

Remarque : Ces variables doivent être présentes dans l'environnement du projet. Il n'est pas suffisant de les ajouter à une étape. Cependant, vous pouvez utiliser une variable définie sur le type Include qui inclut ces variables à un autre environnement. Par ailleurs, étant donné que la valeur CQ_RELEASE_NAME est la seule susceptible de varier d'un projet à l'autre, vous pouvez choisir de créer un environnement contenant les autres variables et utiliser une variable de type Include pour l'inclure à l'environnement du projet, où vous pouvez également indiquer CQ_RELEASE_NAME comme variable d'environnement spécifique au projet.

Afin d'activer les mises à jour automatiques des enregistrements de génération à partir de travaux Build Forge, les variables d'environnement suivantes doivent être définies pour le projet. Elles ne fonctionnent pas au niveau de l'étape.

Variable

Description

CQ_DBNAME

Obligatoire. Nom de la base de données ClearQuest que vous souhaitez mettre à jour.

CQ_DBSET

Valeur définie de la base de données ClearQuest. Facultatif. Aucune valeur par défaut.

CQ_INTERACTION

Si les variables d'environnement nécessaires à la création d'un enregistrement de génération ClearQuest sont définies dans votre environnement de projet, mais que vous ne souhaitez pas créer l'enregistrement de génération, définissez cette variable sur OFF afin de désactiver la création de l'enregistrement de génération.

Pour activer la création de l'enregistrement de génération, définissez cette variable d'environnement sur ON.

Remarque : Si vous utilisez un des adaptateurs ClearQuest, définissez cette variable d'environnement sur OFF. L'adaptateur interagit directement avec les enregistrements de génération.

CQ_PASSWORD

Obligatoire. Mot de passe à utiliser pour se connecter à la base de données ClearQuest. Facultative ; définie par défaut sur blank

CQ_RELEASE_NAME

Obligatoire. Nom de l'édition dans la base de données ClearQuest que vous souhaitez mettre à jour.

CQ_USER

Obligatoire. Nom d'utilisateur à utiliser pour se connecter à la base de données ClearQuest

Exigences de configuration supplémentaires pour les adaptateurs ClearQuest

Les exemples de modèles d'adaptateur ClearQuest fournissent des méthodes permettant d'analyser ClearCase et de mettre à jour les enregistrements de génération dans ClearQuest. Cette fonction est habituellement liée à la réussite ou à l'échec des générations exécutées dans Build Forge. Pour plus d'informations sur les exigences générales, voir la section Exigences pour les adaptateurs. En outre, la configuration suivante doit être effectuée.

Procédez comme suit :

  1. Installez un agent Build Forge sur un hôte pouvant se connecter au serveur ClearCase.
  2. Installez le client complet ClearCase sur l'hôte de l'agent.
  3. Configurez l'environnement de l'agent afin que les commandes puissent être exécutées via le client ClearCase.
  4. Installez le client complet ClearQuest sur l'hôte de la console Build Forge.
  5. Ajoutez le répertoire cqperl (API ClearQuest Perl) sur le chemin du système.
  6. Définissez une connexion que le client ClearQuest sur l'hôte Build Forge pourra utiliser pour accéder à la base de données ClearQuest. Exécutez les opérations suivantes sur l'hôte du client ClearQuest.
    1. Utilisez la commande cqreg pour ajouter la valeur définie de la base de données (cqreg add_dbset).
    2. Utilisez l'outil CQ Maintenance Tool pour configurer une connexion à la base de données ClearQuest.
  7. Déterminez comment mettre en oeuvre et quand et comment démarrer les vues ClearCase qui sont requises.
Image illustrant la relation entre les installations Build Forge, ClearCase et ClearQuest.

Vous n'avez pas à installer un agent. L'adaptateur ClearQuest communique directement avec ClearQuest via le client, à l'aide de l'API ClearQuest Perl.

Important : L'adaptateur ClearQuest peut uniquement être appelé à l'aide d'une commande point dans une étape. Il ne s'agit pas d'un adaptateur source, donc aucune lien d'adaptateur ne peut être utilisé.

Exemples de modèles d'adaptateur ClearQuest

Les exemples de modèles d'adaptateur suivants sont fournis.

ClearQuestBaseClearCaseByDate
  1. Recherche les modifications effectuées entre deux dates dans une vue ClearCase. Les dates par défaut sont l'horodatage en cours et l'horodatage de l'exécution d'adaptateur précédente.
  2. Pour chaque fichier modifié, recherche un attribut de lien hypertexte CrmRequest identifiant un ID modification ClearQuest. Tente de résoudre l'ID changement en ajoutant des informations sur le travail afin de résoudre l'enregistrement de problème dans ClearQuest si le statut ClearQuest lui permet d'être résolu.
  3. Pour chaque fichier modifié, consigne les informations suivantes dans le rapport BOM : nom du fichier, ID incident, état d'incident et éventuelles erreurs ClearQuest.

Variables définies dans le modèle d'adaptateur :

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestClearCaseByActivity
  1. Trouve les enregistrements d'incident ClearQuest associés à une liste d'activités ClearCase.
  2. Pour chaque enregistrement d'incident trouvé, ajoute des informations sur le travail pour corriger l'enregistrement défectueux dans ClearQuest si l'état de ClearQuest lui permet d'être résolu.
  3. Consigne les informations suivantes dans le rapport BOM : fichiers associés aux ID d'activité de ClearCase et état d'incident ClearQuest.

Variables définies dans le modèle d'adaptateur :

  • CurDate
  • VIEW
  • VOB_PATH
  • ACTIVITIES
  • CQ_USER
  • CQ_PASSWORD
  • PROJECT_VOB
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestUCMClearCaseByDate
  1. Recherche les modifications effectuées entre deux dates dans une vue ClearCase. Les dates par défaut sont l'horodatage en cours et l'horodatage de l'exécution d'adaptateur précédente. Il utilise Rational Unified Change Management (UCM) pour générer ses résultats.
  2. Pour chaque fichier modifié, consigne les informations suivantes dans le rapport BOM : nom du fichier, ID incident, état d'incident et éventuelles erreurs ClearQuest.

Variables définies dans le modèle d'adaptateur :

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE

Variables d'adaptateur ClearQuest

Cette table sert de référence pour les listes de variables des modèles d'adaptateur.

Tableau 1. Variables d'environnement nécessaires à l'intégration de Rational ClearQuest

Variable

Description

ACTIVITIES Pour l'adaptateur ClearQuestClearCaseByActivity, un ensemble d'ID d'activité délimité par l'espace. Exemple : SAMPL0001@\ProjectVob
BFSERVER Définissez cette variable sur le nom de l'hôte pour la console Build Forge.

CQ_PASSWORD

Obligatoire. Mot de passe à utiliser pour se connecter à la base de données ClearQuest. Facultative ; définie par défaut sur blank

CQ_USER

Obligatoire. Nom d'utilisateur à utiliser pour se connecter à la base de données ClearQuest

CurDate Fournit la date actuelle à l'adaptateur, à l'aide d'une commande .date afin de générer la date. Ne modifiez pas cette valeur.
LAST_RUN Pour les adaptateurs ByDate, le système utilise cette valeur afin de déterminer si des modifications ont été effectuées ; il s'agit de la date de la dernière exécution réussie. Vous pouvez régler cette valeur lorsque vous testez l'adaptateur pour provoquer son exécution, en sélectionnant une date dont vous savez qu'elle est antérieure à certaines modifications. Si l'adaptateur autorise la poursuite de l'exécution, il met automatiquement cette valeur à jour sur la date actuelle. La valeur par défaut est 1-Jan-05.00:00:00.
UNIXCLIENT Permet de définir les informations spécifiques à la plateforme. Définissez sur la valeur 0 si le client est en cours d'exécution sur Windows. Définissez sur la valeur 1 si le client est en cours d'exécution sur UNIX ou Linux.
VIEW Définissez cette variable sur le nom de la vue ClearCase que vous souhaitez utiliser avec l'adaptateur.
VOB_PATH Définissez cette valeur sur le nom de votre composant VOB et éventuellement, de ses sous-répertoires. Utilisez une liste séparée par des virgules en cas de noms multiples.
_CHAR_NATIVE Utilisé en interne et toujours défini sur la valeur 1.

Redémarrage de travaux intégrés ClearQuest

Une fois qu'un travail intégré ClearQuest est terminé, il ne peut normalement pas être redémarré dans Rational Build Forge. Comme solution de contournement, vous pouvez démarrer le travail comme un nouveau travail.

Pour activer le redémarrage, vous devez éditer le schéma ClearQuest avec l'outil de conception ClearQuest. Le flux de travaux pour les enregistrements Build doit être modifiée pour permettre une transition de l'état terminé à l'état de soumission.


Commentaires en retour