Comprendre comment des outils de mise à niveau VSS convertissent vos données

Les outils de mise à niveau Visual SourceSafe sont une méthode pratique pour une mise à niveau unique et définitive de votre base de code de Visual SourceSafe vers Team Foundation Server (TFS).Vous devez utiliser des outils pour mettre à niveau vos données uniquement lorsque vous êtes prêt à arrêter d'y accéder dans Visual SourceSafe et à commencer à les conserver dans TFS.

TFS et Visual SourceSafe présentent des différences fonctionnelles significatives.Par conséquent, les outils visuels de mise à niveau Visual SourceSafe modifient certains types de données pendant la mise à niveau.

Dans cette rubrique

• Façon dont les ensembles de modifications sont créés

• Façon dont les éléments partagés et épinglés sont mis à niveau

• Façon dont les données d'historique sont déplacées

  • Mode de déplacement des données relatives au nom d'utilisateur et à l'horodatage

  • Mode de conversion des types d'événements spécifiques

• Façon dont les liaisons de contrôle de version sont déplacées

Façon dont les ensembles de modifications sont créés

Le contrôle de version TFS regroupe les modifications de plusieurs fichiers en une seule unité lorsqu'un utilisateur archive un ensemble de modifications.Cette unité unique s'appelle un ensemble de modifications.

Visual SourceSafe n'a pas de fonctionnalité équivalente aux ensembles de modifications.Toutefois, durant le processus de conversion, chaque ensemble de modifications est regroupé en un ensemble de modifications tant que les conditions suivantes sont remplies :

• Les modifications ne sont pas en conflit entre elles.Par exemple, deux actions n'affectent pas le même fichier ou dossier.

• Les modifications ne se sont produites qu'à quelques minutes d'intervalle, l'une de l'autre.

• Les modifications ont été archivées par le même utilisateur.

• Les modifications ont le même commentaire d'archivage.

Façon dont les éléments partagés et épinglés sont mis à niveau

Dans Visual SourceSafe, vous pouvez partager un fichier dans plusieurs dossiers.Les modifications que vous apportez dans un fichier partagé sont répliquées dans les dossiers où le fichier est partagé.Le contrôle de version TFS n'a pas de fonctionnalité équivalente.Pendant la mise à niveau, les fichiers partagés de votre projet Visual SourceSafe sont mis à niveau par la création d'une copie indépendante supplémentaire de l'élément sur votre serveur pour le contrôle de version TFS.

Le contrôle de version TFS n'a pas non plus de fonctionnalité équivalente à la fonctionnalité d'épinglage dans Visual SourceSafe.Pendant la mise à niveau, les éléments épinglés dans le projet Visual SourceSafe sont convertis en éléments étiquetés sur votre serveur pour le contrôle de version TFS.Pour plus d'informations, consultez la section suivante.

Façon dont les données d'historique sont déplacées

Chaque événement de l'historique d'un élément de votre base de données Visual SourceSafe est transféré sur votre serveur de Team Foundation Server en tant qu'ensemble de modifications.Une fois la mise à niveau effectuée, vous pouvez consulter ces données dans la fenêtre Historique.Pour plus d'informations, consultez Obtenir l'historique d'un élément.

Certaines modifications sont apportées aux données durant la mise à niveau.

Mode de déplacement des données relatives au nom d'utilisateur et à l'horodatage

Chaque fois qu'une entrée de l'historique d'un élément de votre base de données Visual SourceSafe est mise à niveau vers un ensemble de modifications sur votre serveur Team Foundation Server, les modifications suivantes se produisent :

• L'horodatage de l'ensemble de modifications a la valeur de l'horodatage de la mise à niveau de l'élément.

• L'horodatage d'origine est stocké dans le champ des commentaires de l'ensemble de modifications.

• Le nom d'utilisateur est stocké dans le champ de l'utilisateur ou le champ des commentaires de l'ensemble de modifications, selon le résultat du processus de mappage utilisateur.

  [!REMARQUE]

  Si vous souhaitez contrôler la manière dont les noms d'utilisateurs sont assignés aux données historiques, vous devez utiliser VssUpgrade.Consultez Spécifier la façon dont les noms d'utilisateurs sont mis à niveau.

Mode de conversion des types d'événements spécifiques

Les événements tels que la modification, le changement de nom et la suppression sont mis à niveau de manière simple de votre base de données Visual SourceSafe vers les ensembles de modifications sur votre serveur Team Foundation Server.Toutefois, les outils de mise à niveau convertissent certains événements de manière parfois inattendue, comme le montre le tableau suivant.

Événement Visual SourceSafe	Façon dont il est mis à niveau dans le contrôle de version TFS
Ajouter un fichier ou un dossier	Cet ensemble de modifications est le premier événement de l'historique de chaque fichier et dossier mis à niveau.Contrairement à Visual SourceSafe, aucun événement n'est enregistré pour le parent de chaque élément enfant qu'il contient.
Création de branche	Dans Visual SourceSafe, le partage est une condition préalable de branchement, mais le contrôle de version TFS ne prend pas en charge le partage. Par conséquent, la mise à niveau d'un fichier qui possède des branches crée une copie du fichier dans le dossier de destination. Les fichiers partagés de votre base de données Visual SourceSafe sont mis à niveau vers le contrôle de version TFS comme suit : la version du fichier qui existait lorsqu'il était partagé est copiée et placée dans le dossier de destination.Par la suite, chaque ensemble de modifications est répliqué dans les deux copies du fichier jusqu'à ce que l'événement de branche se produise.
Étiquette	Éléments implicitement étiquetés : dans Visual SourceSafe, lorsque vous étiquetez un dossier, les éléments qu'il contient sont implicitement étiquetés.Le processus de mise à niveau étiquette explicitement tous les éléments mis à niveau dans votre projet d'équipe. Fichiers étiquetés explicitement : dans Visual SourceSafe, lorsque vous étiquetez explicitement un fichier individuel, une nouvelle version du fichier est créée. Le processus de mise à niveau transfère l'étiquette vers la version applicable dans le contrôle de version TFS, mais ne crée pas de nouvelle version. Remarque Si votre base de données Visual SourceSafe contient de nombreuses étiquettes appliquées à de nombreux fichiers, le processus de mise à niveau peut se prolonger.Si vous souhaitez exclure ces données, vous devez utiliser VssUpgrade et le configurer pour ignorer les étiquettes.Consultez <Label migrate="false" />.
Déplacer un dossier	L'événement relatif au déplacement d'un dossier entraîne la création d'une autre version du dossier dans le contrôle de version TFS. VssUpgrade ne met pas à niveau l'historique complet des éléments des dossiers déplacés, sauf si les dossiers sources et de destination sont mis à niveau en même temps.Consultez Passer en revue et résoudre les problèmes détectés par la fonctionnalité d'analyse. Remarque Si l'événement de déplacement d'un dossier est associé à un événement de restauration, les données d'historique risquent de ne pas être mises à niveau correctement.
Restaurer	Aucune donnée d'historique antérieure à un événement de restauration n'est mis à niveau.
PIN et UNPIN	Le contrôle de version TFS ne prend pas en charge l'épinglage.Les outils de mise à niveau mettent à niveau un fichier épinglé en créant deux étiquettes. L'étiquette PINNED_LATEST est appliquée aux versions épinglées des fichiers épinglés et à la version la plus récente des fichiers désépinglés.L'étiquette PINNED est uniquement appliquée aux versions épinglées des fichiers épinglés.Après la mise à niveau, l'étiquette PINNED_LATEST récupérera les mêmes fichiers qu'une commande Obtenir la dernière version dans Visual SourceSafe.Il existe toutefois une exception : l'étiquette PINNED_LATEST peut retourner des fichiers différents si des événements autres qu'un archivage ont eu lieu après l'épinglage d'un fichier, par exemple un changement de nom ou une suppression du fichier.
Partage	Le contrôle de version TFS ne prend pas en charge le partage.Les fichiers partagés de votre base de données Visual SourceSafe sont mis à niveau vers le contrôle de version TFS comme suit : la version du fichier qui existait lorsqu'il était partagé est copiée et placée dans le dossier de destination.Par la suite, chaque ensemble de modifications est répliqué dans les deux copies du fichier.
Restaurer un fichier ou un dossier	Durant la mise à niveau d'événements de restauration d'un fichier ou d'un dossier, les outils relisent l'événement afin de créer une autre version du fichier et du dossier dans le contrôle de version TFS. Les outils de mise à niveau créent un ensemble de modifications qui inclut le nom du fichier ou du dossier, l'horodatage de sa restauration, ainsi que le nom d'utilisateur.

Façon dont les liaisons de contrôle de version sont déplacées

Les outils de mise à niveau transfèrent les liaisons de contrôle de version pour chaque solution.

Étape suivante

Préparer une mise à niveau à partir de Visual SourceSafe