Analyse d'une base de données ClearQuest

Mise à jour : novembre 2007

Dans la phase d'analyse, le convertisseur lit le schéma de la base de données ClearQuest et génère des fichiers qui représentent ce schéma au format Team Foundation. Le convertisseur utilise la requête ClearQuest pour déterminer le type d'entité de base ClearQuest ; une requête dans ClearQuest est basée sur un type d'entité. Le convertisseur recherche également des types d'entité associés au type d'entité de base. Les entités associées à l'entité de base sont les entités auxquelles l'entité de base fait référence. Cela signifie que les entités présentes dans le type d'entité de base le sont en tant que référence ou liste de références. Cette liste des entités référencées exclut les éléments suivants :

• Types d'entité qui peuvent être référencés en tant que doublon de.

• Entité Utilisateur   Les utilisateurs sont migrés conformément à la gestion des utilisateurs dans Team Foundation. Team Foundation ne gère pas les utilisateurs comme une entité.

• Entité Pièce jointe   Les pièces jointes sont migrées conformément à la gestion des pièces jointes de base de Team Foundation. Team Foundation ne gère pas les pièces jointes comme une entité.

• Historique   L'historique est migré conformément à la gestion de l'historique de base de Team Foundation. Team Foundation ne gère pas l'historique comme une entité.

• Groupes   Le convertisseur n'effectue pas une migration des groupes ClearQuest. Les groupes sont gérés différemment dans Team Foundation.

• Ratl_replicas   Cette entité n'a aucun concept équivalent dans Team Foundation.

Phase d'analyse

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

CQConverter /c:analyze /m:CqConverterConfig.xml

Remarque :

Pour analyser votre base de données ClearQuest, l'ID d'utilisateur spécifié dans le fichier CqConverterConfig.xml doit disposer d'autorisations Administrateur. Pour plus d'informations, consultez le document ClearQuest Administrator's Guide. Vous devez également être membre du groupe Service Accounts sur le serveur Team Foundation Server spécifié. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Le convertisseur ClearQuest peut prendre plusieurs minutes pour terminer l'exécution. Plusieurs fichiers sont générés à la fin de la phase d'analyse.

Fichier de configuration du convertisseur

Vous devez spécifier des entrées au convertisseur dans un fichier de configuration. Pour plus d'informations, consultez Fichier de configuration du convertisseur d'éléments de travail.

Fichiers de sortie

La phase d'analyse génère plusieurs fichiers de sortie. Les fichiers sont enregistrés dans le dossier qui est spécifié par l'élément <Outputdirectory> dans le fichier de paramètres de la migration. Si aucun répertoire n'est spécifié, le convertisseur crée un dossier qui porte le même nom que le type d'entité de base ClearQuest. Si le dossier existe déjà, le contenu de ce dossier est remplacé par les nouveaux fichiers xml générés.

À la fin de la phase d'analyse, les fichiers suivants sont créés :

• Fichier(s) xml de définition du type d'élément de travail   Ces fichiers représentent les types d'éléments de travail au format Team Foundation et sont utilisés pour créer des types d'éléments de travail dans Team Foundation. Un fichier est généré pour l'entité principale et chaque entité référencée. Ces fichiers sont nommés <TypeEntité>.xml. Par exemple, un type d'élément de travail de défaut génère le fichier Defect.xml.

• Fichier(s) xml de mappage des champs   Ces fichiers spécifient comment les champs sont mappés de types d'enregistrement ClearQuest aux types d'éléments de travail Team Foundation, ainsi que toutes les conversions de données à appliquer pendant la migration des données. Ces fichiers entretiennent une relation un-à-un avec les fichiers de type d'élément de travail. Chaque fichier de mappage des champs spécifie le mappage pour le type d'élément de travail correspondant. Ces fichiers sont nommés <NomEntité>FieldMap.xml. Par exemple, le type d'élément de travail de défaut génère le fichier DefectFieldMap.xml.

• Fichier xml de mappage utilisateur   Ce fichier est nommé UserMap.xml. Il spécifie comment les utilisateurs de ClearQuest sont mappés aux utilisateurs de Team Foundation. Ce fichier peut s'avérer nécessaire car ClearQuest possède une base de données utilisateur séparée et les noms d'utilisateurs de ClearQuest peuvent ne pas être semblables aux comptes d'utilisateur Windows. Team Foundation nécessite les comptes d'utilisateur Windows.

• Fichier xml de mappage de schéma   Ce fichier est nommé Schemamap.xml. Le fichier contient les noms de tous les fichiers décrits précédemment et spécifie les mappages supplémentaires entre les types d'éléments de travail et les fichiers associés.

• Fichier xml du rapport d'analyse   Ce fichier est nommé CQAnalysisReport.xml. Un dossier associé qui est généré avec ce fichier est nommé _AnalysisReport_Files et contient des images et une feuille de style pour permettre d'afficher correctement ce fichier dans un navigateur.

• Fichier journal nommé CQConverter.log

  Remarque :
  Indépendamment du nombre de champs d'un élément de travail particulier sélectionnés dans une requête, tous les champs présents dans un type d'élément de travail sont sélectionnés par le convertisseur pour analyse. Les fichiers de sortie contiennent les références de tous les champs.

Fichier de définition du type d'élément de travail

Les fichiers de définition du type d'élément de travail (WITD) comprennent le schéma d'un type d'élément de travail au format Team Foundation. Vous pouvez utiliser un fichier WITD pour créer un nouveau type d'élément de travail dans Team Foundation. Un fichier WITD spécifie les champs dans le type, les états, les transitions d'état et les règles d'élément de travail et dans l'interface utilisateur permettant d'afficher l'élément de travail. Pour plus d'informations sur les fichiers de définition du type d'élément de travail, consultez Personnalisation des types d'éléments de travail.

Les sections suivantes expliquent comment ces types d'éléments de travail sont générés.

Mappages de type de champ

Le convertisseur mappe les types de champs dans ClearQuest aux types de champs appropriés dans Team Foundation. Le tableau suivant spécifie comment les champs sont mappés.

Mappages de champs

Dans ClearQuest, chaque type d'élément de travail utilise des champs système et, de la même façon, il existe des champs système dans les types de l'élément de travail Team Foundation. Le convertisseur mappe les champs système de ClearQuest aux champs système de Team Foundation, selon les besoins. Outre les champs système, il existe également des champs qui figurent généralement dans les types d'éléments de travail ClearQuest. Le convertisseur les mappe aux champs Team Foundation, selon les besoins.

Le tableau suivant spécifie comment le convertisseur mappe les champs système.

Le tableau suivant spécifie comment le convertisseur mappe les champs communs.

Gestion de comportement de champ

Vous pouvez spécifier le comportement des champs dans ClearQuest. Vous pouvez également spécifier un comportement différent des champs selon les différents états d'un élément de travail. Le convertisseur connaît des restrictions de migration du comportement dans les éléments de travail ClearQuest. Par exemple, le convertisseur effectue une migration du comportement de champ spécifié uniquement sur l'état initial, autrement dit, l'état d'un élément de travail créé récemment.

Le comportement défini pour les différents états n'est ni analysé, ni généré dans la phase d'analyse. Toutefois, Team Foundation prend en charge la spécification de ces comportements et vous pouvez ajouter manuellement ces comportements dans les types d'éléments de travail après la phase d'analyse. Pour plus d'informations sur la personnalisation du comportement des types d'éléments de travail dans Team Foundation, consultez Définition du flux de travail des éléments de travail.

Le comportement d'élément de travail est migré comme spécifié dans le tableau suivant.

Champs ajoutés par le convertisseur dans les types d'éléments de travail

Le convertisseur génère les champs suivants dans chaque type d'élément de travail en plus des champs présents dans vos types d'éléments de travail ClearQuest.

Champs obligatoires pour le fonctionnement du convertisseur

Ne supprimez pas ces champs. La suppression de ces champs de types d'éléments de travail conduit à l'échec de la migration. Vous pouvez les supprimer de l'interface utilisateur d'élément de travail (formulaire) si vous ne souhaitez pas qu'ils s'affichent. Nous recommandons que vous conserviez ces champs en lecture seule pour empêcher les utilisateurs de les modifier. Les champs sont les suivants :

• Champ de l'ID ClearQuest d'un élément de travail migré.

  <FIELD name="vsts sourceid" refname="Microsoft.TeamFoundation.Converters.vsts_sourceid" type="String"/>
  

• Champ de la base de données ClearQuest dont un élément de travail migré provient.

  <FIELD name="vsts sourcedb" refname="Microsoft.TeamFoundation.Converters.vsts_sourcedb" type="String"/>
  

• Champ utilisé pour suivre l'état de migration d'un élément de travail particulier.

  <FIELD name="Migration Status" refname="Microsoft.TeamFoundation.Converters.Migration_Status" type="String"/>
  

• Champs système dans Team Foundation. Lorsque les champs système dans Team Foundation mappent aux champs système dans ClearQuest, le xml de mappage approprié est généré. Certains champs système dans Team Foundation ne mappent pas vers des champs système dans ClearQuest et génèrent des champs supplémentaires dans chaque type d'élément de travail. Ces champs sont identifiés à l'aide d'un commentaire semblable au xml suivant :

  <!--State is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
  

Gestion des champs Liste

Les champs dans ClearQuest peuvent disposer d'un jeu de valeurs valides ou suggérées défini pour eux. Lorsque le convertisseur lit les champs et leurs types, il établit également si le champ est un type de champ de liste ou non. Si le champ est un type de champ de liste, le convertisseur rassemble également les valeurs de liste valides suggérées. Ces informations sont incluses dans les fichiers de définition du type d'élément de travail dans la section de champ correspondante. Recherchez les éléments <AllowedValues> ou <SugggestedValues>.

Gestion des états et des transitions d'état

Les définitions de type d'entités basées sur l'état dans le schéma ClearQuest prennent en charge les éléments suivants :

• un ensemble d'états ;

• les transitions entre états appelées Actions ;

• le comportement de champ associé aux états.

Le convertisseur récupère les états et les actions ClearQuest comme des états et des transitions d'état dans les définitions du type d'élément de travail Team Foundation.

Gestion du formulaire d'élément de travail

Le convertisseur n'effectue pas une migration des informations de formulaire de votre base de données ClearQuest vers Team Foundation. Le convertisseur génère un formulaire d'élément de travail par défaut qui fait partie du schéma généré pendant la phase d'analyse ; toutefois, ce formulaire par défaut ne ressemble pas au formulaire d'origine dans ClearQuest. Le formulaire par défaut contient une mise en forme minimale et nécessite presque toujours des modifications afin de faciliter l'utilisation de la disposition des éléments de travail. Pour plus d'informations sur la modification de formulaires d'élément de travail, consultez Définition du formulaire d'élément de travail.

Contrôles sur le formulaire

Vous pouvez mettre différents contrôles sur un formulaire d'élément de travail dans ClearQuest, en plus de Team Foundation. Team Foundation prend en charge un jeu prédéfini de contrôles que vous pouvez utiliser. Certains contrôles disponibles dans ClearQuest ne sont pas disponibles dans Team Foundation. Bien qu'une quantité maximale de données soit conservée pendant la migration, les différences au niveau des contrôles disponibles affectent l'affichage des données sur le formulaire dans Team Foundation. Les contrôles suivants ne sont pas pris en charge dans Team Foundation.

• Contrôles ActiveX

• Contrôle Calendar

• Contrôle Check Box

• Contrôle Combo Box

• Contrôle Duplicate Base

• Contrôle Duplicate Dependents

• Contrôle Parent/Child

• Contrôle Picture

• Contrôle Push Button

• Contrôle List Box

• Contrôle List view

• Contrôle Option Button

• Contrôle Static Text Box

Dans le cadre de la planification de la migration, vous devez évaluer les conséquences que l'absence de ces contrôles peuvent avoir sur les utilisateurs.

Fichier(s) de mappage de champs

Le fichier des mappages de champs spécifie comment les champs sont mappés et comment les valeurs sont mappées.

Mappage de champs

Les fichiers de mappage de champs spécifient comment les champs dans ClearQuest sont mappés aux champs Team Foundation. La plupart des champs dans ClearQuest, à l'exception des champs système et communs, sont mappés un-à-un à Team Foundation. Vous devez garder ces fichiers de mappage de champs synchronisés avec toutes les modifications que vous apportez aux champs dans les fichiers de définition du type d'élément de travail. Par exemple, si vous renommez un champ dans le fichier de définition du type d'élément de travail, vous devez modifier le fichier de mappage pour spécifier le même mappage. De la même façon, si vous supprimez des champs du fichier de définition du type d'élément de travail, vous devez supprimer ces champs du fichier de mappage de champs correspondant.

Mappage de valeurs

Les fichiers de mappage de champs spécifient également comment les données du champ seront transformées pendant la migration. Par défaut, aucun mappage de valeurs n'est généré. Vous pouvez spécifier les mappages de valeurs si vous souhaitez transformer les données pendant la migration. Vous spécifiez ces transformations à l'aide de mappages de valeurs pour établir qu'une valeur telle que "Pri1" doit être mappée à "1".

Le fichier de mappage de champs est un fichier XML. L'exemple suivant indique comment associer des champs et des valeurs :

<?xml version="1.0"?>

<FieldMaps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <!-- Title is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Headline" to="Title" />

  <FieldMap from="Submitter" to="Submitter">

    <ValueMaps refer="UserMap" />

  </FieldMap>

  <!-- Created Date is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Submit_Date" to="Created Date" />

  <!-- Assigned To is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Owner" to="Assigned To">

    <ValueMaps refer="UserMap" />

  </FieldMap>

</FieldMaps>

Pour plus d'informations sur les mappages de champs, consultez Schéma de fichier de mappage de champ.

Mappage à des champs Chemin de la zone et Chemin de l'itération

Le suivi des éléments de travail Team Foundation organise les éléments de travail en une hiérarchie de zones et d'itérations structurelles. Pour plus d'informations, consultez Comment : modifier les zones du projet d'équipe et Comment : modifier les itérations du projet d'équipe.

Les chemins d'accès sont utilisés pour aider à rassembler les éléments de travail de manière structurelle afin de représenter les différents composants, projets ou applications sur lesquels travaille votre équipe. Les itérations sont utilisées pour aider à rassembler les éléments de travail en fonction des événements principaux tels que les jalons et les phases de projet. Les champs système Chemin de la zone et Chemin de l'itération définissent ces informations dans Team Foundation. Étant donné que ClearQuest ne possède aucun concept de ce type, le convertisseur fournit une valeur par défaut pour ces champs ; la valeur par défaut consiste en ce que tous les éléments de travail vont à la racine du chemin de la zone et du chemin de l'itération.

Bien que ClearQuest ne fournisse pas de chemin de la zone et de chemin de l'itération, il est possible que vous utilisiez les concepts d'une autre façon. Par exemple, dans vos types d'éléments de travail, vous pouvez avoir un champ qui désigne le projet particulier auquel un élément de travail appartient. Cela correspond approximativement au concept de Chemin de la zone. De la même façon, vous pouvez avoir un autre champ nommé "Fix By" qui désigne le jalon par lequel vous souhaitez qu'un élément de travail particulier soit résolu. Songez à associer ces champs au Chemin de la zone et au Chemin de l'itération afin que les éléments de travail apparaissent à des nœuds différents au lieu d'apparaître tous à un seul nœud racine. Les mappages sont spécifiés dans les fichiers de mappage de champs du type d'élément de travail comme expliqué précédemment.

L'exemple de code XML suivant illustre comment associer un champ ClearQuest nommé Tree Path aux valeurs possibles Area1 et Area2.

<FieldMap from="Tree Path" to="Area Path" exclude="false">

<ValueMaps>

  <ValueMap from="Area1" to="Area1" />

  <ValueMap from="Area2" to="Area2" />

</ValueMaps>

</FieldMap>

L'exemple de code XML suivant illustre comment associer un champ ClearQuest nommé Fix By aux valeurs possibles Alpha et Beta.

<FieldMap from="Fix By" to="Iteration Path" exclude="false">

<ValueMaps>

  <ValueMap from= "Alpha" to="Alpha"/>

  <ValueMap from= "Beta" to="Beta"/>

</ValueMaps>

</FieldMap>

Fichier de mappage utilisateur

Le fichier de mappage utilisateur spécifie comment les utilisateurs sont mappés entre ClearQuest et Team Foundation. Pour plus d'informations, consultez Schéma de fichier de mappage utilisateur.

Fichier de mappage de schéma

Le fichier de mappage de schéma spécifie le type de l'élément de travail de la source, le type d'élément de travail de la cible, le fichier de définition d'élément de travail et le fichier de mappage de champs. Pour plus d'informations, consultez Comment : modifier le fichier de mappage de schéma.

Fichier de rapport d'analyse

Un fichier de rapport d'analyse est généré à la fin de la migration. Le rapport de migration est nommé CQAnalysisReport.xml et est généré dans le dossier à partir duquel CQConverter a été exécuté. Un dossier associé nommé _MigrationReport_Files contient les fichiers image et une feuille de style permettant d'afficher le rapport dans un navigateur. À la fin de l'analyse, vous devez ouvrir ce fichier pour afficher toutes les erreurs ou les avertissements détectés pendant la phase d'analyse. Le rapport d'analyse affiche les éléments suivants :

• **Résumé   **Informations résumées sur l'opération d'analyse.

• **Erreurs   **Toutes les erreurs détectées au cours de l'opération d'analyse. Vous devez prendre des mesures appropriées pour toutes les erreurs répertoriées.

• **Avertissements   **Tous les avertissements détectés au cours de l'opération d'analyse. Les avertissements requièrent votre attention, mais les problèmes qu'ils décrivent ne doivent pas nécessairement être résolus.

• Sortie   Cette section répertorie les fichiers de sortie qui ont été générés.

Fichier journal

Le convertisseur génère un fichier journal nommé CQConverter.log. Ce fichier est utilisé pour le débogage et en général, vous ne devez pas examiner ce fichier. Le fichier journal est créé dans le dossier à partir duquel CQConverter a été exécuté. Il contient des messages de trace et peut être utile pour le débogage des problèmes détectés lors de l'exécution du convertisseur.

Le niveau du traçage est contrôlé en définissant la valeur de l'attribut MinLevelForAllSource dans le fichier CQConverter.exe.config. Le fichier CQConverter.exe.config se trouve dans le même dossier que CQConverter.exe. Vous pouvez définir une valeur de 1, qui représente l'importance la plus faible du traçage, jusqu'à 4, qui représente l'importance la plus haute.

Remarque :
Sachez que les performances du convertisseur sont plus lentes à des niveaux de traçage supérieurs et le fichier journal peut devenir très volumineux.

Fichier d'erreurs

Le convertisseur génère également un fichier qui contient toutes les erreurs détectées lors de l'exécution du convertisseur. Le fichier est nommé ConverterErrors.txt et est généré dans le même dossier à partir duquel CQConverter a été exécuté.

Voir aussi

Tâches

Comment : modifier le fichier de mappage de schéma

Concepts

Fichier de configuration du convertisseur d'éléments de travail

Référence

Schéma de fichier de mappage utilisateur

Autres ressources

Personnalisation des types d'éléments de travail

Définition du flux de travail des éléments de travail

Définition du formulaire d'élément de travail