Share via


Migration des événements d'historique

Mise à jour : novembre 2007

Cette rubrique décrit comment les événements d'historique consignés par Visual SourceSafe sont migrés dans Team Foundation.

Événements d'historique

Les événements d'historique sont migrés dans la zone équivalente de Team Foundation. Cela permet de conserver l'historique de vos fichiers sources. L'historique des versions de fichiers est créé en relisant les événements qui ont créé l'historique. Le tableau suivant décrit le mode de migration de chaque événement d'historique :

Événement

Mode de migration

Ajouter un fichier ou un dossier

L'événement d'ajout de fichier crée la première version du fichier dans Team Foundation. L'événement d'ajout de dossier crée la première version du dossier dans Team Foundation. Si le dossier contenait des fichiers ou des dossiers lors de son ajout, ces fichiers et ces dossiers sont ajoutés séparément. 

Modifier le fichier

L'événement de modification de fichier crée une version du fichier dans Team Foundation.

Étiqueter un fichier

Dans Team Foundation, vous appliquez une étiquette à une version d'un fichier ou d'un dossier. Dans Visual SourceSafe, vous pouvez étiqueter explicitement ou implicitement un fichier. Lorsqu'un fichier est étiqueté explicitement dans Visual SourceSafe, une nouvelle version du fichier est créée et si effectuez une opération d'obtention sur cette étiquette, vous obtenez le contenu du fichier qui correspond à la version antérieure du fichier. Pour migrer explicitement des étiquettes, le convertisseur applique dans Team Foundation l'étiquette à la version qui correspond à la version étiquetée dans Visual SourceSafe. Toutefois, il ne crée pas de nouvelle version.

Lorsque vous appliquez une étiquette d'un dossier dans Visual SourceSafe, l'étiquette est appliquée implicitement à tous les fichiers et les dossiers situés sous le dossier et ne crée pas de nouvelles versions. Pour les étiquettes implicites, le convertisseur ne fait rien parce que les versions correspondantes dans Team Foundation sont étiquetées automatiquement pendant la migration des étiquettes explicites sur le dossier.

Étiqueter un dossier

Dans Visual SourceSafe, lorsque vous appliquez une étiquette à un dossier, tous les fichiers et les dossiers de ce dossier sont implicitement étiquetés et aucune nouvelle version n'est créée. Pendant la migration de ces dossiers, le convertisseur applique l'étiquette à la version correspondante du dossier dans Team Foundation. Cela applique automatiquement l'étiquette aux versions actuelles des fichiers et des dossiers du dossier étiqueté.

Renommer, supprimer ou restaurer un fichier ou un dossier

Pendant la migration d'événements renommées, supprimés et restaurés d'un fichier ou d'un dossier, le convertisseur relit l'événement pour créer une nouvelle version du fichier et du dossier dans Team Foundation.

Déplacer un dossier

L'événement Déplacer un dossier crée une nouvelle version du dossier dans Team Foundation. Dans Visual SourceSafe, la commande de déplacement ne change pas le contenu ou l'historique du dossier ; elle est plutôt enregistrée dans l'historique du nouveau ou de l'ancien dossier parent. Lorsque vous déplacez un dossier, Visual SourceSafe ne peut pas reconstruire une ancienne version du dossier parent.

Après la migration, vous pourrez reconstruire une ancienne version en raison du mode de migration de l'événement Déplacer un dossier. Par exemple, si vous avez appliqué l'étiquette « ÉTIQUETTE1 » au dossier $/A qui possède un sous-dossier /B et que vous déplacez ensuite /B vers un autre dossier $/C ; dans Visual SourceSafe, si vous effectuez une opération d'obtention sur « ÉTIQUETTE1 » sur $/A, vous n'obtiendrez pas $/A/B. Toutefois, après la migration vers Team Foundation, vous obtiendrez le dossier déplacé ($/A/B) si vous effectuez une opération d'obtention sur l'étiquette.

Lorsque vous migrez des dossiers déplacés, trois scénarios possibles peuvent se présenter avec des résultats différents selon le contenu migré :

  • Les dossiers source et de destination sont migrés. Aucune perte de données. Dans le précédent exemple, les dossiers source $/A et de destination $/C sont migrés.

  • Seul le dossier de destination est migré. Après la migration, le dossier déplacé apparaît dans le dossier de destination comme s'il avait été ajouté lors de son déplacement. L'historique du dossier déplacé et les éléments qu'il contenait avant l'événement de déplacement ne sont pas migrés dans Team Foundation. À l'aide de l'exemple précédent, l'événement de déplacement du sous-dossier /B apparaîtra dans $/C comme un événement d'ajout de dossier. Pour éviter de perdre l'historique, migrez simultanément les dossiers source et de destination du dossier déplacé. Lorsque vous exécutez l'analyse de migration, le rapport contient une section qui vous avertit de cette perte de données.

  • Seul le dossier source est migré. Pendant la migration, l'historique du dossier déplacé et les éléments qu'il contient ne sont pas migrés vers Team Foundation. Pour éviter de perdre l'historique, migrez simultanément les dossiers source et de destination du dossier Visual SourceSafe déplacé. Lorsque vous exécutez l'analyse de migration, le rapport contient une section qui vous avertit de cette perte de données.

Remarque :

Si l'événement du dossier de déplacement est associé à un événement de restauration, l'historique peut ne pas migrer correctement.

Partager des fichiers

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ù il est partagé. Visual SourceSafe crée en interne des liens souples entre des fichiers partagés. Les dossiers ne sont pas partagés techniquement dans Visual SourceSafe. Lorsque vous partagez un dossier dans Visual SourceSafe, une copie du dossier est créée et tous les fichiers du dossier sont partagés.

Team Foundation ne possède pas d'équivalent pour le partage. Les fichiers partagés sont migrés en créant une version dans le dossier de destination avec le même contenu que la version du fichier au début du partage. À partir de ce point, les modifications apportées au fichier partagé sont répliquées aux deux emplacements par le convertisseur.

Partager et supprimer un fichier

Un fichier qui est partagé puis supprimé est traité comme un fichier partagé, mais toutes les actions consécutives à la suppression sont ignorées.

Si le fichier partagé supprimé est restauré ultérieurement, le convertisseur rapporte les erreurs qui ont eu lieu pendant la migration pour chaque action, telle que la modification ou le changement de nom. Toutefois, pendant la migration de l'action de restauration, le convertisseur effectue une opération de restauration-modification sur le fichier afin qu'il ait le même contenu que celui du fichier restauré dans Visual SourceSafe.

Si le fichier partagé supprimé est renommé ultérieurement, le convertisseur rapporte les erreurs qui ont eu lieu pendant la migration de l'action de changement de nom. Les actions effectuées après le changement de nom ne seront pas migrées et le convertisseur rapporte l'erreur pour chaque action.

Brancher des fichiers

Le partage est une condition préalable à la création de branches. Le convertisseur ne peut pas associer une branche Visual SourceSafe à une branche de contrôle de version Team Foundation. La migration d'un fichier partagé crée un réplica du fichier dans le dossier de destination. La migration d'événements de branche signifie que les modifications apportées à un fichier partagé ne sont plus répliquées dans les deux emplacements. Par conséquent, les modifications apportées à une branche sont migrées vers la copie respective dans Team Foundation. Le rapport de migration fournit une liste des dossiers qui contiennent des fichiers qui sont partagés ou comportent des branches dans Visual SourceSafe.

Archiver

Lorsque vous archivez des fichiers ou des dossiers dans Visual SourceSafe, vous pouvez supprimer complètement l'historique d'un fichier ou d'un dossier ou supprimer des versions de l'historique d'un fichier ou d'un dossier. Si vous avez supprimé l'historique, le convertisseur migre les versions supprimées. Le convertisseur ignore l'événement d'archivage.

Restaurer

Lorsque vous effectuez une restauration dans Visual SourceSafe, vous restaurez l'historique d'un fichier ou d'un dossier archivé. Le convertisseur migre l'historique restauré des fichiers et des dossiers. Le convertisseur ignore l'événement de restauration.

EN ATTENTE et SANS ATTENTE

Le contrôle de version Team Foundation ne prend pas en charge l'épinglage. Par conséquent, tous les fichiers en attente sont migrés en créant deux étiquettes. L'étiquette PINNED_LATEST est appliquée aux versions en attente des fichiers en attente et à la version la plus récente des fichiers sans attente. L'étiquette PINNED est uniquement appliquée aux versions en attente des fichiers en attente. Après la migration, l'étiquette PINNED_LATEST récupérera les mêmes fichiers qu'une commande Obtenir la dernière version dans Visual SourceSafe. Toutefois, 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, tel qu'un changement de nom ou une suppression du fichier.

Voir aussi

Concepts

Comment le convertisseur groupe les ensembles de modifications pour améliorer les performances

Autres ressources

Planification de la migration du contrôle de code source