Utilisation d'espaces de travail Team Foundation Server (Team Explorer Everywhere)
Un espace de travail pour Visual Studio Team Foundation Server comprend un ensemble de mappages de dossiers de travail. Ces mappages représentent l'emplacement de vos dossiers côté client sur votre disque local et des dossiers correspondants qui servent de référentiels. De plus, le nom du propriétaire de l'espace de travail et le nom de l'ordinateur sur lequel l'espace de travail est utilisé sont également stockés dans Team Foundation Server.
Par défaut, les chemins d'accès des dossiers de travail locaux ont pour valeur des projets dans le répertoire de l'espace de travail Eclipse actuel lorsque vous partagez ou importez des projets. Cette rubrique décrit les tâches que vous pouvez effectuer dans votre espace de travail Team Foundation Server.
Dans cette rubrique
Fonctionnement des espaces de travail Team Foundation Server et des dossiers de travail
Affichage des espaces de travail Team Foundation Server et des dossiers de travail
Ajouter ou supprimer un espace de travail Team Foundation Server
Fonctionnement des espaces de travail Team Foundation Server et des dossiers de travail
Un espace de travail Eclipse est un conteneur pour les projets, très semblable à une solution dans Visual Studio. Un espace de travail Team Foundation Server mappe vos dossiers locaux aux dossiers sur une instance de Team Foundation Server. Dans les dossiers de travail locaux de votre espace de travail Team Foundation Server, vous pouvez ajouter, modifier, supprimer, déplacer, renommer ou modifier des éléments contrôlés par version sans affecter le dossier sur le serveur de contrôle de version. Vous pouvez également générer et tester des modifications sans affecter les éléments sur le serveur de contrôle de version. Le système enregistre les modifications apportées aux éléments locaux en tant que modifications en attente. Lorsque vous exécutez une opération d'archivage, vous validez les modifications locales dans le dossier sur le serveur de contrôle de version. L'opération d'archivage enregistre la mise à jour et la rend disponible pour d'autres membres de l'équipe.
Un mappage d'espace de travail est une liste d'éléments actifs et masqués. Lorsque vous mappez un dossier local à un contrôle de version Team Foundation, le système crée implicitement un mappage entre tous ses sous-dossiers actuels et futurs. Par exemple, vous pouvez mapper $/projets à c:\projets, ajouter un projet nommé $/projets/projet_un, puis placer tous les fichiers dans l'espace de travail. Le cas échéant, Team Explorer Everywhere crée automatiquement un dossier de travail local nommé projet_un dans le répertoire C:\projets.
Vous devez disposer d'un espace de travail Team Foundation Server avant de pouvoir exécuter des commandes du contrôle de version Team Foundation sur votre ordinateur. Team Foundation stocke les informations suivantes sur vos espaces de travail :
la liste de tous les fichiers de votre espace de travail ;
la version de chaque fichier ;
la liste des modifications en attente.
Comme ces informations sont stockées sur le serveur, les utilisateurs qui disposent des autorisations appropriées peuvent dupliquer votre environnement de travail sur leur ordinateur. Ils ne pourront toutefois pas consulter les détails de vos modifications en attente. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Get, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Mappage des dossiers locaux vers les dossiers sur le serveur de contrôle de version
Le mappage d'espace de travail établit un dossier de travail côté client. C'est là que vous placez des fichiers et sous-dossiers lorsque vous exécutez une opération Get.
Vous pouvez ajouter et supprimer des mappages pour un espace de travail en utilisant le Plug-in Team Foundation Server pour Eclipse ou en utilisant la commande workfold du Client de ligne de commande interplateforme pour Team Foundation Server. Pour plus d'informations, consultez Utilisation d'espaces de travail Team Foundation Server (Team Explorer Everywhere).
Vous pouvez également fournir des mappages de masquage. Les mappages de masquage empêchent la récupération de fichiers et de sous-dossiers dans le dossier de serveur spécifié lorsque vous exécutez une opération Get. Vous pouvez établir manuellement des mappages d'espace de travail dans la boîte de dialogue Créer un espace de travail pendant le processus de création de l'espace de travail. Sinon, Team Foundation créera automatiquement les mappages d'espace de travail lors de l'ajout de fichiers au contrôle de version. Pour plus d'informations, consultez Ajouter ou supprimer un espace de travail Team Foundation Server.
Affichage des espaces de travail Team Foundation Server et des dossiers de travail
Autorisations requises
Pour afficher les espaces de travail Team Foundation Server, vous devez disposer de l'autorisation Lire avec la valeur Autoriser. Pour afficher les mappages des dossiers de travail, vous devez être le propriétaire de l'espace de travail spécifié ou implicite ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Pour consulter vos espaces de travail Team Foundation Server
Dans l'Explorateur de projets ou l'Explorateur de package, cliquez avec le bouton droit sur un projet Eclipse qui est sous contrôle de version, pointez sur Équipe et cliquez sur Gérer les espaces de travail.
La boîte de dialogue Espaces de travail s'affiche. Elle contient la liste de vos espaces de travail Team Foundation Server.
Si vous souhaitez consulter les dossiers de travail et les mappages, cliquez sur l'espace de travail Team Foundation Server pour lequel vous souhaitez consulter les mappages, puis cliquez sur Modifier.
La boîte de dialogue Modifier l'espace de travail s'affiche. Elle fournit une liste de vos dossiers de travail. Pour chaque mappage, la liste inclut l'état (actif ou masqué), le dossier sur le serveur, et le dossier local correspondant.
Pour consulter vos espaces de travail Team Foundation Server à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workspaces et appuyez sur Entrée.
Une liste de tous les espaces de travail de l'utilisateur actuel sur l'ordinateur actuel s'affiche.
Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Workspaces, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Ajouter, supprimer ou modifier des mappages de dossiers de travail
À chaque espace de travail Team Foundation Server est associé un ensemble de dossiers de travail qui mappe le dossier sur le serveur de contrôle de version à un dossier sur votre ordinateur local. Vous pouvez choisir de mapper uniquement les enfants immédiats d'un dossier sur le serveur à un espace de travail local. Pour cela, fournissez un astérisque comme caractère générique lorsque vous spécifiez le dossier. Sinon, par défaut, tous les enfants du dossier sur le serveur sont mappés à l'espace de travail local de manière récursive.
Notes
Au lieu de supprimer un mappage de dossiers de travail, vous pouvez changer son état en masqué pour libérer de l'espace sur votre disque local. Vous pouvez choisir de le faire si vous devrez ultérieurement obtenir ces fichiers et souhaiter définir tous vos mappages au démarrage du projet. Pour plus d'informations, consultez Masquer ou désactiver le masquage des dossiers de travail.
Le mappage d'un seul niveau dans une hiérarchie de contrôle de version peut limiter le nombre d'éléments téléchargés sur l'ordinateur client. Cela réduit les temps de téléchargement et économise de l'espace disque sur l'ordinateur client.
Autorisations requises
Pour effectuer ces procédures, vous devez être le propriétaire de l'espace de travail spécifié ou implicite ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Pour mapper des dossiers de travail
Affichez les dossiers de travail pour votre espace de travail Team Foundation Server. Pour plus d'informations, consultez Affichage des espaces de travail Team Foundation Server et des dossiers de travail.
Dans la liste Dossiers de travail, cliquez sur Cliquez ici pour entrer un nouveau dossier de travail dans la colonne Dossier de contrôle de code source.
Dans la colonne Dossier de contrôle de code source, tapez le chemin d'accès du dossier serveur que vous souhaitez mapper à un dossier local ou cliquez sur le bouton Parcourir (...) pour spécifier le dossier.
Dans la zone Dossier Local, tapez le chemin d'accès du dossier local qui correspond au dossier serveur ou cliquez sur le bouton Parcourir (...) pour spécifier le dossier.
(Facultatif) Si vous souhaitez que le mappage soit masqué (les fichiers masqués ne sont pas copiés dans votre dossier local), modifiez la colonne État d'Actif à Masqué.
Répétez les étapes 2 à 5 jusqu'à ce que vous ayez ajouté tous les mappages que vous souhaitez, puis cliquez sur OK.
Pour supprimer des mappages de dossiers de travail
Affichez les dossiers de travail pour votre espace de travail Team Foundation Server. Pour plus d'informations, consultez Affichage des espaces de travail Team Foundation Server et des dossiers de travail.
Dans la liste Dossiers de travail, cliquez avec le bouton droit sur la ligne qui correspond au mappage du dossier de travail à supprimer, puis cliquez sur Supprimer.
Répétez l'étape précédente pour les autres mappages que vous souhaitez supprimer, puis cliquez sur OK.
Pour modifier des mappages de dossiers de travail
Affichez les dossiers de travail pour votre espace de travail Team Foundation Server. Pour plus d'informations, consultez Affichage des espaces de travail Team Foundation Server et des dossiers de travail.
Dans la liste Dossiers de travail, dans Dossier local, mettez à jour le chemin d'accès du dossier local qui correspond au mappage que vous souhaitez modifier.
Avertissement
Vous ne devez pas modifier le mappage du dossier local si vous avez des modifications en attente dans ce dossier.
Répétez l'étape précédente pour les autres mappages que vous souhaitez modifier, puis cliquez sur OK.
Pour ajouter ou mettre à jour des mappages de dossiers de travail à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workfold ServerFolder LocalFolder, puis appuyez sur Entrée. Remplacez ServerFolder par le dossier sur l'instance de Team Foundation Server. Remplacez LocalFolder par le chemin d'accès sur votre ordinateur local que vous souhaitez mapper à ce dossier serveur. Si un mappage existe déjà, il sera remplacé.
Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Workfold, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Vous ne devez pas modifier les mappages de dossiers de travail si vous avez des modifications en attente dans le dossier local.
Pour supprimer des mappages de dossiers de travail à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workfold -unmap LocalFolder, puis appuyez sur Entrée. Remplacez LocalFolder par le chemin d'accès sur votre ordinateur local que vous souhaitez mapper à ce dossier serveur.
Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Workfold, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Vous devez supprimer les mappages de dossiers de travail si vous avez des modifications en attente dans le dossier local.
Masquer ou désactiver le masquage des dossiers de travail
En définissant l'état de dossier de travail à Masqué, vous pouvez spécifier qu'un dossier local ne doit pas copier de fichiers du serveur lorsque vous exécutez une opération Get. Vous pouvez choisir de le faire pour conserver de l'espace sur votre disque local. Si vous décidez ultérieurement que vous devez placer des fichiers dans ces dossiers masqués, vous devez modifier l'état à Actif puis exécuter une opération Get.
Autorisations requises
Pour effectuer ces procédures, vous devez être le propriétaire de l'espace de travail spécifié ou implicite ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Pour masquer ou désactiver le masquage d'un dossier de travail
Affichez les dossiers de travail pour votre espace de travail Team Foundation Server. Pour plus d'informations, consultez Affichage des espaces de travail Team Foundation Server et des dossiers de travail.
Pour masquer un dossier de travail, dans la liste Dossiers de travail, changez l'État en Masqué pour le dossier local que vous souhaitez modifier.
Avertissement
Vous ne devez pas changer l'état en Masqué si vous avez des modifications en attente dans le dossier local.
Pour désactiver le masquage d'un dossier de travail, dans la liste Dossiers de travail, changez l'État en Actif pour le dossier local que vous souhaitez modifier.
Répétez l'étape 2 ou 3 pour les autres dossiers locaux que vous souhaitez modifier, puis cliquez sur OK.
Pour masquer un dossier de travail à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workfold -cloak LocalFolder, puis appuyez sur Entrée. Remplacez LocalFolder par le nom du dossier que vous souhaitez masquer.
Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Workfold, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Avertissement
Vous ne devez pas changer l'état en Masqué si vous avez des modifications en attente dans le dossier local.
Pour désactiver le masquage d'un dossier de travail à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workfold -decloak LocalFolder, puis appuyez sur Entrée. Remplacez LocalFolder par le nom du dossier dont vous souhaitez désactiver le masquage.
Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Workfold, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Ajouter ou supprimer un espace de travail Team Foundation Server
Un seul espace de travail Team Foundation Server peut contenir plusieurs projets d'équipe. Vous pouvez maintenir plusieurs copies de fichiers sources, pointant chacune vers différentes versions des fichiers. Cela peut s'avérer utile si vous travaillez sur une nouvelle version et que vous devez être capable de faire référence aux fichiers sources d'une version antérieure. En outre, l'ajout d'un espace de travail de test dédié sur votre ordinateur peut s'avérer utile pour exécuter des révisions du code d'un membre de l'équipe par des pairs.
Dans le Plug-in Team Foundation Server pour Eclipse, vous devez utiliser un espace de travail Eclipse différent pour chaque espace de travail Team Foundation Server.
Autorisations requises
Pour modifier ou supprimer un espace de travail existant, vous devez en être le propriétaire ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour ajouter un espace de travail, vous devez disposer de l'autorisation globale Créer un espace de travail avec la valeur Autoriser. Pour ajouter des espaces de travail pour d'autres utilisateurs, vous devez disposer de l'autorisation Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Pour ajouter un espace de travail Team Foundation Server
Dans l'Explorateur de projets ou l'Explorateur de package, cliquez avec le bouton droit sur un projet Eclipse qui est sous contrôle de version, pointez sur Équipe et cliquez sur Gérer les espaces de travail.
La boîte de dialogue Espaces de travail s'affiche. Elle contient la liste de vos espaces de travail Team Foundation Server.
Cliquez sur Ajouter.
La boîte de dialogue Ajouter un espace de travail s'affiche.
Dans la zone Nom, fournissez un nom descriptif pour le nouvel espace de travail.
Dans la zone Commentaire, vous pouvez fournir des informations supplémentaires sur l'espace de travail. Par exemple, vous pouvez fournir des informations sur la version finale à laquelle l'espace de travail correspond.
(Facultatif) Ajoutez un ou plusieurs mappages de dossiers de travail en exécutant les étapes suivantes :
Dans la liste Dossiers de travail, cliquez sur Cliquez ici pour entrer un nouveau dossier de travail dans la colonne Dossier de contrôle de code source.
Dans la colonne Dossier de contrôle de code source, tapez le chemin d'accès du dossier serveur que vous souhaitez mapper à un dossier local ou cliquez sur le bouton Parcourir (...) pour spécifier le dossier.
Dans la zone Dossier Local, tapez le chemin d'accès du dossier local qui correspond au dossier serveur ou cliquez sur le bouton Parcourir (...) pour spécifier le dossier.
(Facultatif) Si vous souhaitez que le mappage soit masqué (les fichiers masqués ne sont pas copiés dans votre dossier local), modifiez la colonne État d'Actif à Masqué.
Répétez les étapes 5a à 5d jusqu'à ce que vous ayez ajouté tous les mappages que vous souhaitez.
Vous pourrez ajouter d'autres mappages par la suite. Pour plus d'informations, consultez Ajouter, supprimer ou modifier des mappages de dossiers de travail.
Cliquez sur OK pour créer l'espace de travail Team Foundation Server.
Pour ajouter un espace de travail TFS à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workspace -new -s:ServerName -collection:URL WorkspaceName, puis appuyez sur Entrée. Remplacez ServerName par le nom du serveur qui exécute Team Foundation Server. Remplacez URL par le chemin d'accès de cotre collection de projets d'équipe. Vous pouvez omettre l'option -collection si vous vous connectez à Visual Studio Team System 2008 Team Foundation Server ou Visual Studio 2005. Remplacez WorkspaceName par le nom que vous souhaitez donner au nouvel espace de travail Team Foundation Server.
Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Workspace, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Pour supprimer un espace de travail Team Foundation Server
Dans l'Explorateur de projets ou l'Explorateur de package, cliquez avec le bouton droit sur un projet Eclipse qui est sous contrôle de version, pointez sur Équipe et cliquez sur Gérer les espaces de travail.
La boîte de dialogue Espaces de travail s'affiche. Elle contient la liste de vos espaces de travail Team Foundation Server.
Dans la liste Espaces de travail, cliquez sur l'espace de travail Team Foundation Server que vous voulez supprimer, puis sur Supprimer.
Avertissement
Lorsque vous supprimez un espace de travail Team Foundation Server, vous perdez toutes les modifications en attente dans cet espace de travail. Si vous ne savez pas si vous avez des modifications en attente, vous devez annuler l'opération et archiver ou ignorer les modifications en attente avant de supprimer l'espace de travail.
Continuer l'opération de suppression, cliquez sur OK dans la boîte de dialogue de confirmation.
Pour supprimer un espace de travail Team Foundation Server à partir d'une invite de commandes
Ouvrez une invite de commandes.
Tapez tf workspace -delete WorkspaceName, puis appuyez sur Entrée. Remplacez WorkspaceName par le nom de l'espace de travail Team Foundation Server que vous souhaitez supprimer.
Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Workspace, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Avertissement
Lorsque vous supprimez un espace de travail Team Foundation Server, vous perdez toutes les modifications en attente dans cet espace de travail. Si vous ne savez pas si vous avez des modifications en attente, vous devez annuler l'opération et archiver ou ignorer les modifications en attente avant de supprimer l'espace de travail.
Voir aussi
Autres ressources
Copie de fichiers sous contrôle de version (Team Explorer Everywhere)
Utilisation du contrôle de version (Team Explorer Everywhere)