Mappage des champs Microsoft Project et des champs Team Foundation

Article
08/10/2011

Vous pouvez personnaliser la façon dont les champs d'éléments de travail stockés dans Team Foundation sont mappés aux champs définis pour Microsoft Project. Vous pouvez modifier la façon dont les champs spécifiques sont publiés et désigner le type de lien par défaut à utiliser lorsque vous créez des liens d'arborescence ou hiérarchiques et des liens de dépendance.

Contrairement à Microsoft Excel, Microsoft Project utilise un ensemble de colonnes limité comprenant des colonnes prédéfinies, par exemple Nom de la tâche, et des champs personnalisés. Lorsqu'un utilisateur publie ou actualise des données d'élément de travail dans un fichier Microsoft Project, le mappage de champs détermine les champs de la base de données des éléments de travail qui correspondent aux colonnes dans Microsoft Project.

Par exemple, vous pouvez personnaliser les mappages pour prendre en charge un champ que vous avez créé ou associer les champs à des colonnes prédéfinies plutôt qu'à des colonnes personnalisées. Pour obtenir une documentation complète sur le fichier de mappage de champs de Microsoft Project, consultez Personnalisation des mappages de champs de Microsoft Project.

Vous personnalisez le mappage en modifiant le fichier FileMapping.xml. Le tableau suivant récapitule les noms du fichier, du dossier et du plug-in pour les modèles de processus pour Microsoft Solutions Framework (MSF). Le plug-in contient la définition de la tâche qui télécharge le fichier vers la collection de projets d'équipe.

Nom du fichier :

FileMapping.xml

Nom du dossier :

Classification

Nom du plug-in :

Microsoft.ProjectCreationWizard.Classification

Pour plus d'informations, consultez Définir les zones et les itérations initiales dans le plug-in Classification.

Dans cette rubrique

Spécification de la façon dont les champs sont mappés
Spécification des champs utilisés pour la synchronisation, les liens et les pièces jointes
Mappages de champs par défaut

Spécification de la façon dont les champs sont mappés

Vous spécifiez les champs mappés à l'aide de l'élément Mapping et de la structure de syntaxe suivante :

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

Le tableau suivant décrit les attributs de l'élément Mapping.

Attribut	Description
WorkItemTrackingFieldReferenceName	Obligatoire. Spécifie le nom de référence d'un champ dans un type d'élément de travail.
ProjectField	Obligatoire. Spécifie le nom d'une colonne dans Microsoft Project. Spécifiez des noms de colonnes prédéfinis en faisant précéder le nom de "pj", par exemple pjTaskName pour la colonne Nom de la tâche. Spécifiez des champs personnalisés tels que pjTaskText suivi d'un nombre, par exemple pjTaskText11.
ProjectName	Facultatif. Spécifie le nom à afficher comme nom de colonne pour l'utilisateur. Si cet attribut n'est pas spécifié, le nom du champ du type d'élément de travail est utilisé.
ProjectUnits	Facultatif. Spécifie le type d'unités à utiliser lorsque vous mappez un type de champ à Microsoft Project. Les valeurs valides sont pjMinute, pjHour, pjDay, pjWeek et pjMonthUnit.
PublishOnly	Facultatif. Si cet attribut a la valeur true, cela indique que le champ est publié sur la base de données des éléments de travail, mais pas actualisé. Cette valeur est généralement utilisée pour les champs calculés qui ne doivent pas être mis à jour dans Team Explorer. Si cet attribut a la valeur false, cela indique que le champ est publié et actualisé. Par défaut, cet attribut a la valeur false. Par défaut, seuls Date de début et Date de fin ont cet attribut avec la valeur true.
IfSummaryRefreshOnly	Facultatif. Si cet attribut a la valeur true, cela indique que le champ n'est jamais publié dans la base de données des éléments de travail, mais qu'il est actualisé à partir de la base de données des éléments de travail lorsque les conditions suivantes sont également remplies : La ligne pour le champ est une tâche récapitulative dans Microsoft Project. Les valeurs Publier et actualiser de la tâche récapitulative sont égales à Yes. La tâche récapitulative contient au moins une tâche enfant liée à Team Foundation Server. Les mises à jour ou calculs effectués par Microsoft Project peuvent remplacer la valeur actualisée à partir de la base de données des éléments de travail dans le plan de projet. Toutefois, la valeur modifiée n'est jamais enregistrée dans la base de données des éléments de travail. Cet attribut est généralement utilisé pour les champs récapitulatifs qui, s'ils sont publiés dans la base de données des éléments de travail, entraînent des incohérences dans les données. Si cet attribut a la valeur false, cela indique que le champ peut être publié et actualisé. Par défaut, cet attribut a la valeur false. Remarque L'attribut IfSummaryRefreshOnly annule et remplace l'attribut PublishOnly.Pour plus d'informations, consultez Fichier de mappage de champs Microsoft Project. Par défaut, l'attribut IfSummaryRefreshOnly a la valeur true pour les champs Estimation d'origine, Travail restant et Travail effectué.

Spécification des champs utilisés pour la synchronisation, les liens et les pièces jointes

En plus de l'élément Mapping, deux autres éléments déterminent la façon dont les champs sont synchronisés et quel champ prend en charge les liens et les pièces jointes.

L'élément SyncField indique quelle colonne sert de champ de synchronisation. Le champ de synchronisation est intitulé "Publier et actualiser" et permet à l'utilisateur d'indiquer si une ligne de tâche est publiée ou seulement actualisée.

Vous utilisez la syntaxe XML suivante pour spécifier les mappages de colonnes sur le champ de synchronisation. Vous affectez l'attribut ProjectField à une colonne valide dans Microsoft Project.

<SyncField ProjectField="" />

L'élément LinksField spécifie la colonne des liens et pièces jointes. Grâce à cette colonne, les utilisateurs peuvent indiquer si une ligne de tâche donnée contient des liens ou des pièces jointes.

Vous utilisez la syntaxe XML suivante pour spécifier les mappages de colonnes sur les champs de liens et de pièces jointes. Vous affectez l'attribut ProjectField à une colonne valide dans Microsoft Project.

<LinksField ProjectField="" />

Mappages de champs par défaut

L'exemple suivant montre comment le modèle de processus MSF for Agile Software Development mappe les champs des éléments de travail aux colonnes de Microsoft Project.

<?xml version="1.0" encoding="utf-8"?>
<MSProject>
  <Mappings>
    <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" />
    <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="Work Item ID" />
    <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" />
    <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="State" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" />
    <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="Work Item Priority" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="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.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
    <LinksField ProjectField="pjTaskText26" />
    <SyncField ProjectField="pjTaskText25" />
  </Mappings>
</MSProject>

Voir aussi

Concepts

Définir les zones et les itérations initiales dans le plug-in Classification

Fichier de mappage de champs Microsoft Project

Personnalisation de domaines fonctionnels au sein d'un modèle de processus

Autres ressources

Personnalisation des mappages de champs de Microsoft Project

Partager via