Partager via

Personnaliser le fichier de mappage des champs Microsoft Project

  • Article

Vous pouvez personnaliser la manière dont les champs d'élément de travail définis dans Team Foundation sont mappés aux champs définis dans Microsoft Project, et modifier la façon dont certains champs sont publiés. Microsoft Project inclut des champs prédéfinis, tel 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 à ceux de Microsoft Project.

Pour plus d'informations sur l'utilisation de Project et de TFS pour suivre un travail, consultez Créer votre journal des travaux en souffrance (backlog) et vos tâches à l'aide de Project.

Pour modifier les mappages de champs pour un projet d'équipe, vous exportez, puis importez le fichier de mappage Microsoft Project à l'aide de l'outil en ligne de commande TFSFieldMapping.

É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 champ.

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

Attributs

Le tableau suivant présente 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 ajoutant le préfixe « pj » au nom, par exemple, pjTaskName pour la colonne Nom de la tâche. Spécifiez les champs personnalisés en ajoutant un nombre à pjTaskText, par exemple, pjTaskText11.

NomProjet

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

Notes

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

PublishOnly

Facultatif. Si la valeur est true, cela indique que le champ est publié dans la base de données des éléments de travail, mais 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 la valeur est 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 la valeur est true, cela indique que le champ n'est jamais publié dans la base de données des éléments de travail, mais est actualisé à partir de celle-ci lorsque les conditions suivantes sont vérifiées :

  • 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 définies sur Yes.

  • La tâche récapitulative contient au moins une tâche enfant liée à Team Foundation Server.

Les mises à jour ou calculs que Microsoft Project opère 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, en cas de publication dans la base de données des éléments de travail, entraînent des incohérences de données.

Si la valeur est false, cela indique que le champ peut être publié et actualisé. La valeur par défaut est false.

Notes

La valeur affectée à l'attribut IfSummaryRefreshOnly remplace la valeur affectée à PublishOnly.Pour plus d'informations, consultez la section 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 montre comment mapper le champ du type d'élément de travail contenant le titre au champ Microsoft Project du nom de la tâche :

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

La syntaxe XML suivante montre un exemple plus complexe illustrant la manière de mapper le champ du type élément de travail contenant la date de début au champ Microsoft Project de date de début. Le champ étant calculé, il est spécifié pour publier et ne pas actualiser, afin d'éviter que les mises à jour de Team Explorer introduisent des erreurs.

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

Notes

Comme meilleure pratique, il est recommandé de mapper les champs calculés dans Microsoft Project aux champs en lecture seule dans Team Foundation.Cela permet d'éviter toute confusion afin que les membres de l'équipe ne tentent pas de modifier les champs calculés.

Élément ReservedField

L'élément ReservedField opère pour prendre en charge les liens hiérarchiques définis entre les tâches. Il est facultatif.

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

Élément SyncField

Le champ de synchronisation permet de contrôler le comportement de publication et d'actualisation de chaque tâche. Le champ affiche une colonne avec le titre Publier et actualiser lorsque vous utilisez l'affichage 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 de synchronisation. Pour spécifier un champ de synchronisation, utilisez l'élément SyncField. L'attribut ProjectField doit être défini sur un champ Office Project valide.

<SyncField ProjectField="" />

L'exemple suivant montre comment spécifier 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 Project [redirection].

Élément ResourceNameSeparator

L'élément ResourceNameSeparator permet de définir le caractère qui distingue les noms de ressource figurant dans une chaîne. Les utilisateurs et ressources de Team Foundation sont synchronisés avec les utilisateurs du service d'annuaire Active Directory. Les noms des utilisateurs et des ressources peuvent inclure un délimiteur, telle une virgule, pour séparer le nom, le prénom et l'initiale du deuxième prénom d'une ressource.

Cet élément est 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 d'Active Directory et de l'équipe de projet est

Dans Office Project, remplacer par

,

;

;

:

.

:

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

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

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

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

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 enfant. Office Project utilise la hiérarchie System.LinkTypes.Hierarchy par défaut pour créer ces liens.

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 attribué au prédécesseur, et un lien successeur au successeur. Il s'agit des désignations par défaut définies pour le type de lien System.LinkTypes.Dependency.

Attributs de mappage qui affectent la publication et l'actualisation

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

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

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

  • La valeur de IfSummaryRefreshOnly pour un champ de mappage spécifique.

  • La classification de la tâche comme une tâche récapitulative ou parent.

    Une tâche parent 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 parent est publié ou actualisé en fonction des attributs de champ de mappage et de 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 si IfSummaryRefreshOnly est true, sa valeur remplace la valeur PublishOnly. Le tableau suivant indique si une tâche récapitulative ou parent est publiée ou actualisée, en fonction de l'attribution qui est faite à sa valeur Publier et actualiser et des attributs de 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

Voir aussi

Concepts

Référence des éléments de type de lien

Ajouter ou modifier le mappage des champs Microsoft Project aux champs TFS