Anpassen und Verwalten von Arbeitsaufgabentypen
Sie können die Arbeitsaufgabentypen für ein Teamprojekt verwalten, indem Sie folgende witadmin-Befehle verwenden:
destroywitd: Zerstört einen Arbeitsaufgabentyp, und zerstört jede Arbeitsaufgabe dieses Typs permanent ohne Wiederherstellungmöglichkeit.
exportwitd: Exportiert die Definition eines Arbeitsaufgabentyps in eine XML-Datei oder zum Eingabeaufforderungsfenster.
importwitd: Importiert Arbeitsaufgabentypen aus einer XML-Definitionsdatei in ein Teamprojekt auf einem Server, der Team Foundation Server ausführt. Wenn ein Arbeitsaufgabentyp mit demselben Namen bereits vorhanden ist, wird der vorhandene Arbeitsaufgabentyp durch den neuen überschrieben. Wenn der Arbeitsaufgabentyp nicht bereits vorhanden ist, erstellt dieser Befehl einen neuen Arbeitsaufgabentyp. Zum Überprüfen der XML, die den Arbeitsaufgabentyp definiert, verwenden Sie die /v-Option, jedoch nicht zum Importieren der Datei.
listwitd: Zeigt die Namen der Arbeitsaufgabentypen im angegebenen Projekt im Eingabeaufforderungsfenster an.
renamewitd: Ändert den Anzeigenamen eines Arbeitsaufgabentyps innerhalb eines bestimmten Projekts. Nachdem Sie diesen Befehl ausgeführt haben, zeigen Arbeitsaufgaben dieses Typs den neuen Namen.
Das Befehlszeilenhilfsprogramm witadmin befindet sich im Verzeichnis Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE auf dem Clientcomputer, auf dem Team Explorer ausgeführt wird.
Weitere Informationen zu Arbeitsaufgabentypen finden Sie unter Hinzufügen von Typdefinitionen für Arbeitsaufgaben zu einer Prozessvorlage.
Tipp
Sie können Arbeitsaufgabentypen mit dem Prozess-Editor erstellen und ändern, einem Powertool für Visual Studio. Dieses Tool wird nicht unterstützt. Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools April 2010 (möglicherweise in englischer Sprache).
Erforderliche Berechtigungen
Für das Teamprojekt, in den die Arbeitsaufgabentypen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:
Zum Exportieren oder aufführen von Arbeitsaufgabentypen müssen Sie Mitglied der Gruppe Readers sein, oder die Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss auf Zulassen festgelegt sein.
Zum Zerstören, Importieren oder Umbenennen von Arbeitselementtypen müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder der Sicherheitsgruppe Projektadministratoren sein.
Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.
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 Microsoft-Website: Benutzerzugriffssteuerung.
witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]
witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]
witadmin listwitd /collection:CollectionURL /p:Project
witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]
Parameter
Parameter |
Beschreibungen |
|---|---|
/collection:CollectionURL |
Gibt den URI der Teamprojektsammlung an. Das Format für den URI sieht folgendermaßen aus: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname |
/p:Projekt |
Das Teamprojekt, für das die Typen von Arbeitsaufgaben verwaltet werden sollen. Dieses Teamprojekt muss in der vom /collection-Parameter angegebenen Projektsammlung definiert werden. Der /p -Parameter ist erforderlich, außer wenn Sie den importwitd-Befehl mit der /v-Option ausführen. |
/n:TypeName |
Der Name des Arbeitsaufgabentyps, der zerstört, exportiert, importiert oder umbenannt werden soll. |
/f:FileName |
Der Pfad und der Dateiname der XML-Definitionsdatei, die die zu exportierenden oder importierenden Arbeitsaufgabentypen enthält. Wenn Sie diesen Parameter weglassen, wenn Sie den exportwitd-Befehl verwenden, wird das XML im Eingabeaufforderungsfenster aufgeführt. .gif "Hinweis") Hinweis
Wenn Sie Windows Vista verwenden, besitzen Sie möglicherweise für 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 zur Registrierungsvirtualisierung finden Sie auf der Microsoft-Website: Registrierungsvirtualisierung und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.
|
/e:Codierung |
Der Name eines .NET Framework 2.0-Codierungsformats. Der Befehl verwendet die angegebene Codierung, um die XML-Daten zu exportieren oder zu importieren. Beispielsweise gibt /e:utf-7 die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und wenn Erkennung fehlschlägt, verwendet witadmin UTF-8. |
/exportgloballists |
Exportiert die Definitionen von globalen Listen, auf die vom Arbeitsaufgabentyp verwiesenen wird. Die Definitionen für globale Listen werden in das XML der Arbeitsaufgabentypdefinition eingebettet. Falls nicht angegeben, werden die Definitionen für globale Listen weggelassen. |
/v |
Überprüft das XML, das den Arbeitsaufgabentyp definiert, importiert jedoch nicht die XML-Definitionsdatei. Hinweis
Sie können die Typdefinition überprüfen, ohne ein Teamprojekt anzugeben.Verweise auf Gruppen aus dem Projektumfang werden ignoriert.
|
/new:NewName |
Der neue Name des Arbeitsaufgabentyps |
/noprompt |
Deaktiviert die Eingabeaufforderung zur Bestätigung. |
/? oder help |
Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an. |
Hinweise
Wenn Sie den destroywitd-Befehl verwenden, werden damit die folgenden Objekte zerstört:
Der Arbeitsaufgabentyp
Alle Arbeitsaufgaben dieses Typs
Entsprechende Einträge in den Arbeitsaufgabentabellen, den langen Texttabellen und den Linktabellen
Objekte im Metadatencache für Arbeitsaufgabentypen
Beispiele
Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:
URI für die Teamprojektsammlung: http://AdventureWorksServer:8080/AWTeam/Collection1
Projektname: AdventureWorks
Eingabe- oder Ausgabedateiname: myworkitems.xml
Name des Arbeitsaufgabentyps: myworkitem
Standardcodierung: UTF-8
Exportieren der Definition eines Arbeitsaufgabentyps
Der folgende Befehl exportiert die Definition für "myworkitem" in die Datei myworkitems.xml.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem
Im folgenden Beispiel wird die Arbeitsaufgabe mit Unicode-Codierung (UTF-7) exportiert.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7
Exportieren der Definition eines Arbeitsaufgabentyps und seiner globalen Listen, auf die verwiesenen wird.
Im folgenden Beispiel werden sowohl der Arbeitsaufgabentyp als auch die globalen Listen exportiert, auf die er verweist.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists
Auflisten der Definition eines Arbeitsaufgabentyps
Im folgenden Beispiel wird die Definition des Arbeitsaufgabentyps im Eingabeaufforderungsfenster angezeigt.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem
Importieren der Definition von Arbeitsaufgabentypen
Im folgenden Beispiel wird die Arbeitsaufgabendefinition aus der XML-Datei importiert.
witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks
Überprüfen der XML-Definition von Arbeitsaufgabentypen
Im folgenden Beispiel wird das XML überprüft, das den Arbeitsaufgabentyp definiert, aber nicht die Definition importiert.
witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v