Definieren der für die Synchronisierung verfügbaren Arbeitsaufgabentypen
Bevor Sie Daten zwischen Visual Studio Team Foundation Server (TFS) und Microsoft Project Server synchronisieren können, müssen Sie die Integration zwischen den beiden Serverprodukten konfigurieren. Als Teil der Konfigurationsaufgaben müssen Sie einem Teamprojekt einen Enterprise-Projektplan zuordnen, und Sie müssen die Typen von Arbeitsaufgaben angeben, die an der Synchronisierung teilnehmen. Nachdem Sie die Erstkonfigurationen und die Erstzuordnung gemacht haben, können Sie die Typen von Arbeitsaufgaben ändern, die zugeordnet werden.
Sie können die Typen von Arbeitsaufgaben, die an der Synchronisierung teilnehmen, mit den folgenden Optionen des TfsAdmin ProjectServer-Befehlszeilentools verwalten:
/MapWorkItemTypes: Definiert die Typen von Arbeitsaufgaben, die in die Synchronisierung für ein Teamprojekt einbezogen werden können. Obwohl Sie mehrere Typen zuordnen können, werden nur jene Arbeitsaufgaben, die zur Veröffentlichung übermittelt werden, synchronisiert.
/GetMappedWorkItemTypes: Gibt die Liste der Arbeitsaufgabentypen zurück, die für die Einbeziehung in die Synchronisierung für ein Teamprojekt konfiguriert sind.
/UnmapWorkItemTypes: Entfernt Arbeitsaufgabentypen aus der Teilnahme an der Synchronisierung für ein Teamprojekt.
Eine Übersicht zum Integrieren der zwei Serverprodukte finden Sie unter Konfigurieren der TFS-Project Server-Integration. Eine Übersicht zum Zuordnen eines Enterprise-Projekts zu einem Teamprojekt finden Sie unter Verwalten der Zuordnung von Enterprise-Projekten zu Teamprojekten.
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 auf Zulassen festgelegt werden. Außerdem müssen dem Dienstkonto für Team Foundation Server die erforderlichen Berechtigungen für die Interaktion mit der Instanz von 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 /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName
TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/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 URL im folgenden Format an: http://ServerName:Port/CollectionName |
/teamProject:TeamProjectName |
Gibt den Namen eines Teamprojekts an, das in der Projektauflistung definiert ist. |
/workItemTypes:ListofWorkItemTypes |
Gibt in einer durch Komma getrennten Liste die Verweisnamen einer oder mehrerer Typen von Arbeitsaufgaben an. Sie sollten nur die Arbeitsaufgabentypen angeben, deren Daten Sie in Project Professional verfolgen möchten. Sie können z. B. die folgenden Typen von Arbeitsaufgaben angeben, um einen agilen Prozess als "“User Story,Task”" oder als “User Story”,Task zu unterstützen. Fügen Sie nach dem Komma kein Leerzeichen ein. |
/skipUIChanges |
Gibt an, dass die Registerkarte Project Server im Arbeitsaufgabenformular für die angegebenen Typen nicht geändert werden soll. Sie sollten dieses Flag einschließen, wenn Sie die Registerkarte Project Server der beteiligten Typen angepasst haben, oder der MapWorkItemTypes-Befehl nicht abgeschlossen werden kann. Sie können eine Typdefinition manuell aktualisieren. Weitere Informationen finden Sie unter Der Definition hinzugefügte XML-Elemente für den Arbeitsaufgabentyp. |
/force |
Entfernt alle Links, die Arbeitsaufgaben der angegebenen Typen an Aufgaben in Project binden. Wenn Sie diese Option verwenden, können Sie Arbeitsaufgabentypen aus der Teilnahme an der Datensynchronisierung entfernen, auch wenn eine oder mehrere Arbeitsaufgaben dieses Typs gerade synchronisiert werden. |
/? oder help |
Zeigt Informationen zum Befehl an. |
Hinweise
Wenn Sie einen Befehl ausführen, wird eine Meldung mit der Aktion, die ausgeführt wird, und dem betroffenen Objekt angezeigt. Die folgende Meldung gibt z. B. an, dass User Stories und Aufgaben konfiguriert werden, die an der Datensynchronisierung teilnehmen.
Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .
Eine andere Meldung wird angezeigt, nachdem der Befehl beendet wurde. Die folgende Meldung gibt z. B. an, dass User Stories und Aufgaben erfolgreich konfiguriert wurden.
You have successfully configured the following work item types for team project ProjA: User Story, Task.
Zusätzlich zum Konfigurieren der Typen von Arbeitsaufgaben, die an der Synchronisierung teilnehmen können, führt der /MapWorkItemTypes-Befehl die folgenden Vorgänge aus:
Er fügt die Typen von Arbeitsaufgaben hinzu, die Sie für die Typen angeben, die an der Datensynchronisierung teilnehmen. Das heißt, der Befehl entfernt keine Zuordnungen bereits vorhandener zugeordneter Typen.
Fügt den Formularen für die angegebenen Arbeitsaufgabentypen die Registerkarte Project Server hinzu.
Wenn eine Project Server-Registerkarte bereits für einen angegebenen Arbeitsaufgabentyp definiert ist, wird dieser Typ ignoriert, und es werden keine Änderungen an den Formularen für Arbeitsaufgaben dieses Typs vorgenommen.
Wenn Sie versuchen, Arbeitsaufgabentypen für ein Teamprojekt zuzuordnen, das keinem Enterprise-Projektplan zugeordnet ist, tritt ein Fehler auf. Sie können nur Arbeitsaufgabentypen für Teamprojekte zuordnen, die für die Einbeziehung in die Synchronisierung konfiguriert sind. Weitere Informationen finden Sie unter Verwalten der Zuordnung von Enterprise-Projekten zu Teamprojekten.
Wenn Sie die Zuordnung für einen Arbeitsaufgabentyp entfernen, wird die Registerkarte Project Server aus dem Formular für diesen Typ für das Teamprojekt entfernt, dessen Zuordnung Sie entfernt haben.
Bevor Sie die Zuordnung eines Arbeitsaufgabentyps für ein Teamprojekt aufheben, müssen Sie die Aufgaben aus dem Enterprise-Projektplan löschen, um alle Zuordnungen zwischen diesen und Arbeitsaufgaben in Team Foundation zu entfernen. Nachdem Sie Aufgaben im Enterprise-Projektplan gelöscht haben, müssen Sie ihn veröffentlichen und warten, bis die Synchronisierung abgeschlossen ist. Als Alternative können Sie das /force-Flag angeben, um alle Links zu entfernen, die Arbeitsaufgaben an Aufgaben für das Teamprojekt binden. Nur Arbeitsaufgaben der angegebenen Typen werden aus der Teilnahme an der Synchronisierung entfernt.
Tipp
Wenn Sie die Aufgaben löschen, können Sie sie zuerst in einen anderen Plan kopieren, um einen Datensatz von ihnen beizubehalten.
Beispiele
Zugeordnete Arbeitsaufgabentypen auflisten
Im folgenden Beispiel werden die Typen von Arbeitsaufgaben abgerufen, die für die Teilnahme an der Synchronisierung des Contoso-Teamprojekts in DefaultCollection auf AdventureWorksServer konfiguriert wurden.
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso
Arbeitsaufgabentyp für ein Teamprojekt zuordnen
Im folgenden Beispiel werden User Stories und Aufgaben so konfiguriert, dass sie an der Datensynchronisierung für das Contoso-Projekt teilnehmen.
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”
Zuordnung eines Arbeitsaufgabentyps für ein Teamprojekt entfernen
Im folgenden Beispiel wird die Teilnahme von Aufgaben an der Datensynchronisierung für das Contoso-Projekt entfernt.
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task
Siehe auch
Konzepte
Angeben der zu synchronisierenden Arbeitsaufgabentypen
Zuordnen von Integrationskomponenten [TfsAdmin ProjectServer]