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

Article
08/10/2011

Vous pouvez personnaliser le mode de synchronisation des données entre Visual Studio Team Foundation Server 2010 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 Team Foundation Server 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 TFSFieldMapping.

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

Pour utiliser l'outil de ligne de commande TFSAdmin ProjectServer, ouvrez une fenêtre d'invite de commandes sur un ordinateur qui exécute Team Explorer et Visual Studio Team Foundation Server 2010 Service Pack 1. Exécutez l'outil à partir du répertoire suivant : Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. Sur les ordinateurs 64 bits, l'outil se trouve dans Lecteur:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Autorisations requises

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 Assignation des autorisations pour prendre en charge l'intégration entre Project Server et Team Foundation Server.

Notes

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Contrôle de compte d'utilisateur.

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://NomServeur:Port/NomRépertoireVirtuel/NomCollection Si vous ne spécifiez pas de répertoire virtuel, indiquez l'URI au format suivant : http://NomServeur:Port/NomCollection
/filePath:mappingFile	Spécifie le chemin d'accès et le nom du fichier de définition XML qui contient les mappages de champs. Remarque 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 du site Web Microsoft : Virtualisation des registres et Problèmes de virtualisation de fichiers système 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 des éléments XML du mappage de champs pour l'intégration de Team Foundation Server et Project Server.
/force	Remplace le fichier de mappage existant. Vous devez spécifier cette option si vous remplacez les mappages existants par d'autres mappages.

Retour au début

Notes

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 pour l'intégration avec Team Foundation 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 Collection0

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

Les actions suivantes se produisent quand vous exécutez l'option /UploadFieldMappings :

Si aucun mappage de champs n'est défini pour la collection de projets d'équipe et que vous ne spécifiez pas l'option /useDefaultFieldMappings, un message vous invite à créer un mappage de champ par défaut.
S'il existe des mappages de champs et que vous spécifiez l'option /useDefaultFieldMappings, un message vous invite à confirmer le remplacement des mappages existants.
Vous devez spécifier l'option /force si vous voulez remplacer les mappages de champs qui ont été précédemment téléchargés dans une collection.
Le fichier de mappage de champs est validé avant qu'il ne soit téléchargé. Si vous rencontrez une erreur de syntaxe ou si vous avez spécifié un champ qui n'est pas valide, un message d'erreur s'affiche.

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.

Retour au début

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/Collection0/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 sur AdventureWorksCollection et remplace tous les mappages de champs précédemment définis.

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

Retour au début