Hinzufügen oder Ändern eines Arbeitselementtyps

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

Ihr Projekt enthält eine Reihe von Arbeitsaufgabentypen basierend auf dem Prozess – Agile, Scrum oder CMMI –, der zum Erstellen des Projekts verwendet wird. Ein Arbeitselementtyp ist das Objekt, das Sie zum Nachverfolgen verschiedener Arbeitstypen verwenden.

Sie können einen vorhandenen Arbeitsaufgabentyp ändern oder einen benutzerdefinierten Arbeitsaufgabentyp 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 an der XML-Definition des Arbeitselementtyps vorgenommen, andere Anpassungen werden jedoch über die Prozesskonfigurationsdefinition oder über das Witadmin-Befehlszeilentool vorgenommen.

Hinweis

Informationen zu Azure DevOps Services oder für Sammlungen, die das Geerbte Prozessmodell verwenden, finden Sie unter Hinzufügen und Verwalten von Arbeitsaufgabentypen.

Definition des Arbeitselementtyps

ProcessConfiguration-Definition

Befehlszeilenänderung

Voraussetzungen

  • Zum Auflisten von Arbeitsaufgabentypen müssen Sie über die Berechtigung "Informationen auf Projektebene anzeigen " für das Projekt in der Auflistung auf "Zulassen" verfügen.
  • Wenn Sie einen Arbeitselementtyp hinzufügen oder anpassen möchten, indem Sie eine Prozessvorlage anpassen, müssen Sie Mitglied der Gruppe "Projektsammlungsadministratoren" sein oder ihre Berechtigung "Prozess bearbeiten " auf "Zulassen" festlegen.
  • Zum Auflisten von Arbeitsaufgabentypen müssen Sie über die Berechtigung "Informationen auf Projektebene anzeigen " für das Projekt in der Auflistung auf "Zulassen" verfügen.
  • Zum Hinzufügen oder Anpassen eines Arbeitselementtyps müssen Sie Mitglied der Gruppe "Projektadministratoren" sein oder ihre Berechtigung "Projektebene bearbeiten " auf "Zulassen" festlegen.

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

Wie wirken sich Änderungen an Arbeitsaufgabentypen auf vorhandene Arbeitsaufgaben 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 Definition des Arbeitselementtyps 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 dass die Möglichkeit zur Wiederherstellung besteht.

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

Importieren und Exportieren von Arbeitsaufgabentypdefinitionsdateien

Hinweis

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

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

    1. Öffnen Sie ein Eingabeaufforderungsfenster entsprechend den Anweisungen in witAdmin: Anpassen und Verwalten von Objekten zur Nachverfolgung der Arbeit. 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 to 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 Arbeitsaufgabentypen.

Hinzufügen oder Ändern eines Arbeitselementtyps

Wenn Sie einen benutzerdefinierten Arbeitsaufgabentyp hinzufügen oder einen vorhandenen Arbeitselementtyp ändern möchten, definieren oder ändern Sie die XML-Definitionsdatei, und importieren Sie ihn dann basierend auf dem verwendeten Prozessmodell in Ihr Projekt. Sie ändern einen Arbeitselementtyp, indem Sie die in den drei Hauptabschnitten der Definitionsdatei definierten Elemente angeben: FIELDS, WORKFLOW und FORM.

Zusammenfassung der Elemente des Arbeitselementtyps

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, muss der Definitionsdatei hinzugefügt werden. Dies gilt für alle Systemfelder (Felder, deren Bezugsname mit System beginnt).) Alle Systemfelder werden für alle Arbeitsaufgabentypen 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 zum ABSCHNITT FIELDS hinzu. Damit das Feld im Arbeitselementformular angezeigt wird, müssen Sie es auch dem FORMULARabschnitt der Definition hinzufügen.

Wenn Sie z. B. die Arbeitselement-ID zu einem Formular hinzufügen möchten, geben Sie die folgende XML-Syntax innerhalb des FORM Abschnitts 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

STATE and REASON Sections within the WORKFLOW specify the pick list values in the State and Reason fields. 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.

Beispiel für Workflowstatusdiagramm, Agile-Benutzergeschichte

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 für feld 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 Definition des Arbeitselementtyps.

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

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

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 Status auf "Aktiv" festgelegt ist, können Sie die Felder "Geschlossenes Datum" und "Geschlossen nach" automatisch nullieren 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 eines Felds, indem Sie CANLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY und ERFORDERLICH angeben.
  • Kopieren eines Werts in ein Feld mithilfe von COPY, DEFAULT und SERVERDEFAULT
  • Einschränken, wer ein Feld ändern kann
  • Erzwingen des Musterabgleichs auf einem Zeichenfolgenfeld mithilfe von MATCH
  • Anwenden von Regeln basierend auf Werten in anderen Feldern mit WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED
  • Schränken Sie Regeln ein, die auf bestimmte Benutzer oder Gruppen angewendet werden sollen. Die meisten Regeln unterstützen die Attribute, die sich auf die Regel konzentrieren und nicht gelten.

Weitere Informationen zum Anwenden von Workflowfeldregeln finden Sie unter FIELD (Workflow)-Elementreferenzund Regelbewertung.

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 aktiviertem neuen Formular (VSTS, TFS 2017)

Kopfzeilenelement im Webformular

Altes Webformular in Verwendung (TFS 2015, TFS 2013)

Formularsteuerelemente des Arbeitselementtyps

Sie können das Formular anpassen, um die folgenden Ziele auszuführen:

Hinzufügen oder Entfernen eines Arbeitselementtyps aus dem Backlog oder Taskboard

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

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

Hinweis

Die Von Ihrem Webportal angezeigten Bilder unterscheiden sich möglicherweise von den in diesem Artikel angezeigten Bildern. Diese Unterschiede ergeben sich aus Updates, die an Azure DevOps Services oder ihrer lokalen Bereitstellung vorgenommen wurden. Die grundlegende Funktionalität, die Ihnen zur Verfügung steht, bleibt jedoch unverändert, sofern nicht explizit erwähnt.

In diesem Bildschirm wird gezeigt, wie Fehler aus der Produktbacklogseite hinzugefügt werden.

Informationen zum Hinzufügen oder Entfernen von Arbeitselementtypen aus dem Backlog oder Taskboard 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 der Workflowstatusfarbe eines Arbeitselementtyps

Im Webportal werden Arbeitselemente in Abfrageergebnissen und auf den Backlog- und Boardseiten der agilen Tools angezeigt. Um die Farbe oder das Symbol zu ändern, das 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 Workflowzustand 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 Arbeitselementtypsymbol für TFS 2017.2 und höher versionen anpassen.

Abfrageergebnisse mit Arbeitselementtypfarbe, Symbol und Zustandsfarbe

Ändern des Typs eines vorhandenen Arbeitselements

Weitere Informationen finden Sie unter Verschieben, Ändern oder Löschen von Arbeitselementen für die Für Sie verfügbaren Features basierend auf Ihrer Plattform.

Wenn Sie eine Verbindung mit TFS herstellen, können Sie den Arbeitselementtyp für ein vorhandenes Arbeitselement nicht ändern, aber Sie können das Arbeitselement 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.

Klonen eines Arbeitselementtyps

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 dann als neuen Typ erneut hinzufügen.

Deaktivieren oder Deaktivieren eines Arbeitselementtyps

Wenn Sie die Erstellung eines bestimmten Arbeitselementtyps auf eine Gruppe von Benutzern einschränken möchten, fügen Sie den Arbeitselementtyp der 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.

Hinweis

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

Löschen eines Arbeitselementtyps

Um zu verhindern, dass Teammitglieder einen bestimmten Arbeitselementtyp 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 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 darzustellen. Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen undImport- und Exportkategorien.

Umbenennen eines Arbeitselementtyps

So benennen Sie einen vorhandenen Arbeitselementtyp um witadmin renamewitd. 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 darzustellen. Insbesondere funktionieren die Backlogs und Boards erst, wenn Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen undImport- 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 Arbeitselementtypen 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 einen Arbeitselementtyp umbenennen, müssen Sie möglicherweise einige manuelle Vorgänge ausführen, wenn Sie Ihr Projekt aktualisieren. Informationen zu anderen Anpassungen, die Sie sicher vornehmen können und die Sie vermeiden sollten, finden Sie unter Anpassen der Arbeitsverfolgungserfahrung: Vor der Anpassung verstehen Sie die Wartungs- und Upgrade-Auswirkungen.

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

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

Wenn eine Anwendung einen unerwarteten Fehlerfehler erkannt hat , wenn Sie eine Verbindung mit Ihrem Projekt herstellen, nachdem Sie den Workflow geändert haben, können Sie es beheben, indem Sie die neuen Workflowzustände mit Metastates zuordnen. Informationen zum Beheben dieses Fehlers finden Sie unter Import- und Exportprozesskonfiguration.

In diesem Artikel wurde erläutert, wie Sie Arbeitselementtypen für gehostete XML- und lokale XML-Prozessmodelle hinzufügen und anpassen. Informationen zum Hinzufügen und Anpassen von Arbeitselementtypen für das Erbenprozessmodell finden Sie unter Anpassen eines Prozesses.

Weitere verwandte Themen oder Ressourcen: