BuildForge est compatible avec Rational ClearQuest pour mettre à jour les enregistrements de génération.
Build Forge présente deux intégrations à ClearQuest :
- La création automatique d'un enregistrement de génération ou la mise à jour basée sur le statut du travail.
Cette fonction est automatiquement activée lorsque les variables d'environnement requises
sont définies dans l'environnement du projet.
- Adaptateurs 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.
- Accédez à ClearCase pour analyser la source. Au cours de l'exécution d'un travail, l'adaptateur exécute des commandes cleartool via un agent et le client ClearCase. L'adaptateur exécute les commandes à l'aide de l'API ClearQuest Perl (cqperl).
- Accédez à ClearQuest pour mettre à jour les enregistrements de génération. Au cours de l'exécution du travail, l'adaptateur exécute des scripts cqperl directement sur l'hôte de la console. Ils sont interprétés par l'utilitaire Cqperl et exécutés via le client
ClearQuest, lesquels sont tous les deux installés sur l'hôte de la console.
Procédez comme suit :
- Installez un agent Build Forge sur un hôte pouvant se connecter au serveur ClearCase.
- Installez le client complet ClearCase sur l'hôte de l'agent.
- Configurez l'environnement de l'agent afin que les commandes puissent être exécutées
via le client ClearCase.
- Installez le client complet ClearQuest sur l'hôte de la console Build Forge.
- Ajoutez le répertoire cqperl (API ClearQuest Perl) sur le chemin du système.
- 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.
- Utilisez la commande cqreg pour ajouter la valeur définie de la base de données (cqreg add_dbset).
- Utilisez l'outil CQ Maintenance Tool pour configurer une connexion à la base de données ClearQuest.
- Déterminez comment mettre en oeuvre et quand et comment démarrer les vues ClearCase qui sont requises.

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
- 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.
- 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.
- 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
- Trouve les enregistrements d'incident ClearQuest associés à une liste d'activités ClearCase.
- 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.
- 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
- 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.
- 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.