Fichier de mappage de champs Microsoft Project
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.
Remarque
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 :
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é.
Remarque
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. |