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

Artikel
02/26/2013

Sie können anpassen, wie Sie Daten zwischen Visual Studio Team Foundation Server 2012 und Microsoft Project Server synchronisieren, 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.

Hinweis
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 Hochladen oder Herunterladen der Microsoft Project-Zuordnungsdatei [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 TfsAdmin ProjectServer Befehlszeilentool zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster in dem entweder Visual Studio oder Team Explorer installiert ist und geben Sie Folgendes ein:

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

Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.

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.

Hinweis
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.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

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.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.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	Description
/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 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 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 den /useDefaultFieldMappings Schalter angeben, wenn Sie die vorhandenen Zuordnungen durch verschiedene 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 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 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 Data Types and Field Mapping Criteria.

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 Data Types and Field Mapping Criteria.

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/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Feldzuordnungsdatei für eine Teamprojektauflistung hochladen

Im folgenden Beispiel wird AWMappingFile.xml zu AdventureWorksCollection hoch.

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

Zurück nach oben

Siehe auch

Freigeben über

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

Parameter

Hinweise

Hinweise zum Hochladen von Feldzuordnungen

Beispiele

Herunterladen der Feldzuordnungsdatei, die für eine Teamprojektsammlung definiert ist

Feldzuordnungsdatei für eine Teamprojektauflistung hochladen

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen