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

Vous pouvez personnaliser la façon dont vous synchronisez des données entre Visual Studio Team Foundation Server 2012 et Microsoft 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.

[!REMARQUE]

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 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 des éléments XML du mappage de champs pour l'intégration de Team Foundation Server et Project Server et Personnaliser le mappage de champs entre Project Server et Team Foundation Server.

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

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

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

[!REMARQUE]

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, sélectionnez Démarrer, ouvrez le menu contextuel Invite de commandes, puis sélectionnez 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 sur le site Web Microsoft : Registry Virtualization 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 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 spécifiez le commutateur d' /useDefaultFieldMappings lorsque vous remplacez les mappages existants par différents mappages.

Retour au début

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

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/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 à AdventureWorksCollection.

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

Retour au début

Voir aussi

Tâches

Configurer l'intégration de Team Foundation Server et Project Server

Concepts

Référence des éléments XML du mappage de champs pour l'intégration de Team Foundation Server et Project Server

Restrictions du mappage des champs Project Server pour l'intégration avec Team Foundation Server

Gérer l'intégration de Project Server avec TfsAdmin ProjectServer

Autres ressources

Personnaliser le mappage de champs entre Project Server et Team Foundation Server