Utilisation de jeux de réservations

  • Article

La réservation vous permet de mettre de côté temporairement un lot de modifications en attente et de supprimer éventuellement les modifications en attente à partir de l'espace de travail. Le résultat de l'opération de réservation est un jeu de réservations. Les modifications effectuées dans un jeu de réservations peuvent être restaurées ultérieurement dans votre espace de travail ou dans l'espace de travail d'un autre utilisateur.

Différence entre les ensembles de modifications et les jeux de réservations

Lorsque vous archivez une ou plusieurs des modifications en attente dans votre espace de travail, Team Foundation crée un ensemble de modifications dans le serveur de contrôle de code source. Un ensemble de modifications contient un groupe de révisions de fichier source, des notes d'archivage, un commentaire et des liens vers les éléments de travail associés. De la même façon, un jeu de réservations contient un groupe de révisions de fichier source, des notes d'archivage, des commentaires et une liste d'éléments de travail associés. Toutefois, un jeu de réservations ne contient pas de collection des modifications de fichier validé et géré dans la version. Les jeux de réservations et les ensembles de modifications sont stockés sur le serveur de Team Foundation et peuvent être récupérés dans un espace de travail par les utilisateurs disposant des autorisations suffisantes.

Autres différences entre les ensembles de modifications et les jeux de réservations :

  • Contrairement à un ensemble de modifications, un jeu de réservations est une entité sans version. Si un utilisateur, vous ou un autre, déréserve les éléments d'un jeu de réservations, modifie plusieurs fichiers, puis réserve à nouveau le jeu de réservations, Team Foundation ne crée pas de nouvelle version des éléments pour les comparer ultérieurement et ne conserve aucun enregistrement sur l'auteur, le moment ou la méthode. Le jeu de réservations d'origine est entièrement remplacé.

  • Vous pouvez supprimer un jeu de réservations, mais vous ne pouvez pas supprimer d'ensemble de modifications.

  • Vous pouvez lier un ensemble de modifications à un élément de travail, pour que, lorsqu'un utilisateur clique sur le lien de l'ensemble de modifications sur l'onglet Liens situé sur le formulaire d'élément de travail, l'ensemble de modifications soit récupéré automatiquement sur l'espace de travail actuel. Ces fonctionnalités ne sont pas prises en charge pour les jeux de réservations.

  • Vous pouvez empêcher ou au moins fortement découragez les utilisateurs de créer un ensemble de modifications qui ne soit pas conforme aux normes de l'équipe établies en créant et en appliquant des stratégies d'archivage. Ces fonctionnalités ne sont pas prises en charge pour les jeux de réservations.

Fonction de la réservation

Réservez vos modifications en attente lorsque vous n'êtes pas prêt à ou que vous ne pouvez pas archiver un jeu de modifications en attente. Cinq scénarios sont possibles :

  • Interruption   Lorsque vos modifications en attente ne sont pas prêtes pour l'archivage et que vous devez exécuter une tâche différente, vous pouvez réserver vos modifications en attente pour les mettre de côté.

  • Intégration   Lorsque vos modifications en attente ne sont pas prêtes pour l'archivage et que vous devez les partager avec un autre membre de l'équipe, vous pouvez réserver vos modifications en attente et demander à un membre de votre équipe de les déréserver.

  • Révision   Lorsque vos modifications en attente sont prêtes pour l'archivage et que leur code doit être révisé, vous pouvez réserver vos modifications et en informer le vérificateur de code du jeu de réservations.

  • Génération   Avant d'archiver vos modifications, vous pouvez utiliser votre système de génération pour vous assurer que les modifications apportées au jeu de réservations ne risquent pas de bloquer vos processus de génération planifiés de manière périodique, par exemple les builds nocturnes. Vous pouvez effectuer cette validation manuellement en mettant en file d'attente une build privée ou en implémentant automatiquement l'archivage contrôlé.

  • Sauvegarde   Lorsque vous souhaitez sauvegarder votre travail en cours et que vous n'êtes pas prêt pour l'archivage, vous pouvez réserver vos modifications pour les conserver sur le serveur de Team Foundation.

  • Transfert de travail   Lorsque votre travail en cours a été terminé par un autre membre de l'équipe, vous pouvez réserver vos modifications pour simplifier le transfert de travail.

Création de jeux de réservations

Les jeux de réservations sont créés à partir de lExplorateur du contrôle de code source, de la fenêtre Modifications en attente ou du menu. Pour plus d'informations sur la création d'un jeu de réservations, consultez Réserver et déréserver des modifications en attente.

Déréservation de modifications réservées

Tandis que vous pouvez restaurer un ensemble de modifications dans un espace de travail à l'aide de la commande Get, vous devez utiliser la Unshelve, commande pour restaurer un jeu de réservations. Vous pouvez utiliser le bouton Déréserver dans la fenêtre Modifications en attente pour restaurer autant de modifications en attente que vous souhaitez dans un jeu de réservations sur votre espace de travail. Pour plus d'informations sur la fenêtre Modifications en attente, consultez Archiver des modifications en attente. Lorsque vous déréservez toutes les modifications dans un jeu de réservations sur un espace de travail à l'aide de Visual Studio, les informations sur les modifications en attente auxquelles les éléments sont associés sont également restaurées sur la fenêtre Modifications en attente. Pour plus d'informations, consultez Réserver et déréserver des modifications en attente.

Lorsque vous déréservez un jeu de réservations, Team Foundation restaure chaque révision réservée dans l'espace de travail de destination en tant que modification en attente tant que la révision n'est pas en conflit avec une modification déjà en attente dans l'espace de travail.

  • Modifications   Team Foundation copie le contenu de la version de l'espace de travail source dans la version de l'espace de travail de destination et extrait le fichier pour le modifier.

  • Suppressions   Les fichiers et les dossiers réservés supprimés lorsqu'ils étaient en attente de l'archivage sur l'espace de travail source sont supprimés dans l'espace de travail de destination.

  • Additions   Les fichiers et les dossiers réservés ajoutés au contrôle de code source lorsqu'ils étaient en attente de l'archivage sur l'espace de travail source sont ajoutés sur l'espace de travail de destination.

  • Renommages et déplacements   Les fichiers et les dossiers réservés qui ont été renommés ou déplacés sur l'espace de travail source sont renommés et déplacés dans leurs nouveaux dossiers dans l'espace de travail de destination.

    Important

    Pour déréserver un élément, il ne doit pas avoir de révision en attente dans l'espace de travail de destination.

Comparaison d'un fichier réservé et de la version de base de son jeu de réservations

Vous pouvez utiliser la commande Unshelve dans Visual Studio ou utiliser la Difference, commande à partir de la ligne de commande pour comparer autant de révisions de fichiers réservés que vous le souhaitez dans un jeu de réservations à la version du jeu de réservations de base, qui est la version de serveur de l'élément sur lequel il se base.

Suppression de jeux de réservations

Contrairement aux ensembles de modifications qui sont stockés définitivement sur le serveur de contrôle de code source, vous pouvez supprimer des jeux de réservations du serveur.

Avertissement

Contrairement à un fichier supprimé, un jeu de réservations est définitivement supprimé et vous ne pouvez pas le récupérer à partir du contrôle de code source.

Pour plus d'informations sur la suppression d'un jeu de réservations à l'aide de Visual Studio, consultez Supprimer un jeu de réservations. Pour plus d'informations sur la suppression de jeux de réservations à l'aide de l'interface de ligne de commande, consultez Shelve, commande.

Dans cette section

Référence

Référence de la ligne de commande du contrôle de version Team Foundation

Voir aussi

Tâches

Mettre une build en file d'attente

Concepts

Utilisation d'ensembles de modifications

Définir une build d'archivage contrôlé pour la validation des modifications