Personnaliser le fichier de mappage des champs Microsoft Project
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 :
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