witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung

Azure DevOps Services | 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 das unterstützte Verfahren finden Sie unter Anpassen Ihrer Arbeitsverfolgungserfahrung.

Durch Erstellen und Anpassen von Objekten zur Nachverfolgung von Arbeitselementen können Sie die Art der Nachverfolgung des Teamstatus ändern. Mithilfe des Witadmin-Befehlszeilentools können Sie Objekte wie Kategorien, globale Listen, globale Workflows, Linkstypen und Arbeitselemente erstellen, löschen, importieren und exportieren. Sie können auch die Attribute von Arbeitselementfeldern löschen, auflisten oder ändern.

Darüber hinaus können Sie für lokale Azure DevOps Server die Auflösungstypen, Fehlertypen und Fehlertypen verwalten, die mit der Testfallverwaltung mit dem Befehl "tcm fieldmapping" verwendet werden.

Wie die folgende Abbildung zeigt, verwalten Sie Kategorien und Typen und Arbeitselemente für jedes Projekt. Sie verwalten globale Listen, Typen von Links und Feldern in Arbeitselementen für jede Projektsammlung. Sie können den globalen Workflow für ein Projekt oder eine Auflistung anpassen.

Work Item Tracking Objects

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Weitere 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.

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

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Weitere 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 für alte Arbeitselemente zu ändern. Sie können es nicht verwenden, um Formulare zu bearbeiten, die mit den neuen Webformularen verknüpft sind.

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

Für die meisten Befehle müssen Sie Mitglied der Gruppen Project Administratoren oder Project Sammlungsadministratoren sein. Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Projektsammlungsebene.

Ausführen des Witadmin-Befehlszeilentools

Um das Witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, in dem Visual Studio installiert ist. Das Witadmin-Befehlszeilentool installiert mit einer beliebigen 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 mit 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 EnterpriseCommunityanstelle von , 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 EnterpriseCommunityanstelle von , 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 installieren (die Zugriff auf Team Explorer bietet) oder Visual Studio Team-Explorer 2017 kostenlos.

Globale Parameter

Sie können die folgenden Parameter verwenden, um Hilfetext für witadmin anzuzeigen.

Parameter BESCHREIBUNG
/help
oder
/?
Zeigt die Syntax und Parameter für das Witadmin-Befehlszeilentool an.
befehl /help
oder
befehl /?
Zeigt die Syntax und Parameter für den witadmin-Befehl an, den Sie angeben.

XML-Definitionsdateien

Sie passen alle Arbeitsverfolgungsobjekte wie Arbeitselementtypen, Prozesskonfiguration, globale Listen an, indem Sie ihre XML-Definitionen aktualisieren. Wenn Sie neu für die Anpassung der Arbeitsverfolgung sind, finden Sie unter Anpassen Ihrer Arbeitsverfolgungserfahrung.

Sie führen Witadmin-Befehle für Azure DevOps Services oder lokale Azure DevOps Server aus. Wie in den folgenden Befehlslisten dargestellt, werden nur witadmin-Befehle unterstützt, die Dateien für die Azure DevOps Services auflisten oder exportieren.

Arbeitselementtypen

Arbeitselemente werden verwendet, um alles nachzuverfolgen, was Sie nachverfolgen müssen. Jedes Arbeitselement basiert auf einem Arbeitselementtyp. Jede Arbeitselementtypen definiert die verfügbaren Felder, in denen Informationen gespeichert werden sollen. Die verfügbaren Arbeitselementtypen hängen vom Prozess ab, den Sie verwendet haben, wenn Ihr Projekt erstellt wurde (Agile, Scrum, Basic oder CMMI). Weitere Informationen finden Sie unter Nachverfolgen Ihrer Arbeitselemente in Azure Boards Benutzergeschichten, Problemen, Fehlern, Features und Epen.

Für das geerbte Prozessmodell können Sie Arbeitselementtypen aus dem Webportal hinzufügen und löschen. Informationen zum Hinzufügen und Verwalten von Arbeitselementtypen (Vererbungsprozess) finden Sie unter "Hinzufügen und Verwalten".


Befehl

Azure DevOps Services

Azure DevOps Server


destroywitd: Löschen eines Arbeitselementtyps

✔️

exportwitd: Exportieren einer Arbeitselementtypdatei

✔️

✔️

importwitd: Importieren einer Arbeitselementtypdatei

✔️

listwitd: Listenarbeitselementtypen

✔️

✔️

umbenennen: Ändern des Anzeigenamens für einen Arbeitselementtyp

✔️


Fields

Felder werden verwendet, um den Status und die Informationen zu nachverfolgen, die mit Arbeitselementen verknüpft sind. Felder werden für eine Organisation oder Auflistung definiert. Weitere Informationen zu Feldern finden Sie unter "Arbeitselementfelder und -attribute". Informationen zum Nachschlagen der Beschreibung eines bestimmten Felds finden Sie unter Feldbeschreibungen für Standard- und Arbeitselementfelder, die in Prozessvorlagen verwendet werden.

Für das geerbte Prozessmodell können Sie Felder im Webportal anzeigen und löschen. Informationen zum Hinzufügen und Verwalten von Feldern (Vererbungsprozess) finden Sie unter "Hinzufügen und Verwalten".


Befehl

Azure DevOps Services

Azure DevOps Server


Deletefield: Löschen eines Felds

✔️

listfields: Listenfeldattribute

✔️

✔️

Indexfeld: Aktivieren/Deaktivieren von Feldindexierung

✔️

Changefield: Ändern eines Feldattributes

✔️

umbenennen: Ändern eines WIT-Anzeigenamens

✔️


Kategorien

Kategorien zuordnen eine oder mehrere Arbeitselementtypen, die zu derselben Kategorie gehören. Azure Boards basiert auf Standardkategoriendefinitionen, von denen viele einen einzelnen Arbeitselementtyp pro Kategorie angeben. Informationen zu Kategorien und deren Verwendung finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitselementtypen.


Befehl

Azure DevOps Services

Azure DevOps Server


exportcategories: Exportieren der Kategoriedatei

✔️

✔️

importcategories: Importieren der Kategoriendatei

✔️


Sie verwenden verschiedene Verknüpfungstypen, um die verschiedenen Beziehungen zwischen Arbeitselementen zu verwalten. Für lokale XML- und gehostete XML-Prozessmodelle können Sie benutzerdefinierte Linktypen definieren. Weitere Informationen zu Standardlinktypen finden Sie unter Verwalten von Abhängigkeiten, Verknüpfen von Arbeitselementen und Referenzhandbuch für Linktypen.


Befehl

Azure DevOps Services

Azure DevOps Server


deletelinktype: Löschen eines Linktyps

✔️

exportlinktype: Exportieren einer Linktypdatei

✔️

✔️

importlinktype: Importieren einer Linktypdatei

✔️

listlinktypes: Auflisten der definierten Linktypen

✔️

✔️

reaktivierenlinktype: Reaktivieren oder Umbenennen eines Linktyps

✔️


Globale Listen

Globale Listen sind Auswahllisten, die Sie innerhalb eines oder mehrerer Felder und Arbeitselementtypdefinitionen einschließen können. Sie können Listenelemente in mehreren Arbeitselementtypen für eine Auflistung von Projekten freigeben, indem Sie die Listenelemente in einem oder mehreren GLOBALLIST-Elementen einschließen. Weitere Informationen finden Sie unter GLOBALLIST XML-Elementreferenz.


Befehl

Azure DevOps Services

Azure DevOps Server


destroygloballist: Löschen einer globalen Liste

✔️

exportgloballist: Exportieren der globalen Liste

✔️

✔️

importgloballist: Importieren der globalen Liste

✔️

listgloballist: Liste aller globalen Listennamen

✔️

✔️


Globaler Workflow

Mit dem globalen Workflow können Sie Felder und globale Listen definieren und aktualisieren, die auf alle Arbeitselementtypen in einem Projekt oder einer Auflistung gelten. Weitere Informationen finden Sie unter Global workflow XML-Elementreferenz.


Befehl

Azure DevOps Services

Azure DevOps Server


exportglobalworkflow: Exportieren der globalen Workflowdatei

✔️

importglobalworkflow: Importieren der globalen Workflowdatei

✔️


Prozesskonfiguration

Die Prozesskonfiguration definiert die Standardkonfigurations- und Funktionsfunktionen, auf die Ihre Teams mit Azure Boards zugreifen können. Die Konfiguration bestimmt die Arbeitselementtypen, die im Produktbacklog angezeigt werden, Sprint-Backlogs, Kanban-Board und Taskboard. Informationen zur Prozesskonfiguration und zum Anpassen finden Sie unter ProcessConfiguration.

Für das geerbte Prozessmodell können Sie Backlogs aus dem Webportal anpassen. Informationen dazu finden Sie unter Anpassen Ihrer Backlogs oder Boards (Vererbungsprozess).


Befehl

Azure DevOps Services

Azure DevOps Server


exportprocessconfig: Exportieren der ProcessConfiguration-Datei

✔️

✔️

importprocessconfig: Importieren der ProcessConfiguration-Datei

✔️


Arbeitselemente

Der folgende Witadmin-Befehl ist nur für TFS 2018.1 und frühere Versionen verfügbar. Es wurde für TFS 2018.2 und höher versionen veraltet. Weitere Informationen zum endgültigen Löschen von Arbeitselementen für spätere Versionen finden Sie unter Entfernen, Löschen oder Wiederherstellen von Arbeitselementen.

  • destroywi: Dauerhaft löschen Arbeitselemente

Clientcache

Nach bestimmten Wartungsvorgängen benötigen Clientcomputer eine Cacheaktualisierung. Nach dem Verschieben, Wiederherstellen, Umbenennen oder Failover eines Datenebenen- oder Anwendungsebenenservers müssen Sie den Cache für die Verfolgung von Arbeitselementen aktualisieren, und die Benutzer müssen den Cache für die Versionskontrolle auf den Clientcomputern aktualisieren.

Der folgende Witadmin-Befehl ist nur für Azure DevOps Server lokal verfügbar.

  • Neuaufbaucache: Erstellen des Clientcaches

Testfallverwaltungsfeldzuordnung

Zum Anpassen der Auflösungstypen, des Fehlerelementtyps und der Fehlertypen, die beim Arbeiten mit Azure Test Plans verwendet werden, können Sie den folgenden tcm-Befehl verwenden. Dieser Befehl ist nur für lokale Versionen Azure DevOps Server verfügbar.

  • tcm fieldmapping: Importieren oder Exportieren einer Datei, die die Auflösungstypen, Fehlertypen oder Fehlertypen definiert, die mit der Testfallverwaltung verwendet werden sollen.