Charger ou télécharger le fichier de mappage Microsoft Project [TFSFieldMapping]

Utilisez TFSFieldMapping pour charger et télécharger le fichier de mappage Microsoft Project. Ce fichier détermine la façon dont Microsoft Project publie des tâches dans un projet d'équipe qui se connecte à un serveur TFS (Team Foundation Server) local. Par exemple, vous pouvez modifier le fichier pour prendre en charge les champs que vous avez ajoutés aux types d'éléments de travail ou modifier la façon dont les champs existants sont publiés et actualisés.

Vous pouvez spécifier quels champs TFS correspondent aux champs Project. Vous pouvez enfin contrôler le comportement de publication par le biais de l'attribut PublishOnly, et désigner des domaines spéciaux comme le champ de contexte. Pour connaître la syntaxe XML complète du fichier de mappage, consultez Personnaliser le fichier de mappage des champs Microsoft Project. Ce fichier est le même que celui qui a été défini dans le modèle de processus utilisé pour créer le projet d'équipe. Consultez Mapper les champs Microsoft Project sur les champs Team Foundation.

L'outil en ligne de commande TFSFieldMapping ne fonctionne que quand vous l'exécutez sur un serveur TFS local. Pour exécuter l'outil, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\14.0

Spécifications

Pour utiliser la commande TFSFieldMapping, vous devez être membre du groupe de sécurité Team Foundation Administrators ou Project Administrators. Pour plus d'informations, consultez Référence des autorisations pour Team Foundation Server.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Paramètres

Pour modifier le mappage des champs d'éléments de travail à Project

1. Ouvrez une fenêtre d'invite de commandes à l'endroit où vous avez installé Project et Team Explorer ou TFS, puis entrez :

   cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0
   

   Conseil

   Project n'est pas requis pour télécharger le fichier de mappage. Toutefois, il est obligatoire pour charger le fichier.

2. Téléchargez le fichier de mappage en entrant la commande suivante :

   TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
   

   Conseil

   Si le nom contient des espaces, mettez-le entre guillemets.

3. Ouvrez le fichier de mappage dans un éditeur de texte ou un éditeur XML.

4. Ajoutez de nouveaux mappages ou modifiez des mappages existants dans le format suivant :

   <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
      ProjectField=""
      ProjectName=""
      ProjectUnits=""
      PublishOnly=""
      IfSummaryRefreshOnly=""/>
   

   Par exemple, pour ajouter des champs de planification supplémentaires à un projet d'équipe créé à l'aide du modèle de processus Scrum, ajoutez les mappages suivants :

   <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
   <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
   <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
   <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
   

   Le modèle Scrum par défaut mappe uniquement le champ Travail restant à Project.

   Notes

   Pour obtenir la liste complète de toutes les valeurs de champ Office Project pour l'attribut ProjectField, consultez Mappages de champs dans Microsoft Project.

5. (Facultatif) Indiquez si le champ doit être publié, sans toutefois être actualisé. Ajoutez l'attribut PublishOnly à la section de mappage du champ et affectez à l'attribut la valeur true. Dans ce cas, les membres de l'équipe peuvent afficher une valeur de champ dans Team Foundation, mais ils ne peuvent pas la modifier.

6. (Facultatif) Indiquez le mode d'actualisation des tâches récapitulatives dans Project. Ajoutez l'attribut fSummaryRefreshOnly="true" pour indiquer que le champ ne doit jamais être publié dans la base de données des éléments de travail, mais qu'il doit être actualisé à partir de celle-ci lorsque les conditions suivantes sont remplies : la ligne correspondant au champ est une tâche récapitulative dans Project, la propriété Publier et actualiser de la tâche récapitulative a la valeur Oui et la tâche récapitulative contient au moins une tâche enfant publiée dans TFS.

7. Enregistrez et chargez le fichier :

   TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
   

Voir aussi

Référence

Mappages de champs dans Microsoft Project

Concepts

Personnaliser le fichier de mappage des champs Microsoft Project