Comment : créer un fichier de paramètres pour l'analyse et la migration du contrôle de code source

Article
08/22/2008

Mise à jour : novembre 2007

Vous créez un fichier de paramètres pour contrôler le mode de migration et d'analyse des données de contrôle de code source dans Team Foundation. Vous créez un fichier de paramètres pour analyser le processus de migration en identifiant d'abord tous les problèmes qui peuvent se produire pendant la migration, puis en modifiant ce fichier de paramètres afin d'exécuter réellement la migration.

Avant de créer le fichier de paramètres, vous devez :

Identifier les dossiers dans Visual SourceSafe que vous souhaitez migrer.
Pour la migration, identifiez l'emplacement où vous souhaitez migrer vos dossiers Visual SourceSafe : dossiers vides ou dossiers de destination où le convertisseur peut créer des dossiers dans le contrôle de version Team Foundation. Le convertisseur ne crée pas un dossier de destination si le dossier se trouve dans le dossier racine ($/) dans le contrôle de version Team Foundation.
Pour mapper des utilisateurs Visual SourceSafe à des utilisateurs Team Foundation Server, utilisez le fichier de mappage utilisateur généré pendant l'analyse. Pour plus d'informations, consultez Comment : modifier le fichier de mappage utilisateur relatif à la migration du contrôle de code source.

Le format du fichier de paramètres est légèrement différent lorsque vous exécutez l'analyse de celui utilisé pour la migration. Les différences sont soulignées dans les sections suivantes.

Pour créer un fichier de paramètres pour l'analyse

Créez un fichier XML en utilisant un éditeur, tel que le Bloc-notes.
Copiez le texte de la section Format du fichier de paramètres pour l'analyse du Fichier des paramètres du convertisseur VSS, exemple dans le fichier XML.
Dans la section <VSSDatabase>, spécifiez l'emplacement de la base de données Visual SourceSafe sur laquelle vous exécutez l'analyse.
Vous pouvez éventuellement spécifier un nom et un emplacement pour le fichier de mappage utilisateur dans la section <UserMap>. Si vous ne fournissez pas de nom de fichier, le convertisseur génère le fichier nommé UserMap.xml dans le dossier actif.
Dans la section <ProjectMap>, spécifiez les dossiers Visual SourceSafe à analyser.
Sous la section <Settings>, dans la section <Output>, vous pouvez spécifier le nom de fichier et l'emplacement du rapport d'analyse. Si vous ne spécifiez pas de nom de fichier, le convertisseur génère le fichier nommé VSSAnalysisReport.xml.
Enregistrez le fichier de paramètres en tant que fichier XML (avec une extension de fichier .xml).

Pour créer un fichier de paramètres pour la migration

Copiez le fichier de paramètres que vous avez créé pour l'analyse et enregistrez-le sous un nouveau nom. Pour référence, consultez « Format du fichier de paramètres pour la migration » dans le Fichier des paramètres du convertisseur VSS, exemple.

Modifiez le fichier de paramètres de migration comme suit.

Dans la section <ProjectMap>, pour chaque dossier Visual SourceSafe migré, ajoutez les dossiers de destination dans le contrôle de version Team Foundation. Utilisez le format suivant pour ajouter une section Destination :

<Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>

Remarque :
Si votre source de projet est $/FolderA et que votre destination est $/TeamProjectB/ProjectB, un projet Visual SourceSafe$/FolderA/ProjectA devient $/TeamProjectB/ProjectB/ProjectA dans contrôle de version Team Foundation, au lieu de $/TeamProjectB/ProjectB/FolderA/ProjectA.

Sous la section <Settings>, ajoutez une section <TeamFoundationServer> et spécifiez le nom, le port et le protocole du serveur Team Foundation Server vers lequel vous migrez. Utilisez le format suivant :
```
<TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>
```
Par exemple :
```
<TeamFoundationServer name="My_TFS_server" port="8080" protocol="http"></TeamFoundationServer>
```

Vous pouvez éventuellement spécifier le nom de fichier et l'emplacement du rapport d'analyse sous la section <Settings>, dans la section <Output>. Si vous ne fournissez pas de nom de fichier, le convertisseur génère le fichier nommé VSSMigrationReport.xml.

Remarque :
Le convertisseur utilise SQLExpress pendant la migration pour stocker des métadonnées. Ces métadonnées prennent en général un pourcentage réduit de données pendant la migration.

Dans l'éventualité improbable que votre migration échoue en raison de la limite des 4 Go de SQLExpress, vous pouvez définir le convertisseur pour qu'il utilise plutôt SQLServer en ajoutant la ligne suivante à la section <Source name="VSS" du fichier de paramètres : <SQL Server="SQL_Server_name"></SQL> Par exemple :

<Source name="VSS">
   <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
   <SQL Server="MySQLServer"></SQL>
</Source>

Enregistrez le fichier de paramètres en tant que fichier XML (avec une extension de fichier .xml).

Voir aussi

Tâches

Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation

Procédure pas à pas : migration de Visual SourceSafe vers Team Foundation

Comment : créer un projet d'équipe

Comment : ajouter un projet ou une solution au contrôle de version

Concepts

Fichier des paramètres du convertisseur VSS, exemple

VSSConverter, utilitaire en ligne de commande pour la migration du contrôle de code source

Partager via