Fichier de mappage de champs Microsoft Project

Article
08/21/2008

Mise à jour : novembre 2007

Le fichier de mappage de champs de Microsoft Project définit les mappages de champs entre les champs Team Foundation et Microsoft Project. Contrairement à Microsoft Excel, Microsoft Project utilise un ensemble de champs limités comprenant des champs prédéfinis, 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 est utilisé pour déterminer les champs de la base de données des éléments de travail qui correspondent aux champs dans Microsoft Project.

Le fichier de mappage de champs est spécifié pour chaque projet d'équipe. Pour l'extraire, vous devez le télécharger à partir d'un projet d'équipe. Une fois modifié, vous le téléchargez dans le projet d'équipe et les modifications s'appliquent à tous les utilisateurs de ce projet d'équipe. Pour plus d'informations sur le téléchargement du fichier de mappage de champs de Microsoft Project, consultez Comment : télécharger ou transférer un fichier de mappage de champs Microsoft Project.

Mappages de champs

Pour spécifier un mappage entre un champ d'élément de travail et une colonne de projet, utilisez l'élément Mapping.

Utilisez la syntaxe XML suivante pour spécifier un mappage entre un champ de type d'élément de travail et un champ Microsoft Project. L'élément Mapping est utilisé pour spécifier un mappage de champs.

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly=""/>

Attributs de mappage

Le tableau suivant décrit les attributs qui peuvent être utilisés avec l'élément Mappage.

Attribut	Description
WorkItemTrackingFieldReferenceName	Obligatoire. Spécifie le nom de référence d'un champ de type d'élément de travail.
ProjectField	Obligatoire. Spécifie le nom d'un champ Microsoft Project. Spécifiez des noms de champs 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 de 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 sur 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 no, cela indique que le champ est publié et actualisé. La valeur par défaut est no lorsque cet attribut n'est pas spécifié.

L'exemple suivant indique comment mapper le champ de type d'élément de travail contenant le titre sur le champ Microsoft Project contenant le nom de la tâche :

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

La syntaxe XML suivante affiche un exemple plus complexe qui explique comment mapper le champ de type d'élément de travail contenant la date de début sur le champ Microsoft Project contenant la date de début. Le champ étant calculé, il est spécifié pour être publié mais pas actualisé afin d'éviter l'insertion d'erreurs par les mises à jour Team Explorer.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

Remarque :
Il est recommandé de mapper les champs calculés de Microsoft Project sur les champs en lecture seule de Team Foundation. Cela permet d'éviter les confusions et d'empêcher les membres de l'équipe de modifier les champs calculés.

Champ contextuel

Le champ contextuel est un champ de type d'élément de travail qui affiche des informations sur la relation hiérarchique d'une tâche avec des tâches récapitulatives. Il s'affiche dans Team Explorer afin que les utilisateurs qui n'utilisent pas Microsoft Project puissent consulter les tâches récapitulatives auxquelles une sous-tâche appartient.

Lorsqu'une tâche est une sous-tâche, le champ contextuel contient les noms textuels de la tâche et de sa tâche récapitulative. Par exemple, si la tâche « Développer le plan de test » est une sous-tâche de « Tâches de planification », le champ contextuel lit « Tâches de planification > Développer le plan de test ». Si une tâche contient plusieurs tâches récapitulatives au-dessus d'elle, toutes les tâches récapitulatives sont répertoriées dans le champ contextuel dans la limite de caractères maximale.

Utilisez la syntaxe XML suivante pour spécifier le champ de type d'élément de travail qui correspond au champ contextuel. L'élément ContextField est utilisé pour spécifier un champ contextuel. L'attribut WorkItemTrackingFieldReferenceName doit avoir pour valeur le nom de référence valide d'un champ de type d'élément de travail existant.

<ContextField WorkItemTrackingFieldReferenceName="" />

L'exemple suivant montre comment définir Microsoft.VSTS.Scheduling.TaskHierarchy comme champ contextuel.

<ContextField WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.TaskHierarchy" />

Champ de liens et de pièces jointes

Le champ de liens et de pièces jointes est un champ en lecture seule qui indique si des liens et des pièces jointes sont associés à une tâche. Il affiche Oui ou Non selon qu'il existe ou non des liens et des pièces jointes. Il s'affiche sous forme de colonne avec le titre Liens et pièces jointes lorsque vous utilisez la vue Tableau des tâches Team System.

Utilisez la syntaxe XML suivante pour spécifier le champ Microsoft Project qui doit afficher les informations sur les liens et les pièces jointes. L'élément LinksField est utilisé pour spécifier un champ de lien. L'attribut ProjectField doit avoir pour valeur un champ Microsoft Project valide. La spécification d'un champ de lien dans le fichier de mappage de champs de Microsoft Project est facultative.

<LinksField ProjectField="" />

L'exemple suivant montre comment définir pjTaskText26 comme champ de liens et de pièces jointes :

<LinksField ProjectField="pjTaskText26" />

Champ de synchronisation

Le champ de synchronisation vous permet de contrôler le comportement de publication et d'actualisation de chaque tâche. Il s'affiche sous forme de colonne avec le titre Publier et actualiser lorsque vous utilisez la vue Tableau des tâches Team System. Pour plus d'informations sur l'utilisation du champ de synchronisation dans Microsoft Project, consultez Comment : activer ou désactiver la publication des éléments de travail dans Microsoft Project.

Vous devez spécifier un champ de synchronisation dans le fichier de mappage de champs de Microsoft Project. Utilisez la syntaxe XML suivante pour spécifier le champ qui correspond au champ de synchronisation. L'élément SyncField est utilisé pour spécifier un champ de synchronisation. L'attribut ProjectField doit avoir pour valeur un champ Microsoft Project valide.

<SyncField ProjectField="" />

L'exemple suivant montre comment définir pjTaskText25 comme champ de synchronisation :

<SyncField ProjectField="pjTaskText25" />

Voir aussi

Autres ressources

Personnalisation des mappages de champs de Microsoft Project

Partager via