Hinzufügen oder Ändern eines Arbeitselementtyps

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

Ihr Projekt enthält eine Reihe von Arbeitselementtypen, die auf dem Prozess basierend auf dem Prozess – Agile, Scrum oder CMMI – verwendet werden, um das Projekt zu erstellen. Ein Arbeitselementtyp ist das Objekt, das Sie zum Nachverfolgen verschiedener Arbeitstypen verwenden.

Sie können einen vorhandenen Arbeitselementtyp ändern oder einen benutzerdefinierten Arbeitselementtyp basierend auf den Nachverfolgungsanforderungen oder Workflowprozessen Ihres Teams hinzufügen. Die häufigsten Gründe zum Ändern eines Arbeitselementtyps sind das Hinzufügen oder Ändern der Gruppe von Feldern oder Feldregeln, Ändern des Workflows oder Anpassen des Arbeitselementformulars.

Weitere Informationen finden Sie unter Hinzufügen oder Ändern eines Felds, wenn Sie ein benutzerdefiniertes Feld hinzufügen oder die Feldregeln oder Attribute eines vorhandenen Felds ändern möchten.

Die meisten Anpassungen des Arbeitselementtyps werden in der XML-Definition des Arbeitselementtyps vorgenommen, andere Anpassungen werden jedoch über die Prozesskonfigurationsdefinition oder über das Witadmin-Befehlszeilentool vorgenommen.

Hinweis

Für Azure DevOps Services oder für Sammlungen, die das Erbenprozessmodell verwenden, finden Sie unter Hinzufügen und Verwalten von Arbeitselementtypen.

Definition des Arbeitselementtyps

ProcessConfiguration-Definition

Befehlszeilenänderung

Voraussetzungen

  • Um Arbeitselementtypen auflisten zu können, müssen Sie über die Berechtigung " Projektebene anzeigen" für das Projekt im Auflistungssatz " Zulassen" verfügen.
  • Wenn Sie einen Arbeitselementtyp hinzufügen oder anpassen möchten, indem Sie eine Prozessvorlage anpassen, müssen Sie Mitglied der Gruppe "Project Sammlungsadministratoren" sein oder ihre Berechtigung "Prozess bearbeiten" auf "Zulassen" festlegen.
  • Um Arbeitselementtypen auflisten zu können, müssen Sie über die Berechtigung " Projektebene anzeigen" für das Projekt im Auflistungssatz " Zulassen" verfügen.
  • Wenn Sie einen Arbeitselementtyp hinzufügen oder anpassen möchten, müssen Sie Mitglied der Gruppe "Project Administratoren" sein oder ihre Berechtigung "Projektebeneninformationen bearbeiten" auf "Zulassen" festlegen.

Informationen zum Hinzufügen als Administrator finden Sie unter Ändern von Berechtigungen auf Projektsammlungsebene.

Wie wirken sich Änderungen an Arbeitselementtypen auf vorhandene Arbeitselemente aus?

In der folgenden Tabelle werden die Auswirkungen auf vorhandene Arbeitselemente zusammengefasst, wenn Sie Felder oder Arbeitselementtypdefinitionen ändern.

Aktion Auswirkungen auf vorhandene Arbeitselemente
Entfernen von Feldern aus einem Arbeitselementtyp Die Daten der entfernten Felder verbleiben im Datenspeicher. Es können jedoch keine neuen Daten hinzugefügt werden, da Sie sie aus der Arbeitselementtypdefinition entfernt haben.
Umbenennen eines Felds Die Daten der umbenannten Felder verbleiben unter einem neuen Anzeigenamen im Datenspeicher.
Löschen von Feldern Die Daten der gelöschten Felder werden aus dem Datenspeicher entfernt.
Umbenennen eines Arbeitselementtyps Alle Daten bleiben unter dem neuen Namen erhalten.
Löschen eines Arbeitselementtyps Alle Daten für Arbeitselemente, die als gelöschter Arbeitselementtyp erstellt wurden, werden dauerhaft entfernt, ohne die Möglichkeit für die Wiederherstellung.

Wenn Sie die Felder vollständig aus dem Datenspeicher entfernen möchten, verwenden witadmin deletefield Sie das Befehlszeilentool.

Importieren und Exportieren von Arbeitselementtypdefinitionsdateien

Hinweis

Wenn Sie das Gehostete XML-Prozessmodell verwenden, müssen Sie die Prozessvorlage importieren und exportieren, die von Ihrem Projekt verwendet wird. Ausführliche Informationen finden Sie unter Anpassen des Webformulars zum Nachverfolgen von Arbeitselementen.

  1. Wenn Sie keine Verwaltungsberechtigungen für Ihr Projekt haben, rufen Sie sie ab.

    1. Öffnen Sie ein Eingabeaufforderungsfenster gemäß den Anweisungen in witAdmin: Anpassen und Verwalten von Objekten zum Nachverfolgen von Arbeiten. Beispiel:
  2. Exportieren Sie die Definitionsdatei des Arbeitselementtyps, in der Sie ein Feld ändern oder hinzufügen möchten. Geben Sie den Namen des Arbeitselementtyps und einen Namen für die Datei an.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Ein Beispiel für eine CollectionURL ist http://MyServer:8080/tfs/TeamProjectCollectionName.

  3. Bearbeiten Sie die Datei. Ausführliche Informationen finden Sie unter Index zu XML-Elementdefinitionen.

  4. Importieren Sie die Definitionsdatei.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  5. Öffnen Sie das Webportal, oder aktualisieren Sie die Seite, um die Änderungen anzuzeigen.

    Weitere Informationen zur Verwendung witadminfinden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen.

Hinzufügen oder Ändern eines Arbeitselementtyps

Um einen benutzerdefinierten Arbeitselementtyp hinzuzufügen oder einen vorhandenen Arbeitselementtyp zu ändern, definieren oder ändern Sie die XML-Definitionsdatei, und importieren Sie sie dann auf Der Grundlage des verwendeten Prozessmodells in Ihr Projekt. Sie ändern einen Arbeitselementtyp, indem Sie die in den drei Hauptabschnitten der Definitionsdatei definierten Elemente angeben: FELDER, WORKFLOW und FORMULAR.

Summary of work item type elements

Die einfachste Möglichkeit zum Hinzufügen eines neuen Arbeitselementtyps besteht darin, einen vorhandenen Arbeitselementtyp zu kopieren und dann die Definitionsdatei zu ändern.

Hinzufügen oder Ändern eines Felds, einer Feldregel, einer Bezeichnung oder eines leeren Texts

Jedes Feld, das Sie zum Nachverfolgen von Daten verwenden möchten, müssen der Definitionsdatei hinzugefügt werden. Dies gilt für alle Systemfelder (Felder, deren Referenzname mit System beginnt.) Alle Systemfelder werden für alle Arbeitselementtypen definiert, unabhängig davon, ob Sie sie in die Definition des Arbeitselementtyps einschließen. Weitere Informationen zu jedem Feld finden Sie unter "Arbeitselementfeldindex".

Sie fügen Felder und Feldregeln dem Abschnitt 'FELDER ' hinzu. Damit das Feld im Arbeitselementformular angezeigt werden soll, müssen Sie es auch dem FORMULARabschnitt der Definition hinzufügen.

Wenn Sie beispielsweise die Arbeitselement-ID zu einem Formular hinzufügen möchten, geben Sie die folgende XML-Syntax im FORM Abschnitt an.

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Weitere Informationen zum Definieren von Feldern finden Sie unter Hinzufügen oder Ändern eines Felds.

Ändern des Workflows

STATUS- undGRÜNDEabschnitte im WORKFLOW geben die Listenwerte in den Feldern "Status" und "Grund" an. Sie verfolgen den Status von Arbeitselementen. Der Abschnitt TRANSITIONS gibt die gültigen Übergänge zwischen Zuständen an, wie in der folgenden Abbildung dargestellt. Sie geben sowohl vor- als auch rückwärtige Übergange an.

Example workflow state diagram, Agile user story

Sie ändern den Workflow, um die folgenden Ziele zu erreichen:

  • Hinzufügen oder Entfernen eines Zustands, eines Grunds oder eines Übergangs
  • Geben Sie einen Wert an, der während einer Änderung des Zustands, des Grunds oder des Übergangs angewendet werden soll.
  • Geben Sie eine benutzerdefinierte AKTION an, um Feldzuweisungen basierend auf einer Änderung des Zustands, des Grunds oder des Übergangs zu automatisieren.

Wenn Sie den Workflow anpassen, führen Sie diese beiden Schritte aus:

  1. Ändern Sie den WORKFLOW der Arbeitselementtypdefinition.

  2. Ändern Sie die Prozesskonfiguration, um neue Workflowzustände mit Metastates zuzuordnen.

    Dieser zweite Schritt ist erforderlich, wenn Sie den Workflow für einen Arbeitselementtyp ändern, der auf einer Agile-Toolseite angezeigt wird. Diese Arbeitselementtypen gehören entweder zu den Kategorien "Anforderung" oder "Aufgabe".

Feldregeln für den Workflow

Sie können Feldregeln nur beim Ändern eines Zustands, Angeben eines Grundes oder während eines Workflowübergangs anwenden.

Indem Sie beispielsweise die LEER-Regel hinzufügen, wenn der Zustand auf "Aktiv" festgelegt ist, können Sie das Geschlossene Datum und die Felder "Geschlossen nach" automatisch nullifizieren und sie schreibgeschützt machen. Dies ist hilfreich, wenn ein Arbeitselement aus dem Zustand „Geschlossen“ erneut aktiviert wird.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>  

Wenden Sie Workflowfeldregeln an, um die folgenden Aktionen auszuführen:

  • Qualifizieren Sie den Wert, den ein Feld haben kann, indem SIE CANLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY und REQUIRED angeben.
  • Kopieren eines Werts in ein Feld mithilfe von COPY, DEFAULT und SERVERDEFAULT
  • Einschränken, wer ein Feld ändern kann
  • Erzwingen des Musterabgleichs für ein Zeichenfolgenfeld mithilfe von MATCH
  • Regeln basierend auf Werten in anderen Feldern mit WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED anwenden
  • Schränken Sie Regeln ein, die auf bestimmte Benutzer oder Gruppen angewendet werden sollen. Die meisten Regeln unterstützen die Attribute, die den Fokus haben, für den die Regel gilt und nicht angewendet wird.

Weitere Informationen zum Anwenden von Workflowfeldregeln finden Sie unter FIELD (Workflow)-Elementreferenz und Regeln und Regelauswertung.

Anpassen des Arbeitselementformulars

In den folgenden Abbildungen werden die am häufigsten verwendeten Elemente für Arbeitselementformulare hervorgehoben. Sie können alle Elemente außer den Titelbereich und die Formularsteuerelemente anpassen. Die Elemente, die Sie zum Anpassen des Formulars verwenden, hängen davon ab , ob das neue Formular von Ihrem Administrator aktiviert wurde.

Webformular mit aktivierter neuen Form (VSTS, TFS 2017)

Header element within web form

Altes Webformular in Verwendung (TFS 2015, TFS 2013)

Work item type form controls

Sie können das Formular anpassen, um die folgenden Ziele zu erreichen:

Hinzufügen oder Entfernen eines Arbeitsaufgabentyps aus dem Backlog oder task board

Die Agile-Planungstools – Produktrücklauf, Sprint-Backlog und Task board-Seiten – zeigen bestimmte Arbeitsaufgabentypen basierend auf der Prozessvorlage an, die zum Erstellen Ihres Projekts verwendet wird. Sie können Arbeitsaufgabentypen hinzufügen oder entfernen, die auf diesen Seiten angezeigt werden sollen. Wenn Ihr Projekt beispielsweise Scrum-Arbeitselementtypen verwendet, werden sowohl Produktrückmeldeelemente als auch Fehler auf den Backlogseiten angezeigt. Wenn Ihr Projekt jedoch mithilfe der Agile-, CMMI- oder anderen Prozessvorlage erstellt wurde, werden Fehler nicht in Ihrem Backlog oder Task Board angezeigt.

Sie können beispielsweise Fehler von Product Backlog-Seite hinzufügen.

Hinweis

Die Bilder, die Sie im Webportal sehen, unterscheiden sich möglicherweise von den Bildern, die Sie in diesem Artikel sehen. Diese Unterschiede ergeben sich aus Updates, die an Azure DevOps Services oder ihrer lokalen Bereitstellung vorgenommen wurden. Die grundlegenden Funktionen, die Ihnen zur Verfügung stehen, bleiben jedoch unverändert, es sei denn, explizit erwähnt.

This screen shows how to add bugs from the product backlog page.

Informationen zum Hinzufügen oder Entfernen von Arbeitsaufgabentypen aus dem Backlog oder task board finden Sie unter Hinzufügen eines Arbeitselementtyps zu einem Backlog und board. Informationen zum Hinzufügen eines neuen Arbeitselementtyps zur Unterstützung eines Portfolio-Backlogs finden Sie unter "Hinzufügen eines Portfoliorückstands".

Ändern der Farbe, des Symbols oder des Workflowstatus eines Arbeitselementtyps

Im Webportal werden Arbeitselemente in Abfrageergebnissen und auf den Backlog- und Boardseiten der Agile-Tools angezeigt. Wenn Sie die Farbe oder das Symbol ändern möchten, die einem vorhandenen Arbeitselementtyp zugeordnet ist, oder fügen Sie die Farbe hinzu, die für einen neuen Arbeitselementtyp verwendet werden soll, bearbeiten Sie die Prozesskonfiguration. Um die Farbe für einen Workflowstatus zu ändern, bearbeiten Sie auch die Prozesskonfiguration.

Hinweis

Featureverfügbarkeit: Für lokale XML können Sie die Workflowstatusfarbe für TFS 2015.2 oder höher anpassen und das Symbol für den Arbeitselementtyp für TFS 2017.2 und höhere Versionen anpassen.

Query results showing work item type color, icon, and state color

Ändern des Typs eines vorhandenen Arbeitselements

Siehe Verschieben, Ändern oder Löschen von Arbeitselementen für die Features, die Ihnen basierend auf Ihrer Plattform zur Verfügung stehen.

Wenn Sie eine Verbindung mit TFS herstellen, können Sie den Arbeitselementtyp für eine vorhandene Arbeitsaufgabe nicht ändern, aber Sie können die Arbeitsaufgabe kopieren und einen neuen Typ angeben. Sie können beispielsweise ein vorhandenes Product Backlog Item kopieren und den Typ in Fehler ändern, wie in der folgenden Abbildung gezeigt.

Clone a work item type

Wenn Sie auch mehrere Arbeitselemente mit Typänderungen haben, die Sie vornehmen möchten, möchten Sie sie möglicherweise mithilfe von Excel exportieren und diese dann als neuen Typ erneut hinzufügen.

Deaktivieren oder Deaktivieren eines Arbeitsaufgabentyps

Wenn Sie die Erstellung eines bestimmten Arbeitselementtyps auf eine Gruppe von Benutzern einschränken möchten, fügen Sie der Gruppe "Ausgeblendete Kategorien" den Arbeitselementtyp hinzu, um zu verhindern, dass die meisten Mitwirkenden sie erstellen. Wenn Sie eine Gruppe von Benutzern zugriff zulassen möchten, können Sie einen Link zu einer Vorlage erstellen , die das Arbeitselementformular öffnet, und diesen Link mit diesen Teammitgliedern teilen, die Sie erstellen möchten.

Hinweis

Sie können keine Feldregeln hinzufügen, um den Workflow einzuschränken, da Sie Regeln nicht auf Systemfelder anwenden können.

Löschen eines Arbeitselementtyps

Um zu verhindern, dass Teammitglieder einen bestimmten Arbeitselementtyp verwenden, um eine Arbeitsaufgabe zu erstellen, können Sie sie aus dem Projekt entfernen. Wenn Sie verwenden witadmin destroywitd*, entfernen Sie alle Arbeitselemente, die mithilfe dieses Arbeitselementtyps erstellt wurden, sowie den Arbeitselementtyp selbst. Wenn Ihr Team beispielsweise "Impediment" nicht verwendet, können Sie den Arbeitselementtyp 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 Arbeitselementtyp löschen, der zu einer Kategorie gehört, müssen Sie die Kategoriendefinition für das Projekt aktualisieren, um den neuen Namen widerzuspiegeln. Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen und Import- und Exportkategorien.

Umbenennen eines Arbeitselementtyps

Um einen vorhandenen Arbeitselementtyp umzubenennen, verwenden witadmin renamewitdSie . Sie können beispielsweise einen Arbeitselementtyp mit der Bezeichnung "QoS Item" in "Service Agreement" umbenennen.

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

Wenn Sie einen Arbeitselementtyp umbenennen, der zu einer Kategorie gehört, müssen Sie die Kategoriendefinition für das Projekt aktualisieren, um den neuen Namen widerzuspiegeln. Insbesondere funktionieren die Backlogs und Boards erst, wenn Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen und Import- und Exportkategorien.

Aktivieren von Features nach dem Upgrade

Welche Anpassungen können Sie vornehmen und weiterhin den Assistenten zum Konfigurieren von Features verwenden, um mein Projekt nach einem TFS-Upgrade zu aktualisieren?

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

Wenn Sie den Workflow ändern oder einen Arbeitselementtyp umbenennen, müssen Sie möglicherweise beim Aktualisieren Ihres Projekts manuelle Vorgänge ausführen. Informationen zu anderen Anpassungen, die Sie sicher vornehmen können und die Sie vermeiden sollten, finden Sie unter Anpassen der Arbeitsnachverfolgung: Bevor Sie anpassen, verstehen Sie die Wartungs- und Upgradeauswirkungen.

Workflowänderungen und frühere Versionen des Test-Manager-Clients

Wenn Sie den Workflow für den Testplan oder die Testsuite ändern – und sie arbeiten von einem Test-Manager-Client, der mit Visual Studio 2013.2 oder früheren Versionen bereitgestellt wird – wurden diese Arbeitselementtypen verfügbar, wenn Sie den Server auf Anwendungsebene auf TFS 2013.3 aktualisiert haben. das auf einer Agile-Planungstoolseite angezeigt wird.

Wenn eine Anwendung einen unerwarteten Fehler erkannt hat , wenn Sie eine Verbindung mit Ihrem Projekt herstellen, nachdem Sie den Workflow geändert haben, können Sie ihn beheben, indem Sie die neuen Workflowzustände den Metazuständen zuordnen. Informationen zum Beheben dieses Fehlers finden Sie in der Konfiguration des Import- und Exportprozesses.

In diesem Artikel wurde erläutert, wie Arbeitsaufgabentypen für gehostete XML- und lokale XML-Prozessmodelle hinzugefügt und angepasst werden. Informationen zum Hinzufügen und Anpassen von Arbeitsaufgabentypen für das geerbte Prozessmodell finden Sie unter Anpassen eines Prozesses.

Weitere verwandte Themen oder Ressourcen: