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. .gif "Remarque") 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.
.gif "Gg412643.collapse_all(fr-fr,VS.110).gif")
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 Data Types and Field Mapping Criteria.
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
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