Verwalten von Feldzuordnungen für die Integration von Team Foundation Server und Project Server

Artikel
07/20/2011

Sie können die Synchronisierung von Daten zwischen Visual Studio Team Foundation Server 2010 und Project Server anpassen, indem Sie die Feldzuordnungsdatei ändern. Diese Datei definiert, welche Datenfelder auf welche Art synchronisiert werden, um die Integration von Team Foundation Server und Project Server zu unterstützen. Sie können diese Dateien mit den folgenden Optionen des Befehlszeilentools TFSAdmin ProjectServer verwalten:

/DownloadFieldMappings: Lädt die Feldzuordnungsdatei herunter, die für eine Teamprojektsammlung definiert wird.
/UploadFieldMappings: Überprüft die XML-Syntax von der Feldzuordnungsdatei und lädt sie in eine Auflistung hoch. Um die Syntax zu überprüfen, aber die Datei nicht hochzuladen, können Sie die /validateonly-Option verwenden.

Tipp

Die Feldzuordnungsdatei für die Integration von Team Foundation Server und Project Server ist getrennt von der Feldzuordnungsdatei für Microsoft Project. Informationen zum Herunterladen oder Hochladen der zweiten Datei finden Sie unter TFSFieldMapping.

Weitere Informationen zum Inhalt der Feldzuordnungsdatei und wie sie angepasst wird finden Sie unter XML-Elementverweis für Feldzuordnungen für die Integration von Team Foundation Server und Project Server und Anpassen von Feldzuordnungen zwischen Project Server und Team Foundation Server.

Um das Befehlszeilentool TFSAdmin ProjectServer zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster auf einem Computer, der Team Explorer und Visual Studio Team Foundation Server 2010 Service Pack 1 ausführt. Führen Sie das Tool im folgenden Verzeichnis aus: Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE. Bei 64-Bit-Computern befindet sich das Tool im Verzeichnis Laufwerk:\Programme (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Erforderliche Berechtigungen

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 für die Unterstützung der Integration von Project Server und Team Foundation Server.

Tipp

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

Syntax

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

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

Parameter

Parameter	Beschreibungen
/collection:tpcURL	Gibt die URL (Uniform Resource Locator) der 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/Auflistungsname
/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 den Zugriff auf bestimmte Ordner keine Berechtigungen.Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Berechtigungen besitzen, 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äufige Probleme mit der Datei- und Registrierungsvirtualisierung 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 und 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 XML-Elementverweis für Feldzuordnungen für die Integration von Team Foundation Server und Project Server.
/force	Überschreibt die vorhandene Zuordnungsdatei. Sie müssen diese Option angeben, wenn Sie die vorhandenen Zuordnungen durch andere Zuordnungen ersetzen.

Zurück nach oben

Hinweise

Sie können nur benutzerdefinierte Unternehmensfelder oder Felder zuordnen, die in Project Server integriert sind. Sie müssen den Namen eines gültigen Felds im Projekt 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 Übereinstimmung der Datentypen von Feldern sicherstellen. Weitere Informationen finden Sie unter Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server.

Wenn Sie einen TFSAdmin ProjectServer-Befehl ausführen, gibt eine Meldung die Aktion an, die ausgeführt wird, und das betroffene Objekt. Die folgende Meldung zeigt z. B. an, dass die Feldzuordnungsdatei heruntergeladen wird:

Download field mappings from Collection0

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

Die folgenden Aktionen werden ausgeführt, wenn Sie die /UploadFieldMappings-Option ausführen:

Wenn keine Feldzuordnungen für die Teamprojektsammlung definiert werden und Sie die /useDefaultFieldMappings-Option nicht angeben, fordert Sie eine Meldung auf, eine Standardfeldzuordnung zu erstellen.
Wenn Feldzuordnungen vorhanden sind und Sie die /useDefaultFieldMappings-Option angeben, werden Sie von einer Meldung aufgefordert zu bestätigen, dass Sie die vorhandenen Zuordnungen überschreiben möchten.
Sie müssen die /force-Option angeben, wenn Sie Feldzuordnungen überschreiben möchten, die zuvor zu einer Auflistung hochgeladen wurden.
Die Feldzuordnungsdatei wird überprüft, bevor sie hochgeladen wird. Wenn Sie einen Syntaxfehler haben oder ein Feld angaben, das nicht gültig ist, wird eine Fehlermeldung angezeigt.

Wenn eine Feldzuordnungsdatei erfolgreich hochgeladen wird, 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.

Zurück nach oben

Beispiele

Herunterladen der Feldzuordnungsdatei, die für eine Teamprojektsammlung 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/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Feldzuordnungsdatei für eine Teamprojektauflistung hochladen

Im folgenden Beispiel wird AWMappingFile.xml zu AdventureWorksCollection hochgeladen, und alle Feldzuordnungen, die zuvor definiert wurden, werden überschrieben.

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

Zurück nach oben