Verwalten von Feldzuordnungen für die Integration von TFS-Project Server
Sie können die Synchronisierung von Daten zwischen Visual Studio Team Foundation Server (TFS) und Microsoft Project Server anpassen, indem Sie die Feldzuordnungsdatei ändern. Diese Datei definiert, welche Datenfelder auf welche Art synchronisiert werden, um die Integration von TFS und Project Server zu unterstützen. Sie können diese Datei mit den folgenden Optionen des TfsAdmin ProjectServer-Befehlszeilentools verwalten:
/DownloadFieldMappings: Lädt die Feldzuordnungsdatei herunter, die für eine Teamprojektauflistung definiert ist.
/UploadFieldMappings: Überprüft die XML-Syntax von der Feldzuordnungsdatei und lädt sie in eine Auflistung hoch. Um die Syntax zu überprüfen, ohne die Datei hochzuladen, können Sie die /validateonly-Option verwenden.
Hinweis
Die Feldzuordnungsdatei für die Integration von Team Foundation Server und Project Server unterscheidet sich von der Feldzuordnungsdatei für Microsoft Project.Informationen zum Herunterladen oder Hochladen der zweiten Datei finden Sie unter Hochladen oder Herunterladen der Microsoft Project-Zuordnungsdatei [TFSFieldMapping].
Weitere Informationen zum Inhalt der Feldzuordnungsdatei und zu deren Anpassung finden Sie unter Feldzuordnungsverweis für XML-Elemente für die Integration von TFS-Project Server und Anpassen der Feldzuordnung zwischen TFS und Project Server.
Um das TfsAdmin ProjectServer-Befehlszeilentool zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster, an dem entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
Ersetzen Sie bei einer 32-Bit-Windows-Edition %programfiles(x86)% durch %programfiles%.
Voraussetzungen
Um diese Befehle zu verwenden, muss die Berechtigung Project Server-Integration verwalten für die Teamprojektauflistung auf Zulassen festgelegt sein. Außerdem müssen dem Dienstkonto für Team Foundation Server die erforderlichen Berechtigungen für die Interaktion mit der Instanz von Project Web Access oder Project Web App (PWA) gewährt werden, die in die Datensynchronisierung einbezogen wird. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zum Unterstützen der TFS-Project Server-Integration.
Syntax
TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]
Parameter
Parameter |
Beschreibung |
|---|---|
/collection:tpcURL |
Gibt die URL (Uniform Resource Locator) einer Teamprojektauflistung an. Sie geben die URL im folgenden Format an: http://ServerName:Port/VirtualDirectoryName/CollectionName Wenn Sie kein virtuelles Verzeichnis angeben, geben Sie die URI im folgenden Format an: http://ServerName:Port/CollectionName |
/filePath:mappingFile |
Gibt den Pfad und den Dateinamen der XML-Definitionsdatei an, die die Feldzuordnungen enthält. Hinweis Wenn Sie Windows Vista verwenden, besitzen Sie möglicherweise für bestimmte Ordner keine Zugriffsberechtigung.Wenn Sie versuchen, den Arbeitsaufgabentyp nach einem Speicherort zu exportieren, für den Sie keine Berechtigungen festgelegt haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, an dem Sie über ausreichende Berechtigungen verfügen.Weitere Informationen finden Sie auf den folgenden Seiten der Microsoft-Website: Registrierungsvirtualisierung und Häufig auftretende Datei- und Registrierungsvirtualisierungsprobleme in Windows Vista. |
/encoding:encoding |
Gibt den Namen eines Codierungsformats für .NET Framework 2.0 an. Der Befehl exportiert oder importiert die XML-Daten in das angegebene Codierungsformat. Beispielsweise gibt "/e:utf-7" die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter nicht angeben, versucht der Befehl, die Codierung zu erkennen. Er verwendet UTF-8, wenn die Erkennung fehlschlägt. |
/validateOnly |
Überprüft die Zuordnungsdatei, lädt sie aber nicht hoch. |
/useDefaultFieldMappings |
Lädt die Standardfeldzuordnungen statt einer benutzerdefinierten Zuordnungsdatei hoch. Weitere Informationen finden Sie unter Feldzuordnungsverweis für XML-Elemente für die Integration von TFS-Project Server. |
/force |
Überschreibt die vorhandene Zuordnungsdatei. Sie müssen diese Option angeben, wenn Sie den /useDefaultFieldMappings-Schalter beim Ersetzen der vorhandenen Zuordnungen durch andere Zuordnungen angeben. |
Hinweise
Sie können nur benutzerdefinierte Enterprise-Felder oder Felder zuordnen, die in Project Server integriert sind. Sie müssen den Namen eines gültigen Felds in Project angeben. Um den Namen eines integrierten Felds zu bestimmen, entfernen Sie alle Leerzeichen aus dem Anzeigenamen, und stellen Sie dem Ergebnis "pj" voran. Der Feldname für Status-Manager ist z. B. pjStatusManager, und der Feldname für Benutzerdefiniert 01 ist pjCustom01. Es bestehen Einschränkungen hinsichtlich der Zuordnung von integrierten und benutzerdefinierten Feldern, und Sie müssen die Datentypen der Felder abgleichen. Weitere Informationen finden Sie unter Einschränkungen bei der Zuordnung von Project Server-Feldern bei der Integration von TFS-Project Server.
Wenn Sie einen TFSAdmin ProjectServer-Befehl ausführen, gibt eine Meldung die Aktion an, die ausgeführt wird, sowie das betroffene Objekt. Die folgende Meldung weist z. B. darauf hin, dass die Feldzuordnungsdatei heruntergeladen wird:
Download field mappings from DefaultCollection
Eine andere Meldung wird angezeigt, nachdem die Befehlsaktionen abgeschlossen wurden. Die folgende Meldung wird z. B. angezeigt, wenn die Feldzuordnungsdatei heruntergeladen wurde:
You have downloaded field mappings to C:MappingFile. . . Done.
Hinweise zum Hochladen von Feldzuordnungen
Wenn eine Feldzuordnungsdatei erfolgreich hochgeladen wurde, werden die folgenden Änderungen vorgenommen:
Jedes Spiegelfeld in Team Foundation wird so konfiguriert, dass die zugeordneten Felder eingehalten werden.
Für Arbeitsaufgabentypen, die für eine Auflistung oder ein Teamprojekt zugeordnet wurden, werden die neuen Zuordnungen auf der Registerkarte Project Server des Arbeitsaufgabenformulars angezeigt.
Wichtig
Stellen Sie beim Zuordnen eines Felds aus Team Foundation Server zu Project Server sicher, dass die Datentypen dieser Felder übereinstimmen.Andernfalls kann beim Hochladen der Feldzuordnungen der folgende Fehler auftreten:
Der Index, basierend auf 0 (null), muss größer oder gleich null sein und kleiner als die Größe der Argumentliste.
Weitere Informationen finden Sie unter Datentypen und Feldzuordnungskriterien.
Beispiele
Herunterladen der Feldzuordnungsdatei, die für eine Teamprojektauflistung definiert ist
Im folgenden Beispiel werden die Feldzuordnungen, die für AdventureWorksCollection definiert sind, in die Datei "AWMappingFile.xml" heruntergeladen.
TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
Hochladen der Feldzuordnungsdatei für eine Teamprojektauflistung
Im folgenden Beispiel wird "AWMappingFile.xml" in AdventureWorksCollection hochgeladen.
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
Siehe auch
Aufgaben
Konfigurieren der TFS-Project Server-Integration
Konzepte
Feldzuordnungsverweis für XML-Elemente für die Integration von TFS-Project Server
Zuordnen von Integrationskomponenten [TfsAdmin ProjectServer]