Share via

Comment : générer le fichier de configuration du convertisseur

  • Article

Mise à jour : novembre 2007

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

<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 ClearQuest.

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

  • Userid   ID d'utilisateur ClearQuest. L'ID d'utilisateur spécifié doit avoir l'autorisation de super utilisateur pour la base de données ClearQuest.

<VSTS>

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

  • URI   Nom convivial de Team Foundation Server ou URI complet qui se présente sous la forme http://MonServeur:MonPort.

    Si vous utilisez des noms conviviaux, assurez-vous que vous avez ajouté le serveur Team Foundation Server à l'aide de Team Explorer avant d'exécuter le convertisseur.

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

Autres paramètres de configuration

Les autres sections du fichier XML vous permettent d'effectuer des contrôles :

  • ExitOnError   Cette section accepte une valeur True ou False. Sélectionnez True pour quitter en cas d'erreur. Une valeur True indique que si des erreurs sont rencontrées lors de la migration de certains éléments de travail, le convertisseur ClearQuest s'arrête.

    Remarque :

    Ce paramètre s'applique uniquement aux erreurs récupérables. Pour les erreurs irrécupérables, telles que l'impossibilité du convertisseur ClearQuest à se connecter à ClearQuest, le convertisseur s'arrêtera toujours même si le paramètre est False.

  • OutputDirectory   Spécifiez le répertoire de destination des fichiers migré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 sorties. Si le répertoire existe déjà, le convertisseur remplace les fichiers contenus dans ce répertoire.

Autorisations requises

Pour exécuter cette procédure, vous devez avoir les autorisations Active User et Public Folder Administrator pour la base de données ClearQuest. Pour plus d'informations, consultez le Guide de l'administrateur ClearQuest.

Pour créer le fichier de configuration

  1. Collecte 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 ClearQuest. Assurez-vous que cet utilisateur possède les autorisations pour soumettre des problèmes dans ClearQuest.

    • Nom de serveur Team Foundation.

    • Nom du projet d'équipe pour le suivi des éléments de travail Team Foundation (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 enregistrez la requête. Enregistrez la requête sous un nom quelconque, par exemple RequêteTransition.

  3. Sélectionnez un répertoire pour stocker les fichiers qui sont 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>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</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 <NomRequête>, spécifiez RequêteTransition comme nom de requête avec le chemin d'accès à la requête. Consultez la section « Fichier de configuration » précédente de cette rubrique 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 dans le processus de migration.

  6. Enregistrez le fichier, par exemple sous le nom CqConverterConfig.xml.

Remarque :

Enregistrez le fichier à l'aide du codage UTF-8. Par exemple, si vous enregistrez le fichier à l'aide du Bloc-notes, sélectionnez UTF-8 dans la zone Codage de la boîte de dialogue Enregistrer sous

Voir aussi

Autres ressources

Schéma de définition du type d'élément de travail