Partager via

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

  • Article

Utilisez TFSFieldMapping pour charger et télécharger le fichier de mappage Microsoft Project. Ce fichier contrôle la façon dont Microsoft Project publie des tâches dans un projet d'équipe spécifié qui a été créé dans Visual Studio Team Foundation Server 2013. 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.

Il est aussi possible de spécifier les champs Team Foundation qui sont mappés aux champs Microsoft 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 obtenir la syntaxe XML complète du fichier de mappage, voir 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.

Pour accéder à l'outil en ligne de commande TFSFieldMapping, 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

Notes

Même si vous êtes connecté avec des autorisations d'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008.Pour ouvrir une invite de commandes avec élévation de privilèges, sélectionnez Démarrer, ouvrez le menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, voir le site web Microsoft.

Autorisations requises

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

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

Paramètres

Argument

Description

upload | download

Spécifie si le fichier de mappage de champs doit être téléchargé ou chargé.

/collection:CollectionURL

Spécifie l'URI de la collection de projets d'équipe au format suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

Si vous ne spécifiez pas le répertoire virtuel à utiliser, vous devez utiliser le format suivant :

http://NomServeur:Port/NomCollection

Si vous vous êtes déjà connecté au serveur, vous pouvez spécifier son nom convivial à la place de l'URI.

/teamproject:NomProjet

Spécifie le nom du projet d'équipe dont vous souhaitez modifier les paramètres de mappage. Si le nom contient des espaces, mettez-le entre guillemets.

/mappingfile:FichierMappage

Spécifie le nom et le chemin d'accès du fichier de mappage.

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, voir 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