Fichier de mappage de champs Microsoft Project

  • Article

Vous pouvez personnaliser la façon dont les champs définis pour les éléments de travail de Team Foundation sont mappés aux champs de Microsoft Project, et vous pouvez modifier la façon dont certains champs sont publiés. Dans le fichier de mappage de champs pour Microsoft Project, vous pouvez définir des mappages entre des champs de Team Foundation et de Microsoft Project. Microsoft Project inclut des champs prédéfinis, tels que Nom de la tâche, et des champs personnalisés. Lorsque vous publiez ou actualisez des données d'élément de travail dans Microsoft Project, le mappage de champs détermine les champs de la base de données des éléments de travail qui correspondent aux champs de Microsoft Project.

Dans le fichier de mappage, vous spécifiez des champs pour chaque projet d'équipe. Pour l'extraire, vous devez le télécharger à partir d'un projet d'équipe. Après avoir modifié le fichier, vous pouvez le télécharger sur le projet d'équipe pour appliquer les modifications à tous les utilisateurs de ce projet d'équipe. Pour plus d'informations sur le téléchargement du fichier de mappage de champs pour Microsoft Project, consultez Télécharger ou transférer un fichier de mappage de champs Microsoft Project.

Dans cette rubrique

  • Élément Mapping

  • Élément ReservedField

  • Élément SyncField

  • Élément ResourceNameSeparator

  • Type de lien de hiérarchie

  • Type de lien de dépendance

  • Attributs de mappage qui affectent la publication et l'actualisation

Élément Mapping

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

Vous 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 ensuite utilisé pour spécifier un mappage de champs.

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

Attributs

Le tableau suivant décrit les attributs qui peuvent être utilisés avec 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'un champ dans 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.

Nom du projet

Facultatif. Spécifie le nom à afficher comme nom de colonne dans Microsoft Project. 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 sur Microsoft Project. Vous pouvez spécifier les valeurs suivantes : pjMinute, pjHour, pjDay, pjWeek et pjMonthUnit.

RemarqueRemarque
Vous pouvez spécifier ProjectUnits uniquement pour les champs qui spécifient la durée ou d'autres unités de temps.

PublishOnly

Facultatif. Si cet attribut a la valeur true, cela indique que le champ est publié dans la base de données des éléments de travail, mais qu'il n'est 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é. La valeur par défaut est false.

Dans le fichier de mappage par défaut, les deux champs dont l'attribut PublishOnly a la valeur true sont Date de début et Date de fin.

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 Office 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é. La valeur par défaut est false lorsque cet attribut n'est pas spécifié.

RemarqueRemarque
La valeur assignée à l'attribut IfSummaryRefreshOnly remplace la valeur assignée à PublishOnly.Pour plus d'informations, consultez Champs qui affectent la publication et l'actualisation plus loin dans cette rubrique.

Dans le fichier de mappage par défaut, l'attribut IfSummaryRefreshOnly a la valeur true pour les champs Estimation d'origine, Travail restant et Travail effectué.

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"/>

Notes

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.

Retour au début

Élément ReservedField

L'élément ReservedField prend en charge les liens hiérarchiques définis entre des tâches. Cet élément est facultatif.

Si cet élément n'est pas spécifié dans le mappage, Microsoft Project utilise alors le champ pjNumber20 par défaut.

Retour au début

Élément SyncField

Le champ de synchronisation vous permet de contrôler le comportement de publication et d'actualisation de chaque tâche. Le champ est affiché sous forme d'une colonne avec le titre Publier et actualiser lorsque vous utilisez la vue Tableau des tâches Team System.

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. Pour spécifier un champ de synchronisation, utilisez l'élément SyncField. L'attribut ProjectField doit avoir pour valeur un champ Office Project valide.

<SyncField ProjectField="" />

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

<SyncField ProjectField="pjTaskText25" />

Pour plus d'informations sur l'utilisation du champ de synchronisation dans Office Project, consultez Publier ou actualiser des éléments de travail dans Office Project.

Retour au début

Élément ResourceNameSeparator

Vous pouvez utiliser ResourceNameSeparator pour définir le caractère qui distinguera les noms de ressource qui sont dans une chaîne. Les utilisateurs et ressources Team Foundation sont synchronisés avec les utilisateurs du service d'annuaire Active Directory. Les noms pour les utilisateurs et les ressources peuvent inclure un délimiteur, tel qu'une virgule, pour séparer le nom, le prénom et l'initiale du deuxième prénom d'une ressource.

Il s'agit d'un élément facultatif. Si cet élément n'est pas spécifié dans le mappage, Microsoft Project sépare les noms de ressource à l'aide des mappages par défaut définis dans le tableau suivant :

Si le séparateur de liste Active Directory et de projet d'équipe est

Dans Office Project, remplacer par

,

;

;

:

.

:

Si vous voulez spécifier un caractère autre que ceux répertoriés dans le tableau ci-dessus, vous pouvez définir ResourceNameSeparator à l'aide de la syntaxe suivante :

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

L'exemple suivant indique comment spécifier le caractère « * » comme séparateur dans Office Project lorsque le caractère Team Foundation est « - » :

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

Retour au début

Type de lien de hiérarchie

Lorsque vous créez des tâches récapitulatives dans Microsoft Project, un lien d'arborescence est créé entre la tâche récapitulative, le parent et les tâches subordonnées ou enfants. Office Project utilise System.LinkTypes.Hierarchy par défaut pour créer ces liens.

Retour au début

Type de lien de dépendance

Lorsque vous créez des liens entre des tâches dans Microsoft Project, vous créez un lien dépendant entre les tâches. Un lien Prédécesseur est assigné à la tâche de type prédécesseur et un lien Successeur est assigné à la tâche de type successeur. Il s'agit des désignations par défaut définies pour le type de lien System.LinkTypes.Dependency.

Retour au début

Attributs de mappage qui affectent la publication et l'actualisation

Les champs de mappage et les valeurs des champs Microsoft Project suivants déterminent si une valeur pour un élément de travail est publiée ou actualisée :

  • Valeur de Publier et actualiser pour chaque élément de travail.

  • Valeur de l'attribut PublishOnly pour un champ de mappage spécifique.

  • Valeur d'IfSummaryRefreshOnly pour un champ de mappage spécifique.

  • Classification de la tâche comme une tâche récapitulative ou parente.

    Une tâche parente est une tâche qui a au moins une tâche enfant publiée dans Team Foundation Server.

Pour les éléments de travail qui ne sont pas des tâches récapitulatives

Le tableau suivant indique si un élément de travail qui n'est pas une tâche récapitulative ou parente est publié ou actualisé selon les attributs d'un champ de mappage et l'assignation à la valeur Publier et actualiser de l'élément.

Publier et actualiser

(niveau de tâche)

Attribut PublishOnly

Champ publié ?

Champ actualisé ?

Non

True ou False

Non

Non

Actualiser uniquement

True ou False

Non

Oui

Oui

True

Oui

Non

Oui

False

Oui

Oui

Pour les éléments de travail qui sont des tâches récapitulatives

Si les critères de tâche récapitulative sont satisfaits et que IfSummaryRefreshOnly a la valeur true, sa valeur remplace la valeur PublishOnly. Le tableau suivant indique si une tâche récapitulative ou parente est publiée ou actualisée selon l'assignation à sa valeur Publier et actualiser et les attributs d'un champ de mappage.

Publier et actualiser

(niveau de tâche)

Attribut PublishOnly

IfSummaryRefreshOnly

Attribut

Champ publié ?

Champ actualisé ?

Non

True ou False

True ou False

Non

Non

Actualiser uniquement

True

True

Non

Oui

Actualiser uniquement

True

False

Non

Oui

Actualiser uniquement

False

True ou False

Non

Oui

Oui

True ou False

True

Non

Oui

Oui

True

False

Oui

Non

Oui

False

False

Oui

Oui

Retour au début

Voir aussi

Concepts

Utilisation des types de liens

Autres ressources

Personnalisation des mappages de champs de Microsoft Project

Historique des modifications

Date

Historique

Motif

Octobre 2010

Informations supprimées sur les éléments DependencyLinkType et HierarchyLinkType parce que la version actuelle ne les prend pas en charge.

Commentaires client.