Partager via

Gérer des mappages de champs pour l'intégration de Team Foundation Server et Project Server

  • Article

Personnalisez le mode de synchronisation des données entre Visual Studio Team Foundation Server et Project Server en modifiant le fichier de mappage de champs. Ce fichier définit les champs de données qui sont synchronisés et le mode de synchronisation pour prendre en charge l'intégration de TFS et Project Server. Vous pouvez gérer ce fichier à l'aide des options suivantes de l'outil de ligne de commande TfsAdmin ProjectServer :

  • /DownloadFieldMappings : Télécharge le fichier de mappage de champs qui est défini pour une collection de projets d'équipe.

  • /UploadFieldMappings : Valide la syntaxe de XML du fichier de mappage de champs, et la télécharge à une collection. Pour valider la syntaxe, mais ne pas télécharger le fichier, utilisez l'option /validateonly.

Notes

Le fichier de mappage de champ pour l'intégration de Team Foundation Server et Project Server est distinct du fichier de mappage de champs de Microsoft Project.Pour plus d'informations sur le mode de téléchargement du deuxième fichier, consultez Charger ou télécharger le fichier de mappage Microsoft Project [TFSFieldMapping].

Pour plus d'informations sur le contenu du fichier de mappage de champs et sur son mode de personnalisation, consultez Référence d'éléments XML de mappages de champs pour l'intégration de Team Foundation Server et de Project Server et Personnaliser le mappage de champs entre TFS et Project Server.

Pour utiliser l'outil de ligne de commande TfsAdmin ProjectServer, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%.

Configuration requise

Pour utiliser ces commandes, votre autorisation Administrer pour l'intégration Project Server doit avoir la valeur Autoriser pour la collection de projets d'équipe. En outre, le compte de service de Team Foundation Server doit bénéficier des autorisations nécessaires pour interagir avec l'instance de Project Web Access ou Project Web App (PWA) qui doit faire partie de la synchronisation des données. Pour plus d'informations, consultez Accorder les autorisations pour prendre en charge l'intégration de TFS et Project Server.

Syntaxe

TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

Paramètres

Paramètre

Description

/collection:tpcURL

Spécifie l'URL (Uniform Resource Locator) d'une collection de projets d'équipe. Spécifiez l'URL au format suivant :

http://ServerName:Port/VirtualDirectoryName/CollectionName

Si vous ne spécifiez pas de répertoire virtuel, indiquez l'URI au format suivant :

http://ServerName:Port/CollectionName

/filePath:mappingFile

Spécifie le chemin d'accès et le nom du fichier de définition XML qui contient les mappages de champs.

Notes

Si vous utilisez Windows Vista, il est possible que nous ne disposiez pas d'autorisations d'accès à certains dossiers.Si vous tentez d'exporter le type d'élément de travail vers un emplacement pour lequel aucune autorisation ne vous est attribuée, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel.Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous disposez d'autorisations.Pour plus d'informations, consultez les pages suivantes sur le site Web Microsoft : Virtualisation du Registre et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.

/encoding:encoding

Spécifie le nom d'un format d'encodage pour le .NET Framework 2.0. La commande exporte ou importe les données XML dans le format d'encodage que vous spécifiez. Par exemple, /e:utf-7 spécifie l'encodage (UTF-7) Unicode. Si vous ne spécifiez pas ce paramètre, la commande essaie de détecter l'encodage et utilise UTF-8 si la détection échoue.

/validateOnly

Valide le fichier de mappage, mais ne le télécharge pas.

/useDefaultFieldMappings

Télécharge les mappages de champs par défaut à la place d'un fichier de mappage personnalisé. Pour plus d'informations, consultez Référence d'éléments XML de mappages de champs pour l'intégration de Team Foundation Server et de Project Server.

/force

Remplace le fichier de mappage existant. Vous devez spécifier cette option si vous spécifiez le commutateur /useDefaultFieldMappings lorsque vous remplacez les mappages existants par des mappages différents.

Remarques

Vous ne pouvez mapper que les champs personnalisés d'entreprise ou des champs qui sont créés dans Project Server. Vous devez spécifier le nom d'un champ valide dans le projet. Pour déterminer le nom d'un champ prédéfini, supprimez les espaces du nom convivial, et ajoutez le préfixe "pj". Par exemple, le nom du champ du gestionnaire d'état est pjStatusManager, et le nom du champ Custom 01 est pjCustom01. Il existe des restrictions sur le mode de mappage des champs intégrés et personnalisés ; vous devez mettre en correspondance les types de données avec les champs. Pour plus d'informations, consultez Restrictions du mappage des champs Project Server dans l'intégration de TFS et Project Server.

Lorsque vous exécutez une commande TFSAdmin ProjectServer, un message indique l'action en cours d'exécution et l'objet affecté. Par exemple, le message suivant indique que le fichier de mappage de champs est en cours de téléchargement :

Download field mappings from DefaultCollection

Un autre message apparaît après que les actions de commande ont été effectuées. Par exemple, le message suivant apparaît quand le fichier de mappage de champs a été téléchargé :

You have downloaded field mappings to C:MappingFile. . . Done.

Remarques sur le téléchargement de mappages de champs

Si un fichier de mappage de champs est téléchargé avec succès, les modifications suivantes sont effectuées :

  • Chaque champ du miroir dans Team Foundation est configuré pour se conformer aux champs mappés.

  • Pour les types d'éléments de travail qui ont été mappés pour une collection ou un projet d'équipe, les nouveaux mappages apparaissent sur le l'onglet Project Server du formulaire d'élément de travail.

Important

Lorsque vous mappez un champ de Team Foundation Server à Project Server, assurez-vous de mettre en correspondance les types de données de ces champs.Sinon, l'erreur suivante peut s'afficher lorsque vous essayez de télécharger les mappages de champs :

L'index (base zéro) doit être supérieur ou égal à zéro et inférieur à la taille de la liste d'arguments.

Pour plus d'informations, consultez Types de données et critères de mappage de champs.

Exemples

Téléchargement du fichier de mappage de champs défini pour une collection de projets d'équipe

L'exemple suivant télécharge les mappages de champs qui sont définis pour AdventureWorksCollection dans AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Téléchargement du fichier de mappage de champs pour une collection de projets d'équipe

L'exemple suivant télécharge AWMappingFile.xml vers AdventureWorksCollection.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Voir aussi

Tâches

Configurer l'intégration de TFS et Project Server

Concepts

Référence d'éléments XML de mappages de champs pour l'intégration de Team Foundation Server et de Project Server

Restrictions du mappage des champs Project Server dans l'intégration de TFS et Project Server

Mapper les composants d'intégration [TfsAdmin ProjectServer]

Autres ressources

Personnaliser le mappage de champs entre TFS et Project Server