Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Wichtig

Für das lokale XML-Prozessmodell können Sie witadmin verwenden, um einen Prozess für ein Projekt auflisten, importieren, exportieren und ändern. Für die Geerbten und gehosteten XML-Prozessmodelle können Sie nur witadmin verwenden, um Prozessinformationen auflisten und exportieren zu können. Eine Übersicht über Prozessmodelle und die unterstützten Funktionen finden Sie unter Anpassen Ihrer Arbeitsverfolgungserfahrung.

Sie können Arbeitsaufgabentypen für ein Projekt mithilfe der folgenden witadmin-Befehle verwalten:

  • destroywitd: Zerstört einen Arbeitselementtyp und zerstört jedes Arbeitselement dieses Typs dauerhaft ohne Wiederherstellung.
  • exportwitd: Exportiert die Definition eines Arbeitselementtyps in eine XML-Datei oder in das Eingabeaufforderungsfenster.
  • importwitd: Importiert Arbeitsaufgabentypen aus einer XML-Definitionsdatei in ein Projekt. Wenn bereits ein Arbeitsaufgabentyp mit demselben Namen vorhanden ist, wird der vorhandene Arbeitsaufgabentyp durch den neuen überschrieben. Wenn der Arbeitselementtyp nicht vorhanden ist, wird ein neuer Arbeitselementtyp erstellt. Verwenden Sie die Option "/v ", um den XML-Code zu überprüfen, der einen Arbeitselementtyp definiert, aber nicht die Datei importiert.
  • listwitd: Zeigt die Namen der Arbeitselementtypen im angegebenen Projekt im Eingabeaufforderungsfenster an.
  • umbenannt: Ändert den Anzeigenamen eines Arbeitselementtyps innerhalb eines bestimmten Projekts. Nachdem Sie diesen Befehl ausgeführt haben, zeigen Arbeitsaufgaben dieses Typs den neuen Namen.

Weitere Informationen dazu, wie Arbeitsaufgabentypen zum Nachverfolgen der Arbeit verwendet werden, finden Sie unter "Nachverfolgen Ihrer Arbeitsaufgaben" in Azure Boards Benutzergeschichten, Problemen, Fehlern, Features und Epen.

So führen Sie das Befehlszeilentool witadmin aus

Um das Befehlszeilentool witadmin auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, in dem Visual Studio installiert ist. Das Befehlszeilentool witadmin installiert mit jeder Version von Visual Studio. Sie können auf dieses Tool zugreifen, indem Sie die kostenlose Version von Visual Studio Community oder Visual Studio Team Explorer installieren.

Hinweis

Wenn Sie eine Verbindung mit einem lokalen Server herstellen, müssen Sie dieselbe oder höhere Version von Visual Studio oder Team Explorer wie Azure DevOps Server verwenden. Wenn Sie beispielsweise eine Verbindung mit einer TFS 2017-Instanz herstellen, müssen Sie eine Verbindung von Visual Studio 2017 oder Team Explorer 2017 herstellen. Es gibt keine Team Explorer 2015-Version.

Visual Studio 2019- oder Team Explorer 2019-Client:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerProfessional oder anstelle Enterprise von Community, je nachdem, welche Version Sie installiert haben.

Visual Studio 2017- oder Team Explorer 2017-Client:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerProfessional oder anstelle Enterprise von Community, je nachdem, welche Version Sie installiert haben.

Ersetzen Sie auf einer 32-Bit-Edition von Windows %programfiles(x86)% durch %programfiles%. Sie können Visual Studio Community (die Zugriff auf Team-Explorer bietet) oder Visual Studio Team Explorer 2017 kostenlos installieren.

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie verwenden können, umfassen den Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio installiert haben). Installieren Sie den Prozessvorlagen-Editor aus dem Visual Studio Marketplace.

Alternativ können Sie auch den TFS Team Project Manager verwenden, einen Open-Source-Client, der über GitHub verfügbar ist.

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie verwenden können, umfassen den Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio installiert haben). Installieren Sie den TFS-Prozessvorlagen-Editor aus dem Visual Studio Marketplace. Sie können diese Version des Prozess-Editors verwenden, um die Formulare der alten Arbeitsaufgabe zu ändern. Sie können es nicht verwenden, um Formulare zu bearbeiten, die mit den neuen Webformularen verknüpft sind.

Alternativ können Sie auch den TFS Team Project Manager verwenden, einen Open-Source-Client, der über GitHub verfügbar ist.

Voraussetzungen

Für das Projekt, in dem die Arbeitselementtypen definiert sind, müssen Sie die folgenden Berechtigungen festlegen:

  • Um Arbeitsaufgabentypen zu exportieren oder auflisten zu können, müssen Sie Mitglied der Gruppe "Projektadministratoren" sein oder die Berechtigung "Informationen auf Projektebene anzeigen" auf "Zulassen" festlegen.
  • Um Arbeitsaufgabentypen zu zerstören, zu importieren oder umzubenennen, müssen Sie Mitglied der Sicherheitsgruppe "Team Foundation-Administratoren " oder der Sicherheitsgruppe " Projektadministratoren " sein.

Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Projektsammlungsebene.

Hinweis

Auch wenn Sie sich mit Administratorberechtigungen anmelden, müssen Sie ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Um ein Fenster mit erhöhten Rechten zu öffnen, wählen Sie "Start" aus, öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie dann "Als Administrator ausführen" aus. Weitere Informationen finden Sie auf der Microsoft-Website: Benutzer-Access Control.

Syntax

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]   
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportgloballists]  
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 Projektsammlung an. Das Format für den URI ist folgendes: http://ServerName:Port/VirtualDirectoryName/CollectionName

Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format:

http://ServerName:Port/CollectionName
/p:Project Das Projekt, für das die Arten von Arbeitselementen verwaltet werden sollen. Dieses Projekt muss in der durch den Parameter "/collection " angegebenen Projektsammlung definiert werden.

Der Parameter "/p " ist erforderlich, es sei denn, Sie führen den Importwitd-Befehl mit der Option /v aus.
/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 Arbeitselementtypen enthält. Wenn Sie diesen Parameter auslassen, wenn Sie den Befehl exportwitd verwenden, wird der XML-Code im Eingabeaufforderungsfenster angezeigt.

Hinweis: Wenn Sie Windows Vista verwenden, verfügen Sie möglicherweise nicht über Berechtigungen für bestimmte Ordner. 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 der Seite "Registrierungsvirtualisierung " auf der Microsoft-Website.
/e:Encoding Der Name eines .NET Framework 2.0-Codierungsformats. Der Befehl verwendet die angegebene Codierung, um die XML-Daten zu exportieren oder zu importieren. Gibt beispielsweise /e:utf-7 Unicode-Codierung (UTF-7) an. Wenn Sie diesen Parameter weglassen, versucht witadmin , die Codierung zu erkennen, und wenn die Erkennung fehlschlägt, 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 Arbeitselementtypdefinition 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 Projekt anzugeben. Verweise auf Gruppen aus dem Projektumfang werden ignoriert.
/new:NewName Der neue Name des Arbeitsaufgabentyps.
/noprompt Deaktiviert die Eingabeaufforderung zur Bestätigung.
/? oder Hilfe Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Bemerkungen

Wenn Sie den Befehl "destroywitd" verwenden, werden alle folgenden Objekte zerstört:

  • Der Arbeitsaufgabentyp
  • Alle Arbeitselemente dieses Typs
  • Entsprechende Einträge in den Arbeitselementtabellen, den Langtexttabellen und den Linktabellen
  • Objekte im Metadatencache für Arbeitselementtypen

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

  • URI für die Projektsammlung: 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 das Arbeitselement 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 Arbeitselementtyp definiert, aber nicht die Definition importiert.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v  

Fragen und Antworten (Q & A)

F: Welche Anpassungen kann ich vornehmen und weiterhin den Assistenten zum Konfigurieren von Features verwenden, um mein Projekt nach einem Upgrade zu aktualisieren?

Eine: Sie können benutzerdefinierte WITs hinzufügen und das Formularlayout ändern. Der Assistenten zum Konfigurieren von Features aktualisiert Ihre Projekte, und Sie erhalten Zugriff auf die neuesten Features.

Wenn Sie den Workflow ändern oder ein WIT umbenennen, müssen Sie möglicherweise einige manuelle Vorgänge ausführen, wenn Sie Ihr Projekt aktualisieren. Informationen zu den Anpassungen, die Sie sicher vornehmen können und welche Sie vermeiden sollten, finden Sie unter Anpassen der Arbeitsverfolgungserfahrung: Bevor Sie die Wartungs- und Upgrade-Auswirkungen anpassen, verstehen Sie die Wartungs- und Upgrade-Auswirkungen.

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

Eine: Im Webportal werden Arbeitselemente in Abfrageergebnissen und auf den Backlog- und Boardseiten der agilen Planungstools angezeigt. Um die Farbe zu ändern, die einem vorhandenen WIT zugeordnet ist, oder fügen Sie die Farbe hinzu, die für ein neues WIT verwendet werden soll, bearbeiten Sie die Prozesskonfiguration.

Farbzuweisungen zu verschiedenen Arbeitselementtypen

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

Eine: Wenn Sie über ein WIT verfügen, das Sie beenden möchten, aber die Arbeitselemente beibehalten, die basierend auf diesem Typ erstellt wurden, können Sie eine Regel hinzufügen, die alle gültigen Benutzer deaktiviert, um den Arbeitselementtyp 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:

  • Fügen Sie das WIT zur Gruppe "Ausgeblendete Kategorien " hinzu, um die Mehrheit der Mitwirkenden daran zu hindern, sie zu erstellen. Wenn Sie einen Benutzerzugriff zulassen möchten, können Sie einen Link zu einer Vorlage erstellen , die das Arbeitselementformular öffnet und diesen Link mit diesen Teammitgliedern freigeben soll, die sie erstellen möchten.
  • Fügen Sie dem Workflow für das Feld "System.CreatedBy" eine Feldregel hinzu, um eine Gruppe von Benutzern effektiv einzuschränken, um ein Arbeitselement eines bestimmten Typs zu erstellen. Wie im folgenden Beispiel dargestellt, muss der Benutzer, der das Arbeitselement erstellt, zur Allowed Group Speicherung des Arbeitselements gehören.
<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?

Eine: Damit Teammitglieder eine bestimmte WIT verwenden, um ein Arbeitselement zu erstellen, können Sie sie aus dem Projekt entfernen. Wenn Sie verwenden witadmin destroywitd, entfernen Sie dauerhaft alle Arbeitselemente, die mit diesem WIT erstellt wurden, sowie das WIT selbst. Wenn Ihr Team beispielsweise nicht Impediment verwendet, können Sie das 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 ein WIT löschen, das zu einer Kategorie gehört, müssen Sie die Kategoriendefinition für das Projekt aktualisieren, um den neuen Namen darzustellen. Insbesondere funktionieren die agilen Planungstools erst, wenn Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Import- und Exportkategorien.