Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin]

Artikel
11/18/2015

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 Wiederherstellungsmöglichkeit.
exportwitd: Exportiert die Definition eines Arbeitsaufgabentyps in eine XML-Datei oder in das Eingabeaufforderungsfenster.
importwitd: Importiert Arbeitsaufgabentypen von einer XML-Definitionsdatei in ein Teamprojekt auf einem Server, der Team Foundation Server ausführt. Wenn bereits ein Arbeitsaufgabentyp mit demselben Namen 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 einer Arbeitsaufgabentyps innerhalb eines bestimmten Projekts. Nachdem Sie diesen Befehl ausgeführt haben, zeigen Arbeitsaufgaben dieses Typs den neuen Namen.

Das witadmin Befehlszeilentool funktioniert nur, wenn es mit einem lokalen TFS ausgeführt wird. Sie führen dieses Tool aus, indem Sie ein Eingabeaufforderungsfenster öffnen, wo entweder Visual Studio oder Team Explorer installiert ist und Folgendes eingeben:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

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

Weitere Informationen zu Arbeitsaufgabentypen finden Sie unter Hinzufügen von Typdefinitionen für Arbeitsaufgaben zu einer Prozessvorlage.

Hinweis

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.

Anforderungen

Für das Teamprojekt, in dem die Arbeitsaufgabentypen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

Um Arbeitsaufgabentypen zu exportieren oder aufzulisten, müssen Sie Mitglied der Sicherheitsgruppe Projektadministratoren sein, oder für die Berechtigung Projektebeneninformationen anzeigen muss 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 Berechtigungsreferenz für 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 Microsoft-Website Benutzerkontensteuerung.

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	Beschreibung
/collection:CollectionURL	Gibt den URI der Teamprojektauflistung an. Der URI hat folgendes Format: http://Servername:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://ServerName:Port/CollectionName
/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 bei Verwendung des Befehls exportwitd weglassen, wird das XML im Eingabeaufforderungsfenster aufgeführt. Hinweis Wenn Sie Windows Vista verwenden, besitzen Sie möglicherweise für 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 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. /e:utf-7 gibt beispielsweise die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und bei fehlgeschlagener Erkennung verwendet witadmin UTF-8.
/exportgloballists	Exportiert die Definitionen von globalen Listen, auf die vom Arbeitsaufgabentyp verwiesen 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: Neuer Name	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 Langtexttabellen 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 Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection
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/tfs/DefaultCollection /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/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Exportieren der Definition eines Arbeitsaufgabentyps und seiner globalen Listen, auf die verwiesen wird

Im folgenden Beispiel werden sowohl der Arbeitsaufgabentyp als auch die globalen Listen exportiert, auf die er verweist.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /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/tfs/DefaultCollection /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/tfs/DefaultCollection /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/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Fragen und Antworten

F: Welche Anpassungen kann ich vornehmen und trotzdem den Assistenten zum Konfigurieren von Funktionen verwenden, um mein Teamprojekt nach einem TFS-Upgrade zu aktualisieren?

A: Sie können Arbeitsaufgabentypen hinzufügen und das Formularlayout ändern. Ihre Teamprojekte werden vom Assistenten zum Konfigurieren von Funktionen aktualisiert, und Sie erhalten Zugriff auf die neuesten Funktionen.

Wenn Sie den Workflow ändern oder ein WIT umbenennen, können manuelle Eingriffe beim Aktualisieren Ihres Teamprojekts nötig sein. Informationen darüber, welche Anpassungen Sie bedenkenlos vornehmen und welche Sie besser vermeiden sollten, finden Sie unter Anpassen der Arbeitsnachverfolgung: Vor Durchführung einer Anpassung mit den Auswirkungen auf Wartung und Upgrades vertraut machen.

F: Wie kann ich die einem Arbeitsaufgabentyp zugeordnete Farbe ändern?

A: In Team Web Access werden Arbeitsaufgaben in den Abfrageergebnissen und auf den Backlog- und Board-Seiten der Agile-Planungstools angezeigt. Um die einem vorhandenen WIT zugeordnete Farbe zu ändern oder die für einen neuen WIT zu verwendende Farbe hinzuzufügen, bearbeiten Sie die Prozesskonfiguration.

Farbzuweisungen zu verschiedenen Arbeitsaufgabentypen

F: Wie deaktiviere ich einen WIT?Wie hindere ich Benutzer an der Erstellung von Arbeitsaufgaben eines bestimmten Typs?

A: Wenn Sie über einen WIT verfügen, den Sie zurückziehen möchten, die auf Grundlage dieses Typs erstellten Arbeitsaufgaben jedoch beibehalten möchten, können Sie eine Regel hinzufügen, die alle gültigen Benutzer daran hindert, den Arbeitsaufgabentyp zu speichern.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Wenn Sie die Erstellung eines bestimmten WIT auf eine bestimmte Gruppe von Benutzern beschränken möchten, gibt es zwei Möglichkeiten, den Zugriff einzuschränken:

Durch Hinzufügen des WITs zur Gruppe der ausgeblendeten Kategorien werden die meisten Mitwirkenden an deren Erstellung gehindert. Wenn Sie einer Gruppe von Benutzern Zugriff gewähren möchten, können Sie einen Hyperlink zu einer Vorlage erstellen, um das Arbeitsaufgabenformular zu öffnen, und diesen Link für die Teammitglieder freigeben, die sie erstellen sollen.
Wenn Sie dem Workflow eine Feldregel für das Feld "System.CreatedBy" hinzufügen, wird eine Benutzergruppe effektiv daran gehindert, eine Arbeitsaufgabe eines bestimmten Typs zu erstellen. Wie das folgende Beispiel zeigt, muss der Benutzer, der die Arbeitsaufgabe erstellt, zur Allowed Group gehören, um die Arbeitsaufgabe zu speichern.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

F: Wie lösche ich einen WIT?

A: Um zu verhindern, dass Teammitglieder einen bestimmten WIT zur Erstellung einer Arbeitsaufgabe verwenden, können Sie diesen aus dem Teamprojekt entfernen. Wenn Sie witadmin destroywitd verwenden, entfernen Sie dauerhaft alle Arbeitsaufgaben, die mit diesem WIT erstellt wurden, sowie den WIT selbst. Wenn das Team beispielsweise "Impediment" nicht verwendet, können Sie den WIT mit der Bezeichnung "Impediment" aus dem Fabrikam-Websiteprojekt löschen.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Wenn Sie einen WIT löschen, der einer Kategorie angehört, müssen Sie die Kategoriendefinition für das Teamprojekt aktualisieren, sodass sie dem neuen Namen entspricht. Insbesondere die Agile-Planungstools werden nicht funktionieren, bis Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Importieren und Exportieren von Kategorien [witadmin].

Siehe auch

Share via