Partager via

Gérer des mappages entre un plan de projet d'entreprise et un projet d'équipe

  • Article

Avant de pouvoir synchroniser des données entre Visual Studio Team Foundation Server (TFS) et Microsoft Project Server, vous devez effectuer plusieurs tâches qui comprennent l'association d'un plan de projet d'entreprise à un projet d'équipe. Pour une vue d'ensemble de l'intégration de ces deux produits, consultez Configurer l'intégration de TFS et Project Server.

Gérez l'association des plans de projet d'entreprise avec des projets d'équipe dans TFS à l'aide des commandes suivantes de l'outil de ligne de commande TfsAdmin ProjectServer :

  • /MapPlanToTeamProject : Mappe un plan de projet d'entreprise à un projet d'équipe. Vous pouvez mapper plusieurs plans au même projet d'équipe, mais vous ne pouvez mapper qu'un projet d'équipe à chaque plan.

  • /GetMappedProjects : Renvoie la liste de plans de projet d'entreprise qui sont mappés à n'importe quel projet d'équipe dans la collection de projets d'équipe que vous spécifiez.

  • /UnmapPlanFromTeamProject : Enlève le mappage entre un plan de projet d'entreprise et un projet d'équipe.

Notes

Après le mappage d'un plan de projet d'entreprise à un projet d'équipe, vous pouvez modifier les types d'éléments de travail à synchroniser.Pour plus d'informations, consultez Définir les types d'éléments de travail disponibles pour la synchronisation.

Pour utiliser l'outil de ligne de commande TFSAdmin , ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%..

Configuration requise

Pour utiliser ces commandes, votre autorisation Administrer pour l'intégration Project Server doit avoir la valeur Autoriser pour la collection de projets d'équipe. En outre, le compte de service de Team Foundation Server doit disposer des autorisations requises pour interagir avec l'instance de PWA qui fait partie de la synchronisation de données. Pour plus d'informations, consultez Accorder les autorisations pour prendre en charge l'intégration de TFS et Project Server.

Syntaxe

TfsAdmin ProjectServer /GetMappedProjects /collection:tpcUrl

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/workItemTypes:ListOfWorkItemTypes] [/noFixedWork] [/projectFieldForWorkItemType:ProjectFieldName] [/skipUIChanges]

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/force]

Paramètres

Paramètre

Description

/collection:tpcUrl

Spécifie l'URL (Uniform Resource Locator) d'une collection de projets d'équipe. Spécifiez l'URL au format suivant : http://ServerName:Port/VirtualDirectoryName/CollectionName

Si vous ne spécifiez pas qu'un répertoire virtuel est utilisé, vous spécifiez l'URL au format suivant :

http://ServerName:Port/CollectionName

/enterpriseProject:EnterpriseProjectName

Spécifie le nom d'un plan de projet d'entreprise. Le plan doit être enregistré et publié sur Project Server, et l'instance de PWA doit être enregistrée avec le déploiement de Team Foundation Server dans lequel la collection de projets est stockée.

/teamProject:TeamProjectName

Spécifie le nom d'un projet d'équipe qui est défini dans la collection de projets.

/workItemTypes:ListofWorkItemTypes

Spécifie, dans une liste séparée par des virgules, les noms de référence d'un ou plusieurs types d'éléments de travail. Vous ne devez spécifier que les types d'éléments de travail dont vous voulez assurer le suivi des données dans Project Professional. Par exemple, spécifiez les types suivants d'élément de travail pour prendre en charge un processus Agile car "User Story,Task" ou "User Story",Task ne comprennent pas d'espace après la virgule.

/noFixedWork

Indique que le type de tâche dans Project Professional ne doit pas avoir automatiquement la valeur Travail fixe pour les tâches qui sont mappées aux éléments de travail dans Team Foundation. Par défaut, dans le cadre de l'intégration entre les deux produits serveurs, le type des tâches du plan de projet d'entreprise mappées aux éléments de travail dans Team Foundation a la valeur Travail fixe. Vous pouvez substituer ce comportement en utilisant ce commutateur. Le travail fixe est l'un des trois types de tâches que vous pouvez utiliser dans Project. Pour plus d'informations, consultez Modifiez les utilisations de projet de type tâche de calculer la durée des tâches.

/projectFieldForWorkItemType: ProjectFieldName

Spécifie le nom du champ Microsoft Project dans lequel afficher la valeur du type d'élément de travail qui est défini dans Team Foundation. Vous devez spécifier une valeur entre pjTaskText1 et pjTaskText30. Par défaut, la valeur est pjTaskText30.

/force

Supprime tous les mappages de tous les éléments de travail définis dans le projet d'équipe et actuellement liés à un plan de projet. Un projet d'équipe non mappé ne peut contenir aucun élément de travail lié. Vous ne devez spécifier cette option que si vous êtes sûr de ne plus avoir besoin d'éléments de travail dans le projet d'équipe pour faire partie de la synchronisation de données.

/skipUIChanges

Indique que l'onglet Project Server du formulaire d'élément de travail ne doit pas être modifié pour les types que vous spécifiez. Vous devez inclure cet indicateur si vous avez personnalisé l'onglet Project Server pour les types affectés.

/? ou help

Affiche des informations sur la commande.

Notes

Lorsque vous exécutez une commande, un message apparaît et indique l'action en cours d'exécution et l'objet de l'action. Par exemple, le message suivant indique que le plan de projet d'entreprise est en cours de mappage :

Mapping enterprise project EntProjA . . . Done.

Un autre message apparaît à l'issue de l'exécution de la commande. Par exemple, le message suivant indique que le plan de projet d'entreprise a été mappé au projet d'équipe :

Mapping enterprise project EntProjA to team project MyTeamProj . . . Done.

En plus d'associer le plan de projet d'entreprise avec le projet d'équipe, l'option /MapPlantoTeamProject ajoute l'onglet Project Server aux formulaires d'éléments de travail pour les types d'éléments de travail que vous spécifiez.

Si vous essayez de mapper un projet d'entreprise à un projet d'équipe pour lequel aucun champ n'a été mappé, un message indique qu'un mappage est requis, et aucune autre opération n'est exécutée. Pour plus d'informations, consultez Personnaliser le mappage de champs entre TFS et Project Server.

Si vous supprimez le mappage entre un projet d'entreprise et un projet d'équipe auxquels aucun autre projet d'entreprise n'est mappé, l'onglet Project Server est supprimé des formulaires de tous les types d'éléments de travail dans le projet d'équipe dont vous avez supprimé le mappage.

Avant de pouvoir annuler le mappage d'un projet d'équipe, vous devez supprimer l'association entre les tâches dans le plan de projet d'entreprise et les éléments de travail dans Team Foundation. Vous pouvez supprimer cette association en supprimant les tâches du plan de projet d'entreprise, en publiant le plan et en attendant la fin du processus de synchronisation. Comme autre solution, vous pouvez utiliser l'indicateur /force pour supprimer l'association entre les tâches du projet et les éléments de travail.

Conseil

Avant de pouvoir supprimer les tâches, vous pouvez les copier dans un autre plan pour enregistrer les tâches que vous supprimez.

Exemples

Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :

  • URL de l'instance de PWA : http://MyPWAServer/MyPWAInstance/

  • URL pour Team Foundation Server : http://AdventureWorksServer:8080/tfs/

  • URL pour la collection de projets d'équipe : http://AdventureWorksServer:8080/tfs/DefaultCollection

Lister les projets d'entreprise mappés

L'exemple suivant répertorie les projets d'entreprise qui sont mappés à un projet d'équipe dans Collection0 sur AdventureWorksServer.

TfsAdmin ProjectServer /GetMappedProjects /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Mappage d'un projet d'entreprise à un projet d'équipe

L'exemple suivant mappe MyEnterpriseProjA à MyTeamProjB dans DefaultCollection sur AdventureWorksServer et indique que les récits utilisateur et les tâches feront partie de la synchronisation.

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB /workItemTypes:"User Story, Task"

Suppression du mappage d'un projet d'entreprise à un projet d'équipe

L'exemple suivant supprime l'association de MyEnterpriseProjA à MyTeamProjB dans DefaultCollection sur AdventureWorksServer.

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB

Voir aussi

Tâches

Configurer l'intégration de TFS et Project Server

Concepts

Mapper les composants d'intégration [TfsAdmin ProjectServer]