Partager via

Définir les types d'éléments de travail disponibles pour la synchronisation

  • Article

Avant de synchroniser des données entre Visual Studio Team Foundation Server (TFS) et le serveur de Microsoft Project, vous devez configurer l'intégration des deux produits serveurs. Dans les tâches de configuration, vous devez associer un plan de projet d'entreprise à un projet d'équipe, et vous devez spécifier les types d'éléments de travail qui feront partie de la synchronisation. Après les configurations et le mappage initiaux, vous pouvez modifier les types d'éléments de travail qui sont mappés.

Vous pouvez gérer les types d'éléments de travail qui font partie de la synchronisation à l'aide des options suivantes de l'outil de ligne de commande TfsAdmin ProjectServer :

  • /MapWorkItemTypes : Définit les types des éléments de travail qui peuvent participer à la synchronisation pour un projet d'équipe. Même si vous pouvez mapper plusieurs types, seuls les éléments de travail soumis pour publication sont synchronisés.

  • /GetMappedWorkItemTypes : Retourne la liste des types d'éléments de travail qui sont configurés pour participer à la synchronisation d'un projet d'équipe.

  • /UnmapWorkItemTypes : Enlève des types d'éléments de travail de la participation dans la synchronisation pour un projet d'équipe.

Pour une vue d'ensemble de la façon intégrer les deux produits serveurs, voir le Configurer l'intégration de TFS et Project Server. Pour une vue d'ensemble de l'association d'un projet d'entreprise à un projet d'équipe, consultez Gérer l'association de projets d'entreprise à des projets d'équipe.

Pour utiliser l'outil en ligne de commande TfsAdmin ProjectServer, 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, vous devez attribuer la valeur Autoriser à l'autorisation Administrer Project Server Integration. 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 /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/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 de répertoire virtuel, indiquez l'URL au format suivant :

http://ServerName:Port/CollectionName

/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, vous pouvez spécifier les types d'éléments de travail suivants pour prendre en charge un processus agile comme “User Story,Task” ou “User Story”,Task. N'incluez pas d'espace après la virgule.

/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 la commande MapWorkItemTypes ne peut pas être exécutés. Vous pouvez mettre une définition de type à jour. Pour plus d'informations, consultez Éléments XML ajoutés à la définition du type d'élément de travail.

/force

Supprime tous les liens qui lient les éléments de travail des types que vous spécifiez aux tâches du projet. Si vous utilisez cette option, vous pouvez supprimer des types d'éléments de travail de la synchronisation de données, même si un ou plusieurs éléments de travail de ce type sont en cours de synchronisation.

/? 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 les récits utilisateur et les tâches sont en cours de configuration pour faire partie de la synchronisation de données.

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .

Un autre message apparaît à l'issue de l'exécution de la commande. Par exemple, le message suivant indique que les récits utilisateur et les tâches ont été configurés correctement.

You have successfully configured the following work item types for team project ProjA: User Story, Task.

En plus de configurer les types d'éléments de travail qui peuvent faire partie de la synchronisation, la commande /MapWorkItemTypes exécute les opérations suivantes :

  • Ajoute les types d'éléments de travail que vous spécifiez pour l'ensemble des types qui font partie de la synchronisation de données. C'est-à-dire, la commande ne supprime pas le mappage des types mappés existants.

  • Ajoute l'onglet Project Server aux formulaires pour les types d'éléments de travail que vous spécifiez.

    Si un onglet Project Server est déjà défini pour un type d'élément de travail que vous spécifiez, ce type est ignoré, et aucune modification n'est apportée aux formulaires pour des éléments de travail de ce type.

Si vous essayez de mapper des types d'éléments de travail pour un projet d'équipe qui n'est pas associé à un plan de projet d'entreprise, une erreur apparaît. Vous ne pouvez mapper que des types d'éléments de travail pour les projets d'équipe qui sont configurés pour faire partie de la synchronisation. Pour plus d'informations, consultez Gérer l'association de projets d'entreprise à des projets d'équipe.

Si vous supprimez le mappage d'un type d'élément de travail, l'onglet Project Server est supprimé du formulaire de ce type pour le projet d'équipe dont vous avez supprimé le mappage.

Avant de pouvoir annuler le mappage d'un type d'élément de travail pour un projet d'équipe, vous devez supprimer les tâches du plan de projet d'entreprise afin de supprimer toutes les associations entre elles et les éléments de travail dans Team Foundation. Après avoir déplacé les tâches du plan de projet d'entreprise, vous devez le publier et attendre la synchronisation se termine. Comme autre solution, vous pouvez spécifier l'indicateur /force pour supprimer tous les liens qui lient les éléments de travail aux tâches pour le projet d'équipe. Seuls les éléments de travail dont le type correspond au type que vous spécifiez sont supprimés de la synchronisation.

Conseil

Si vous supprimez les tâches, vous pouvez commencer par les copier dans un autre plan pour en conserver un enregistrement.

Exemples

Types d'éléments de travail de liste mappés

L'exemple suivant récupère les types d'éléments de travail configurés pour participer à la synchronisation pour le projet d'équipe Contoso dans DefaultCollection sur AdventureWorksServer.

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

Mappez un type d'élément de travail pour un projet d'équipe

L'exemple suivant configure des récits utilisateur et des tâches à ajouter à la synchronisation de données pour le projet Contoso.

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

Supprimez le mappage d'un type d'élément de travail pour un projet d'équipe

L'exemple suivant supprime les tâches de la synchronisation de données pour le projet de Contoso.

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

Voir aussi

Concepts

Spécifier les types d'éléments de travail à synchroniser

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

Autres ressources

Personnaliser le mappage de champs entre TFS et Project Server