Créer et utiliser avec des espaces de travail

Les espaces de travail mappent les dossiers de Visual Studio Team Foundation Server aux dossiers situés sur votre ordinateur local, ce qui est indispensable si vous voulez utiliser les fichiers sous contrôle de version de votre équipe. Lorsque vous téléchargez (ou « obtenez ») pour la première fois les copies locales des fichiers de Team Foundation Server, vous spécifiez un dossier local à cet effet. Bien que vous puissiez ne pas le remarquer sur le moment, cette action crée un espace de travail par défaut qui mappe le dossier serveur sélectionné au dossier local sélectionné, puis enregistre ce mappage.

Toutefois, au lieu d'utiliser l'espace de travail par défaut, vous pouvez créer un espace de travail manuellement. Cette option est recommandée si vous comptez utiliser fréquemment des fichiers sous contrôle de version ou si vous envisagez d'utiliser des fichiers situés dans plusieurs dossiers.

Lorsque vous créez un espace de travail manuellement, vous sélectionnez des dossiers sous contrôle de version spécifiques afin de constituer un groupe logique et isolé. Vous pouvez ensuite effectuer les actions suivantes sur les fichiers contenus dans ces dossiers en tant que groupe :

• actualiser les copies locales pour vous assurer que vous disposez des toutes dernières versions afin de pouvoir générer et tester vos modifications localement ;

• extraire les fichiers à modifier ;

• archiver, réserver ou annuler des modifications en attente ;

• afficher les modifications en attente effectuées par d'autres membres de l'équipe afin de pouvoir anticiper les conflits avant l'archivage des modifications.

Cette rubrique décrit les conditions d'utilisation de l'espace de travail, montre comment créer un espace de travail complexe et traite des problèmes usuels relatifs aux espaces de travail. Pour plus d'informations sur la façon d'obtenir des copies locales des fichiers ou sur l'ajout de fichiers au contrôle de version, consultez Obtenir la source de votre projet d'équipe et Ajout de fichiers au contrôle de version.

Dans cette rubrique

• Instructions de base pour créer un espace de travail

• Conditions d'utilisation de l'espace de travail

• Obtenir des fichiers rapidement à l'aide de l'espace de travail par défaut

• Créer un espace de travail manuellement

• Utilisation de plusieurs espaces de travail pour plusieurs branches

• Résolution des problèmes courants

Instructions de base pour créer un espace de travail

Lorsque vous créez un espace de travail, vous devez tenir compte des instructions suivantes :

• Si vous souhaitez utiliser les fichiers d'un seul dossier, mappez un dossier aussi proche que possible du niveau de la collection de projets d'équipe mais pas trop. De cette façon, vous obtiendrez tous les fichiers dont vous avez besoin et uniquement ces derniers.

• Créez un espace de travail complexe qui contient plusieurs mappages uniquement si vous voulez disposer de fichiers provenant de domaines disparates dans votre arborescence de code source ou si vous voulez utiliser le masquage pour limiter le nombre de fichiers provenant d'un dossier.

• Si vous utilisez plusieurs branches, créez un espace de travail distinct pour chaque branche afin d'isoler les branches sur votre ordinateur local.

• Si vous projetez de créer une build locale pour tester vos modifications avant d'archiver les fichiers, mappez tous les fichiers nécessaires à la build, pas seulement ceux que vous avez l'intention de modifier.

Conditions d'utilisation de l'espace de travail

Lorsque vous commencez à utiliser les espaces de travail, vous devez comprendre les rôles joués par les dossiers locaux et les dossiers serveur, ainsi que par l'espace de travail qui assure leur mappage.

1. Les dossiers serveur contiennent le code et des fichiers relatifs à votre projet d'équipe. Les membres de l'équipe peuvent partager les fichiers sous contrôle de version, assurer le suivi des modifications apportées à ces derniers et les restaurer à des versions antérieures. Pour lister les dossiers serveur de votre projet d'équipe, ouvrez Team Explorer, puis double-cliquez sur Contrôle de code source.

2. Les dossiers locaux contiennent les fichiers que vous « obtenez » ou extrayez à partir du serveur de contrôle de version sur votre ordinateur local. Lorsque vous obtenez un fichier, vous téléchargez une copie en lecture seule de ce dernier dans votre dossier local. Lorsque vous extrayez un fichier, vous téléchargez une copie que vous pouvez modifier. Lorsque vous enregistrez des fichiers modifiés, les modifications sont enregistrées localement et sont validées sur le serveur uniquement lorsque vous archivez les fichiers.

3. Les espaces de travail mappent les dossiers serveur aux dossiers locaux. Vous pouvez créer un espace de travail simple qui mappe un seul dossier serveur à un seul dossier local, ou vous pouvez créer un espace de travail complexe qui se compose de plusieurs mappages. Si un espace de travail se compose de plusieurs mappages, il regroupe les dossiers en une seule unité sur laquelle vous pouvez effectuer des actions, par exemple l'obtention des dernières versions à partir du serveur ou l'archivage des modifications. Pour lister les mappages d'un espace de travail, ouvrez le menu Fichier, cliquez sur Contrôle de code source, puis sur Espaces de travail. Dans la boîte de dialogue Espace de travail, sous Espace de travail, cliquez sur l'espace de travail, puis sur Modifier pour ouvrir la boîte de dialogue Modifier l'espace de travail.

Obtenir des fichiers rapidement à l'aide de l'espace de travail par défaut

Lorsque vous utilisez des fichiers qui sont sous contrôle de version dans Team Foundation Server, vous devez vous servir d'un espace de travail. Lorsque vous téléchargez (ou « obtenez ») pour la première fois les copies locales des fichiers de Team Foundation Server, vous spécifiez un dossier local à cet effet. Bien que vous puissiez ne pas le remarquer sur le moment, cette action crée un espace de travail par défaut qui mappe le dossier serveur sélectionné au dossier local sélectionné, puis enregistre ce mappage.

Pour obtenir des fichiers rapidement à l'aide de l'espace de travail par défaut

1. Ouvrez Visual Studio, puis connectez-vous à votre projet d'équipe.

   Pour plus d'informations, consultez Se connecter aux projets d'équipe et y accéder dans Team Foundation Server.

2. Dans Team Explorer, cliquez sur Contrôle de code source.

   Notes

   Si vous n'avez pas encore créé d'espace de travail, celui-ci est créé automatiquement lorsque vous ouvrez l'Explorateur du contrôle de code source. L'espace de travail porte le même nom que votre ordinateur et s'affiche dans la liste Espace de travail située dans la barre d'outils de l'Explorateur du contrôle de code source.

3. Cliquez avec le bouton droit sur le projet d'équipe, le dossier ou la branche dont vous voulez télécharger des copies locales de fichiers, puis cliquez sur Mapper avec le dossier local.

   Important

   Veillez à sélectionner un dossier situé à un niveau assez élevé dans l'arborescence du code afin d'obtenir tous les fichiers vous permettant de créer une build locale. Toutefois, évitez de choisir un niveau trop élevé pour ne pas obtenir plus de fichiers que nécessaire.

   La boîte de dialogue Mapper s'ouvre.

4. Sous Dossier local, cliquez sur le bouton de sélection (…) afin d'accéder à l'emplacement que vous souhaitez utiliser pour les copies locales des fichiers serveur.

5. Dans la boîte de dialogue Rechercher un dossier, spécifiez l'emplacement des copies locales.

   Par exemple, tapez C:\.

6. Cliquez sur Créer un nouveau dossier, puis tapez le nom du nouveau dossier dans lequel les copies locales doivent être téléchargées.

   Par exemple, tapez Espaces de travail.

7. Dans la boîte de dialogue Rechercher un dossier, cliquez sur OK.

8. Dans la boîte de dialogue Mapper, activez la case à cocher Récursif pour télécharger tous les fichiers des dossiers situés sous le dossier serveur, puis cliquez sur Mapper.

9. Dans la boîte de message qui s'affiche, cliquez sur Oui pour obtenir les dernières versions des fichiers mappés.

Créer un espace de travail manuellement

Vous devez créer un espace de travail manuellement si vous comptez utiliser fréquemment des fichiers sous contrôle de version. Un espace de travail créé manuellement peut consister simplement en un mappage unique entre le dossier de niveau supérieur d'un projet d'équipe et un dossier situé sur votre ordinateur local. Toutefois, un espace de travail peut également être un mappage complexe de tous les sous-dossiers d'un dossier, de la plupart des sous-dossiers d'un autre dossier et des sous-dossiers sélectionnés d'un troisième dossier.

1. Pour mapper tous les sous-dossiers d'un dossier, ajoutez ce dernier à la colonne Dossier du contrôle de code source. Dans la colonne Dossier local, spécifiez un seul dossier local pour les copies locales des fichiers.

2. Pour mapper une partie mais pas la totalité des sous-dossiers d'un dossier, ajoutez ce dernier sur une ligne, puis ajoutez tous les sous-dossiers à exclure sur les lignes suivantes. Dans la colonne Dossier local, spécifiez un seul dossier local pour les copies locales des fichiers. Dans la colonne État, cliquez sur Masqué pour chaque sous-dossier.

Pour créer un espace de travail manuellement

1. Déterminez quels sont les dossiers à utiliser.

   1. Ouvrez Visual Studio, puis connectez-vous à votre projet d'équipe.

      Pour plus d'informations, consultez Se connecter aux projets d'équipe et y accéder dans Team Foundation Server.

   2. Dans Team Explorer, cliquez sur Contrôle de code source.

      Notes

      Si vous n'avez pas créé d'espace de travail, celui-ci est créé automatiquement et porte le même nom que votre ordinateur. L'espace de travail s'affiche dans la liste Espace de travail de la barre d'outils de l'Explorateur du contrôle de code source.

   3. Passez en revue la liste des dossiers dans l'Explorateur du contrôle de code source, puis notez les dossiers et sous-dossiers à utiliser.

2. Créez un espace de travail.

   1. Dans le menu Fichier, cliquez sur Contrôle de code source, puis sur Espaces de travail.

   2. Dans la boîte de dialogue Gérer les espaces de travail, cliquez sur Ajouter.

      Notes

      Vous pouvez également cliquer sur l'espace de travail par défaut, puis sur Modifier pour réutiliser l'espace de travail par défaut.

   3. Dans la boîte de dialogue Ajouter un espace de travail, tapez le nom de l'espace de travail.

3. Pour chaque dossier à mapper, procédez comme suit :

   1. Sous Dossiers de travail, cliquez sur la première ligne vide de la colonne Dossier du contrôle de code source, puis cliquez sur le bouton de sélection (…).

   2. Dans la boîte de dialogue Rechercher un dossier, cliquez sur le dossier serveur qui contient les fichiers à utiliser, puis cliquez sur OK.

   3. (Facultatif) Si vous voulez mapper une partie mais pas la totalité des sous-dossiers d'un dossier, ajoutez ce dernier sur une ligne, puis ajoutez les sous-dossiers à exclure sur les lignes suivantes. Dans la colonne État, cliquez sur Masqué pour chaque sous-dossier.

   4. Sous Dossiers de travail, cliquez sur la première ligne vide de la colonne Dossier local, puis cliquez sur le bouton de sélection (…).

   5. Dans la boîte de dialogue Rechercher un dossier, cliquez sur le dossier local dans lequel vous voulez copier les fichiers.

      Important

      Si vous maintenez la structure des dossiers locaux aussi proche que possible de la structure du dossier serveur, votre travail de développement en sera facilité. Cette stratégie est particulièrement importante si vous utilisez fréquemment l'invite de commandes. Pour obtenir un exemple, consultez la figure illustrée dans Conditions d'utilisation de l'espace de travail.

   6. (Facultatif) Cliquez sur Créer un nouveau dossier, puis tapez le nom du nouveau dossier dans lequel les copies locales doivent être stockées.

      Conseil

      Vous pouvez contribuer à simplifier l'utilisation des mappages de l'espace de travail en utilisant des noms courts pour vos dossiers locaux.

   7. Cliquez sur OK.

Utilisation de plusieurs espaces de travail pour plusieurs branches

En règle générale, vous créez plusieurs espaces de travail pour travailler sur deux versions de votre logiciel en même temps. Par exemple, vous pouvez travailler sur une mise à jour de la version 2.0 pendant que vous développez la version 3.0. En créant des espaces de travail distincts, vous isolez les fichiers et êtes assuré de travailler sur la version appropriée.

Pour créer plusieurs espaces de travail, créez-les en suivant pour chacun d'eux la procédure décrite dans Create a workspace manually plus haut dans cette rubrique.

Cette figure illustre la création d'un espace de travail par un utilisateur local pour la branche FeatureTeamA, où la nouvelle version est en cours de développement, et montre un autre espace de travail pour la branche Version2, qui requiert une mise à jour.

Lorsque vous créez des espaces de travail distincts pour chaque branche, vous pouvez afficher les fichiers de chaque branche dans l'Explorateur du contrôle de code source. Pour afficher les fichiers qui sont mappés dans chaque espace de travail, ouvrez la liste Espace de travail, puis cliquez sur le nom d'un espace de travail. La liste des dossiers et des fichiers change afin que les éléments de l'espace de travail spécifié soient disponibles, mais que ceux des autres espaces de travail ne le soient pas.

Par exemple, la figure suivante illustre les dossiers et les fichiers qui se trouvent dans l'espace de travail TeamA. Le volet Dossiers montre que le dossier serveur qui est mappé dans l'espace de travail TeamA est activé et que le dossier serveur Version2, qui n'est pas mappé dans cet espace de travail, est désactivé.

1. TeamA représente l'espace de travail actuel.

2. Seuls les fichiers ou les branches qui sont mappés dans l'espace de travail TeamA sont disponibles.

Si vous utilisez des espaces de travail distincts, vous pouvez également facilement indiquer les modifications que vous avez effectuées dans chaque branche de manière séparée dans la fenêtre Modifications en attente. Pour ouvrir la fenêtre, ouvrez l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis cliquez sur Afficher les modifications en attente. Dans la fenêtre Modifications en attente, ouvrez la liste Espace de travail, puis cliquez sur chaque espace de travail pour afficher les modifications en attente de cet espace de travail.

Résolution des problèmes courants

Deux problèmes courants peuvent se produire lorsque vous utilisez l'espace de travail par défaut au lieu d'en créer un manuellement. Le premier problème vient du fait que certaines fonctionnalités peuvent être désactivées si des fichiers que vous voulez modifier n'ont pas été mappés. Le second problème vient du fait que les mappages par défaut peuvent devenir une source de confusion.

En règle générale, vous pouvez résoudre ce genre de problèmes facilement en supprimant vos mappages actuels, puis en suivant les instructions de cette rubrique pour créer un ou plusieurs mappages appropriés.

Pourquoi certaines fonctionnalités ne sont-elles pas disponibles ?

Certaines fonctionnalités ne sont pas disponibles si vous consultez des fichiers situés dans des dossiers serveur non mappés à des dossiers locaux. Si vous n'avez pas mappé un dossier, vous ne pouvez pas extraire un fichier, supprimer un fichier ou créer un sous-dossier. Pour accéder à ces fonctionnalités, vous devez mapper le dossier serveur en suivant les instructions de cette rubrique.

Pourquoi mon espace de travail contient-il un mélange de mappages ?

Lorsque vous ajoutez des fichiers au contrôle de version sans créer d'espace de travail manuellement, vous créez en fait un espace de travail par défaut qui mappe le dossier d'origine au dossier serveur spécifié. De même, lorsque vous obtenez des fichiers sans créer d'espace de travail manuellement, vous créez un mappage dans l'espace de travail par défaut entre le dossier serveur et le dossier local spécifié.

Par exemple, la figure suivante montre qu'un utilisateur a ajouté Solution1 au contrôle de version et qu'il a spécifié un dossier serveur dans lequel stocker la solution. En ajoutant la solution, l'utilisateur a créé un mappage entre le dossier local, à partir duquel la solution a été ajoutée, et le dossier serveur. Le mappage est associé à l'espace de travail par défaut de l'utilisateur, dont le nom correspond au nom de l'ordinateur de l'utilisateur.

Un peu plus tard, l'utilisateur obtient les fichiers d'un autre projet qu'un autre membre de l'équipe avait ajoutés au contrôle de version. Lorsque le premier utilisateur a spécifié un dossier local dans lequel copier les fichiers, un mappage a été créé entre le serveur et le dossier local spécifié. Ce mappage est également associé à l'espace de travail par défaut de l'utilisateur.

En conséquence, l'espace de travail contient un mélange de mappages qui représente une source de confusion. La meilleure façon de résoudre le problème est de supprimer les mappages et de suivre les instructions décrites précédemment dans cette rubrique pour créer un ensemble cohérent de mappages.

Mappage avec un mélange de dossiers locaux

1. Dossier local à partir duquel l'utilisateur a ajouté les fichiers.

2. Dossier local dans lequel l'utilisateur a copié les fichiers en effectuant une opération d'extraction.

Voir aussi

Tâches

Ajout de fichiers au contrôle de version

Obtenir la source de votre projet d'équipe

Autres ressources

Utilisation du contrôle de version

Historique des modifications