Partager via

Procédure pas à pas : migration d'éléments de travail ClearQuest vers Team Foundation

  • Article

Mise à jour : novembre 2007

Cette procédure pas à pas vous indique comment déplacer des éléments de travail ClearQuest vers le suivi des éléments de travail Team Foundation. Team Foundation inclut un utilitaire de conversion, CQConverter.exe, que vous pouvez utiliser pour exécuter cette migration.

Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :

  • Configurer le processus de migration   Modifiez les fichiers de configuration pour diriger le processus de migration.

  • Analyser votre base de données ClearQuest   Exécutez le convertisseur ClearQuest pour analyser votre base de données ClearQuest actuelle. L'analyse produit un rapport et un jeu de fichiers qui décrit les types d'éléments de travail présents dans ClearQuest.

  • Définir le mappage de la migration   Modifiez les fichiers XML générés pendant l'analyse de la base de données ClearQuest pour personnaliser le processus de migration.

  • Migrer la base de données ClearQuest vers le suivi des éléments de travail Team Foundation   Utilisez les fichiers de configuration et de mappage générés lors de l'analyse de la base de données pour migrer vos données.

  • Examiner le rapport de migration   Découvrez la cause des erreurs et des avertissements rencontrés pendant la migration et examinez l'état de la migration.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez installer les logiciels suivants sur l'ordinateur où vous envisagez d'exécuter CQConverter.exe :

  • Team Explorer

  • Le client autonome ClearQuest version 2003.06.00

    Remarque :

    Les versions 2002.05.20 et 2003.05.00 peuvent également fonctionner, mais elles n'ont pas été testées.

Vous devez également dresser une liste sur la manière dont vous souhaitez associer les noms d'utilisateurs dans ClearQuest aux noms de domaines Windows utilisés par le suivi des éléments de travail Team Foundation. Assurez-vous d'inclure des noms d'utilisateurs qui ne sont plus utilisés.

Les informations et connaissances suivantes sont utiles :

  • Une compréhension des notions fondamentales de XML.

  • Une liste de la façon dont vous souhaitez mapper les champs d'élément de travail de ClearQuest vers le suivi des éléments de travail Team Foundation. Incluez des informations concernant les transformations requises. Par exemple, vous pouvez associer un champ de chaîne dans ClearQuest à un champ à nombre entier dans le suivi des éléments de travail Team Foundation.

Autorisations requises

Pour effectuer cette procédure pas à pas, vous devez être membre du groupe de sécurité Comptes de service. Vous devez également être membre du groupe de sécurité Lecteurs ou avoir l'autorisation Afficher les éléments de travail dans ce nœud avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server. Vous devez également avoir l'autorisation de super utilisateur pour la base de données ClearQuest. Pour plus d'informations, consultez Guide de l'administrateur ClearQuest.

Tâches préalables à la migration

Avant de démarrer la migration, vous devez effectuer les tâches suivantes :

  • Planifier l'heure de verrouillage de la base de données ClearQuest   Il est conseillé de verrouiller la base de données pour empêcher les utilisateurs de créer de nouveaux éléments de travail pendant le processus de migration. Le convertisseur ClearQuest ne détecte pas les modifications d'éléments de travail pendant la conversion. Pour plus d'informations sur le verrouillage de la base de données ClearQuest, consultez la documentation relative à ClearQuest.

  • Créer des projets d'équipeVisual Studio Issue Tracking   Créez des projets d'équipe et déterminez les éléments de travail à leur associer. Pour plus d'informations sur la création de projets d'équipe pour le suivi des éléments de travail Team Foundation, consultez Procédure pas à pas : création d'un nouveau projet d'équipe.

  • Ajouter au groupe Comptes de service le compte d'utilisateur que vous utilisez pour exécuter le convertisseur   CQConverter a besoin des autorisations de compte de service pour s'exécuter. Ajoutez le compte d'utilisateur qui exécutera le convertisseur au groupe Comptes de service sur votre serveur Team Foundation Server à l'aide de l'utilitaire TFSSecurity. Pour plus d'informations, consultez Commandes de l'utilitaire en ligne de commande TFSSecurity.

Limitations du convertisseur

Avant de démarrer votre migration, vous devez examiner les limitations du convertisseur ClearQuest et la manière dont elles peuvent affecter les utilisateurs dans votre organisation. Pour plus d'informations, consultez CQConverter, utilitaire en ligne de commande pour la migration de la base de données ClearQuest.

Définitions

Les termes suivants sont employés dans cette procédure pas à pas :

  • Type d'élément de travail   Les types d'éléments de travail sont les blocs de construction de base d'un système de suivi des éléments de travail. Les bogues, les spécifications et les tâches sont des types d'éléments de travail.

  • Entité   Il s'agit de l'unité de données de base dans ClearQuest. Par exemple, un défaut peut être lié à un client et appartenir à un projet donné. Le défaut, le client et le projet sont tous des entités.

  • Champ   Les éléments de travail comportent des champs qui contiennent des informations sur les éléments de travail. Par exemple, un élément de travail Defect peut contenir des champs, tels que Ouvert par, État, Résolution, Historique, Liens et Pièces jointes.

  • États   Désigne la position du processus dans laquelle peut se trouver un élément de travail. Par exemple; un bogue peut être Ouvert, Assigné, Résolu ou Différé.

  • Comportement d'un champ (Règles de champ)   Spécifie comment les champs se comportent dans différents états. Par exemple, le champ Corrigé dans pourrait être non modifiable lorsque vous créez un nouveau bogue, mais lorsque vous effectuez la transition du bogue vers l'état Résolu, le champ Corrigé dans peut requérir une valeur.

Configuration du processus de migration

Pendant cette étape, vous modifiez les fichiers de configuration du convertisseur ClearQuest pour guider le processus de migration.

Fichier de configuration

Le fichier de configuration est un fichier XML qui fournit des paramètres pour le convertisseur ClearQuest. Ces paramètres sont spécifiés dans les sections suivantes du fichier XML :

<ClearQuest>

La section ClearQuest contient des informations sur la base de données ClearQuest que vous souhaitez migrer.

  • ConnectionName   Nom de la connexion ClearQuest.

  • UserDatabase   Nom de la base de données utilisateur ClearQuest

  • QueryName   Nom d'une requête enregistrée dans ClearQuest.

  • UserID   ID d'utilisateur ClearQuest. L'ID d'utilisateur spécifié doit bénéficier de l'autorisation de super utilisateur sur la base de données ClearQuest.

<VSTS>

La section VSTS contient des informations sur le serveur de suivi des éléments de travail Team Foundation et le projet d'équipe vers lequel vous effectuez la migration.

  • URI   Nom convivial ou URI complet de Team Foundation Server. Par exemple, "MyAtServer" ou "http://MyAtServer:8080".

  • ProjectName   Nom du projet d'équipe pour le suivi des éléments de travail Team Foundation.

Autres paramètres de configuration

Les autres sections dans le fichier XML vous permettent de spécifier les paramètres suivants :

  • ExitOnError   Cette section accepte la valeur true ou false. Spécifiez True si vous souhaitez arrêter le convertisseur ClearQuest lorsque des erreurs se produisent lors de la migration de certains éléments de travail.

    Remarque :

    Ce paramètre s'applique uniquement aux erreurs récupérables. Pour les erreurs irrécupérables, lorsque par exemple le convertisseur ClearQuest ne parvient pas à se connecter à ClearQuest, le convertisseur se ferme toujours même si ce paramètre a la valeur False.

  • OutputDirectory   Spécifie le répertoire où vous souhaitez placer les fichiers générés. Si vous ne spécifiez pas de répertoire de sortie, le convertisseur crée un répertoire portant le nom Entité de base, destiné à la génération des fichiers de sortie. Si le répertoire existe déjà, le convertisseur remplace les fichiers contenus dans ce répertoire.

Création du fichier de configuration

La création du fichier de configuration peut s'effectuer dans n'importe quel éditeur de texte, tel que le Bloc-notes.

Pour créer le fichier de configuration

  1. Collectez les informations suivantes :

    • Nom de la connexion ClearQuest.

    • Nom de la base de données ClearQuest.

    • ID d'utilisateur et mot de passe de l'administrateur de ClearQuest. Assurez-vous que cet utilisateur Admin dispose des autorisations pour soumettre des questions dans ClearQuest.

    • Nom du serveur de suivi des éléments de travail Team Foundation.

    • Nom du projet d'équipe pour le suivi des éléments de travail Team Foundation (le projet d'équipe vers lequel vous souhaitez migrer les éléments de travail).

  2. Créez une requête dans Clearquest pour sélectionner les éléments de travail que vous souhaitez migrer vers le suivi des éléments de travail Team Foundation et enregistrer la requête. Enregistrez la requête sous un nom quelconque, par exemple TransitionQuery.

  3. Choisissez un répertoire où stocker les fichiers produits pendant la phase d'analyse.

  4. Copiez le fichier de configuration XML suivant dans un éditeur de texte.

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>AdventureWorksServer</URI>
    <ProjectName>AdventureWorksProject</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. Modifiez le fichier pour spécifier vos paramètres avec les informations rassemblées au cours des étapes précédentes. Par exemple, sous <QueryName>, spécifiez TransitionQuery comme nom de requête et incluez le chemin d'accès de la requête. Consultez la section « Fichier de configuration » précédente pour obtenir des informations sur les éléments que chaque section doit contenir.

    Remarque :

    Le mot de passe n'est pas entré dans le fichier, l'outil de conversion ClearQuest le demande ultérieurement au cours du processus de migration.

  6. Enregistrez le fichier.

    Par exemple, vous pouvez enregistrer le fichier sous le nom CqConverterConfig.xml.

Analyse de votre base de données ClearQuest

Pendant l'analyse de votre base de données ClearQuest, le convertisseur ClearQuest vers Team Foundation analyse votre base de données ClearQuest et crée les fichiers XML suivants :

  • Un fichier de définition du type d'élément de travail (WITD) pour le suivi des éléments de travail Team Foundation pour chaque type d'entité ClearQuest qui contient les états, les transitions d'état, les champs, les types de champs et le comportement des champs, tel que obligatoire ou facultatif.

  • Un fichier de mappage de champs par défaut qui mappe les champs et valeurs ClearQuest aux champs et valeurs du suivi des éléments de travail Team Foundation.

  • Un fichier de mappage d'utilisateurs qui mappe les utilisateurs ClearQuest aux utilisateurs Windows. Ce fichier s'applique au système entier.

  • Un fichier de mappage de schéma qui contient des références aux autres fichiers XML, tels que le fichier SchemaMap qui contient des noms d'entités, et votre fichier de mappage de champs qui contient le chemin d'accès des noms de fichiers WorkItem générés et des fichiers fieldMap.

  • Un fichier de rapport et d'avertissement (CQAnalysisReport.xml).

Pour analyser la base de données ClearQuest

  1. À l'invite de commandes de Visual Studio 2008, exécutez la commande suivante :

    CQConverter.exe /c:analyze /m:CqConverterConfig.xml

    Le convertisseur ClearQuest peut prendre plusieurs minutes pour finir de s'exécuter.

    Remarque   Pour plus d'informations sur les commandes du convertisseur ClearQuest, consultez CQConverter, utilitaire en ligne de commande pour la migration de la base de données ClearQuest.

  2. Dans le répertoire de sortie que vous avez spécifié dans le fichier de configuration, recherchez les fichiers XML suivants. Ces fichiers sont utilisés ultérieurement dans le processus de migration :

    • Un fichier WITD pour chaque type d'entité ClearQuest nommé NomEntité.xml. Par exemple, un fichier pour l'entité Defect de ClearQuest nommé Defect.xml.

    • Un fichier de mappage de champs pour chaque type d'entité ClearQuest. Ces fichiers spécifient comment les champs et les valeurs de champ dans chaque entité ClearQuest seront mappés aux champs correspondants dans le type d'élément de travail du suivi des éléments de travail Team Foundation. Par exemple, un fichier pour l'entité Defect de ClearQuest serait nommé DefectFieldMap.xml.

    • Fichier usermap. Un fichier qui spécifie comment associer les utilisateurs ClearQuest aux utilisateurs du suivi des éléments de travail Team Foundation.

    • Un fichier schemamap.xml. Un fichier qui décrit le schéma et les mappages de champ.

  3. Dans le répertoire où vous avez exécuté le convertisseur, recherchez le fichier CQAnalysisReport.xml pour repérer toute erreur et avertissement avant la migration.

Définition du mappage de migration

L'analyse génère un jeu de fichiers qui comporte les informations de votre base de données ClearQuest. Il peut être nécessaire de modifier quelques-uns de ces fichiers pour migrer la base de données comme vous le souhaitez. Vous devez au moins modifier le fichier de mappage utilisateur et le fichier de définition du type d'élément de travail.

Pour plus d'informations sur la modification du fichier de définition d'un type d'élément de travail, consultez Procédure pas à pas : apporter des personnalisations de base à un type d'élément de travail.

Modification du fichier de mappage de schéma

Pour modifier le fichier schemamap.xml

  1. Ouvrez le fichier Schemamap.xml.

    Un exemple de ce fichier suit :

    <Mappings>
  <SchemaMaps>
    <SchemaMap SourceEntity="Defect" TargetWIT="Defect"
      WITDFile="Defect.xml" FieldMapFile="DefectFieldMap.xml"/> 
    <SchemaMap SourceEntity="Customer" TargetWIT="Customer"
      WITDFile="Customer.xml" FieldMapFile="CustomerFieldMap.xml"/> 
  </SchemaMaps>
  <UserMap File="UserMap.xml" /> 
</Mappings>

  2. Apportez les modifications appropriées aux sections du fichier.

    • SourceEntity   Vérifiez que cette section contient l'entité ClearQuest appropriée.

    • TargetWIT   Vérifiez que cette section pointe sur le type d'élément de travail approprié qui doit être créé dans le suivi des éléments de travail Team Foundation.

    • WITDFile   Cette section spécifie le fichier XML de définition du type d'élément de travail (WITD).

    • FieldMapFile   Cette section spécifie le fichier XML de mappage de champs.

    • UserMap   Cette section spécifie le fichier XML de mappage utilisateur.

Modification du fichier de mappage utilisateur

Le convertisseur ClearQuest utilise le fichier de mappage utilisateur pour associer les ID d'utilisateur de la base de données ClearQuest à un ID d'utilisateur du suivi des éléments de travail Team Foundation équivalent. Cela permet de conserver l'historique des éléments de travail en convertissant les valeurs des champs d'ID d'utilisateur pour qu'elles restent valides dans le suivi des éléments de travail Team Foundation. Le suivi des éléments de travail Team Foundation utilise des ID d'utilisateur du domaine Windows.

Une version par défaut de ce fichier est générée par le convertisseur ClearQuest pendant la phase d'analyse. Vérifiez que ce fichier est exact avant de continuer la conversion, car le convertisseur le vérifie et échoue en cas de problèmes.

Pour modifier le fichier de mappage utilisateur

  1. Ouvrez le fichier usermap.xml. Un exemple suit :

    <UserMappings">
  <UserMap From="admin" To="admin" />
  <UserMap From="user" To="user" />
  <UserMap From="QE" To="QE" />
  <UserMap From="lead" To="lead" /> 
  <UserMap From="engineer" To="engineer" />
</UserMappings>

  2. Examinez les mappages utilisateur et procédez aux corrections, ajouts et suppressions requis. Le côté « À » du mappage utilisateur doit être un utilisateur Team Foundation Server existant.

  3. Dans le suivi des éléments de travail Team Foundation, ajoutez tous les utilisateurs spécifiés dans le fichier de mappage utilisateur. Pour plus d'informations sur l'ajout d'utilisateurs, consultez Comment : ajouter des utilisateurs à un groupe de projets d'équipe.

    Remarque :

    Si vous souhaitez qu'un des utilisateurs ClearQuest soit mappé tel quel dans Team Foundation Server pendant la migration, vous pouvez supprimer les lignes dans le fichier de mappage utilisateur pour ces utilisateurs. Si vous ne souhaitez pas effectuer de mappage utilisateur, vous pouvez supprimer toutes les lignes qui spécifient des plans d'utilisateur dans la section <UserMap>. Vous devez supprimer uniquement les entrées individuelles dans la section <UserMap> - ne supprimez pas la section ou une autre partie du fichier.
    Attention :

    Si les utilisateurs ne sont pas mappés à des utilisateurs Team Foundation Server valides pendant la migration, vous devrez peut-être corriger les champs utilisateur dans vos éléments de travail lorsque vous commencerez à les utiliser. Le convertisseur s'exécute sans valider les valeurs de champ, mais dès que vous commencez à modifier les éléments de travail, vous êtes tenu de fournir des utilisateurs valides pour les champs utilisateur.

Modification du fichier de mappage de champs

Le convertisseur ClearQuest utilise les fichiers de mappage de champs pour associer les champs de chaque entité ClearQuest à un champ d'élément de travail du suivi des éléments de travail Team Foundation équivalent.

Pour modifier le fichier de mappage de champs

  1. Ouvrez l'un des fichiers de mappage de champs. Par exemple, ouvrez DefectFieldMap.xml. Un exemple suit :

    <FieldMap from="Criticality" to="Severity">
  <ValueMaps>
        <ValueMap from="1-Critical" to = "1"/>
        <ValueMap from="2-Major" to = "2"/>
  </ValueMaps>
</FieldMap>

  2. Examinez les lignes de mappage de champs (commençant par ValueMap) et vérifiez que le champ indiqué après « de » est mappé au champ approprié après « jusqu'au ». Vous pouvez ajouter des mappages de champ supplémentaires en ajoutant des lignes ValueMap. Les valeurs doivent figurer dans la liste des valeurs autorisées si celle-ci a été spécifiée dans le fichier de schéma, dans ce cas, defect.xml.

    Remarque :

    Si vous modifiez les mappages de champ, assurez-vous que les champs obligatoires dans le formulaire d'élément de travail sont mappés.

  3. Ouvrez les autres fichiers de mappage de champs et apportez les modifications appropriées.

Établissement d'une définition du type d'élément de travail

Après la phase d'analyse, le convertisseur génère des définitions des types d'éléments de travail (WITD) pour chaque type d'enregistrement ClearQuest. Par exemple, un fichier pour le type d'enregistrement Defect de ClearQuest est nommé Defect.xml. Le convertisseur génère un formulaire d'élément de travail par défaut dans le cadre de la génération de schéma pendant la phase d'analyse. Toutefois, ce formulaire par défaut contient une mise en forme minimale que vous devrez presque toujours modifier pour obtenir la disposition des éléments de travail que vous souhaitez. Pour plus d'informations sur la modification du fichier de définition pour un type d'élément de travail, consultez Procédure pas à pas : apporter des personnalisations de base à un type d'élément de travail et Procédure pas à pas : apporter des personnalisations avancées à un type d'élément de travail.

Migration des éléments de travail ClearQuest

Pour migrer des éléments de travail

  1. À l'invite de commandes de Visual Studio 2008, exécutez la commande suivante :

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:chemin\Schemamap.xml

    Où chemin est le chemin du fichier de mappage du schéma. Le fichier de mappage du schéma est généré lors la phase d'analyse dans le répertoire de sortie spécifié.

    Remarque :

    L'exécution du convertisseur ClearQuest peut durer des heures pour les bases de données volumineuses.
    Remarque :

    Pour plus d'informations sur les commandes du convertisseur ClearQuest, consultez Migration à partir de ClearQuest.

  2. Lorsque la migration est effectuée, examinez le rapport de migration pour vérifier l'état de la migration et d'autres problèmes, tels que des erreurs de migration causées par des incohérences de mappage de champs.

    Le rapport de migration est nommé CQMigrationReport.xml et créé dans le dossier à partir duquel vous avez exécuté le convertisseur ClearQuest.

    Remarque :

    Comme le convertisseur convertit tous les éléments de travail inclus dans la requête que vous spécifiez, plus tous les éléments de travail qui y sont liés, le nombre réel d'éléments de travail migrés peut être différent du nombre d'éléments de travail dans la requête.

  3. Si tous les éléments de travail n'ont pas été migrés, vous pouvez à nouveau exécuter la conversion après avoir résolu les problèmes décrits dans le rapport de migration.

Pour migrer davantage d'éléments de travail de ClearQuest vers le suivi des éléments de travail Team Foundation, vous pouvez à nouveau exécuter le processus de migration.

Pour réexécuter une migration sur la même base de données ClearQuest

  1. Corrigez tous les problèmes décrits dans le rapport de migration concernant la migration précédente.

  2. Créez une requête dans ClearQuest pour retourner les éléments de travail désirés ou exécutez la même requête si vous souhaitez migrer des éléments de travail qui n'avaient pas migré la première fois.

  3. Modifiez la section <NomRequête> dans le fichier de configuration pour spécifier le nouveau nom de la requête.

  4. Ouvrez l'invite de commandes de Visual Studio 2008 et tapez la commande de la migration :

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:chemin\Schemamap.xml

    L'exécution du convertisseur ClearQuest peut durer des heures pour les bases de données volumineuses.

    Remarque :

    Pour plus d'informations sur les commandes du convertisseur ClearQuest, consultez Migration à partir de ClearQuest.

  5. Lorsque la migration est terminée, examinez le rapport de migration pour vérifier l'état de la migration. Le rapport de migration est nommé CQMigrationReport.xml et créé dans le dossier à partir duquel vous avez exécuté le convertisseur ClearQuest.

Vérification de la migration d'élément de travail

Après avoir exécuté la migration, vous pouvez examiner quelques-uns des éléments de travail migrés pour vérifier que les informations ont été migrées correctement.

Pour vérifier les éléments de travail migrés

  1. Ouvrez un élément de travail migré dans le suivi des éléments de travail Team Foundation.

  2. Utilisez le nombre dans le champ ID ClearQuest pour comparer l'élément de travail du suivi des éléments de travail Team Foundation au bogue ClearQuest portant le même ID.

Pour rechercher l'élément de travail Team Foundation qui correspond à un élément de travail ClearQuest spécifique

  1. Créez une requête d'élément de travail avec la clause de requête suivante :

    Et/ou

    Champ

    Opérateur

    Valeur

     

    VSTS SourceID

    =

    ID d'élément de travail de ClearQuest

    Le champ VSTS SourceID correspond à l'étiquette du champ ID ClearQuest qui figure dans votre formulaire d'élément de travail.

    Pour plus d'informations sur la création de requêtes d'élément de travail, consultez Comment : ajouter de nouvelles requêtes d'élément de travail.

  2. Exécutez la requête.

Voir aussi

Tâches

Procédure pas à pas : suivi des éléments de travail

Autres ressources

Procédures pas à pas relatives à la migration