Hinzufügen oder Ändern eines Arbeitsaufgabentyps

Azure DevOps Server 2022 – Azure DevOps Server 2019

Ihr Projekt enthält eine Reihe von Arbeitsaufgabentypen, basierend auf dem Prozess, der zum Erstellen Ihres Projekts verwendet wird, z. B. Agile, Basic, Scrumoder CMMI-. 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 Arbeitsaufgabentyps sind das Hinzufügen oder Ändern der Gruppe von Feldern oder Feldregeln, das Ändern des Workflows oder das Anpassen des Arbeitsaufgabenformulars.

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 Befehlszeilentool witadmin vorgenommen.

Definition des Arbeitselementtyps

• Hinzufügen oder Ändern eines Felds in einem vorhandenen Arbeitselementtyp
• Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps, Ändern eines Arbeitsaufgabentyps
• Ändern des Workflows (Zustände, Gründe, Übergänge)
• Ändern des Arbeitselementformulars

ProcessConfiguration-Definition

• Angeben der Farbe für den Arbeitselementtyp
• Angeben des Symbols für den Arbeitselementtyp
• Angeben der Farbe für den Workflowstatus
• Hinzufügen oder Entfernen eines Arbeitselementtyps im/aus dem Backlog oder Task Board
• Hinzufügen eines benutzerdefinierten Arbeitselementtyps zu einem Backlog oder Board
• Hinzufügen eines Portfolio Backlogs

Befehlszeilenänderung

• Auflisten der Arbeitselementtypen
• Deaktivieren eines Arbeitselementtyps
• Umbenennen eines Arbeitsaufgabentyps
• Löschen eines Arbeitselementtyps

Voraussetzungen

Informationen dazu, wie Sie sich als Administrator hinzufügen lassen, finden Sie unter Ändern von Berechtigungen auf Projektsammlungsebene.

Wie wirken sich Änderungen an Arbeitsaufgabentypen auf vorhandene Arbeitsaufgaben aus?

In der folgenden Tabelle wird die Auswirkung auf vorhandene Arbeitsaufgaben zusammengefasst, wenn Sie Felder oder Arbeitsaufgabentypdefinitionen ändern.

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

Importieren und Exportieren von Definitionsdateien für Arbeitsaufgabentypen

1. Falls Sie nicht über Administratorberechtigungen für Ihr Projekt verfügen, ändern Sie diese entsprechend.

   1. Öffnen Sie ein Eingabeaufforderungsfenster gemäß den Anweisungen in witAdmin: Anpassen und Verwalten von Objekten für die Nachverfolgung der Arbeit. Zum Beispiel:

2. Exportieren Sie die Definitionsdatei des Arbeitselementtyps, in der Sie ein Feld ändern oder hinzufügen möchten. Geben Sie den Namen des Arbeitsaufgabentyps 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 der 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 von witadmin finden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen.

Hinzufügen oder Ändern eines Arbeitsaufgabentyps

Um einen benutzerdefinierten Arbeitsaufgabentyp hinzuzufügen oder einen vorhandenen Arbeitsaufgabentyp zu ändern, definieren oder ändern Sie die XML-Definitionsdatei, und importieren Sie sie dann basierend auf dem Prozessmodell, das Sieverwenden, in Ihr Projekt . Sie ändern einen Arbeitsaufgabentyp, indem Sie die in den drei Hauptabschnitten der Definitionsdatei definierten Elemente angeben: FIELDS, WORKFLOW-und FORM.

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

Hinzufügen oder Ändern eines Felds, einer Feldregel, einer Beschriftung 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 Felder außer 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 Arbeitsaufgabentyps einschließen. Weitere Informationen zu den einzelnen Feldern finden Sie unter Feldindex für Arbeitselemente.

Sie fügen Felder und Feldregeln dem Abschnitt FIELDS hinzu. Damit das Feld im Arbeitselementformular angezeigt wird, müssen Sie es auch dem Abschnitt FORM der Definition hinzufügen.

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

Die Abschnitte STATES und REASONS im WORKFLOW geben die Auswahllistenwerte für die Felder Status und Grund an. Sie verfolgen den Status von Arbeitselementen nach. Der Abschnitt TRANSITIONS gibt die gültigen Übergänge zwischen Zuständen an, wie in der folgenden Abbildung gezeigt wird. Sie geben sowohl vorwärts- als auch regressive Übergänge an.

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 das Feld an, das bei einer Änderung des Status, Grunds oder Übergangs angewendet werden soll.
• Geben Sie eine benutzerdefinierte Aktion (ACTION) an, um Feldzuweisungen basierend auf einer Änderung des Status, Grunds oder Übergangs zu automatisieren.

Führen Sie beim Anpassen des Workflows die folgenden beiden Schritte aus:

1. Ändern Sie den WORKFLOW der Definition des Arbeitselementtyps.

2. Ändern Sie die Prozesskonfiguration, um neue Workflowstatus Metazuständen zuzuordnen.

   Dieser zweite Schritt ist erforderlich, wenn Sie den Workflow für einen Arbeitsaufgabentyp ändern, der auf einer Agile-Toolseite angezeigt wird. Diese Arbeitselementtypen gehören zur Kategorie „Anforderung” oder „Aufgabe”.

Workflowfeldregeln

Sie können Feldregeln anwenden, wenn Sie den Status ändern, einen Grund oder während eines Workflowübergangs angeben.

Durch Hinzufügen der Regel EMPTY, wenn der Status auf „Aktiv” gesetzt ist, können Sie beispielsweise die Felder „Geschlossen am” und „Geschlossen von” automatisch aufheben und als schreibgeschützte Felder festlegen. Dies ist nützlich, wenn Sie ein Arbeitselement im Status „Geschlossen” wieder aktivieren.

<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 möglichen Wert eines Felds, indem Sie CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY und REQUIRED angeben.
• Kopieren Sie einen Wert mithilfe von COPY, DEFAULT und SERVERDEFAULT in ein Feld.
• Einschränken, wer ein Feld ändern kann
• Erzwingen Sie den Musterabgleich für ein Zeichenfolgenfeld mithilfe von MATCH.
• Wenden Sie mithilfe von WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED Regeln bedingt auf Grundlage von Werten in anderen Feldern an.
• Beschränken Sie Regeln, die auf bestimmte Benutzer oder Gruppen angewendet werden sollen. Die meisten Regeln unterstützen die Attribute for oder not, um sich darauf zu konzentrieren, für wen die Regel gilt und für wen nicht.

Weitere Informationen zum Anwenden von Regeln für Workflow-Felder finden Sie in der FIELD (Workflow)-Elementreferenz sowie unter Regeln und Regelauswertung.

Anpassen des Arbeitselementformulars

In den folgenden Abbildungen werden die am häufigsten verwendeten Elemente in Arbeitsaufgabenformularen 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 vom Administrator aktiviert wurde.

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

• Hinzufügen oder Ändern eines Felds
• Ändern einer Feldbezeichnung
• Felder neu anordnen
• Hinzufügen einer Gruppe oder Seite
• Hinzufügen einer Gruppe
• Hinzufügen eines benutzerdefinierten Steuerelements, einer Gruppe oder Seite
• Hinzufügen von Informationstext oder Links
• HTML-Text einbetten oder dynamische Berichte anzeigen
• Hinzufügen einer Linksteuerelementseite

Hinzufügen oder Entfernen eines Arbeitselementtyps im/aus dem Backlog oder Task Board

Die Agile-Planungstools – Produkt-Backlog, Sprint-Backlog und Task-Board-Seiten – zeigen bestimmte Arbeitsaufgabentypen an, basierend auf der Prozessvorlage, 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 z. B. Scrum-Arbeitsaufgabentypen verwendet, werden sowohl Produktrückstandselemente als auch Fehler auf den Backlogseiten angezeigt. Wenn Ihr Projekt jedoch mit der Agile-, CMMI- oder anderen Prozessvorlage erstellt wurde, werden Fehler nicht in Ihrem Backlog oder Task Board angezeigt.

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

Informationen zum Hinzufügen oder Entfernen von Arbeitselementtypen im Backlog oder Task Board finden Sie im Artikel zum Hinzufügen eines Arbeitselementtyps zu einem Backlog und Board. Informationen dazu, wie Sie einen neuen Arbeitselementtyp zum Unterstützen eines Portfolio Backlogs hinzufügen, finden Sie im Artikel zum Hinzufügen einer Portfolio Backlog-Ebene.

Ändern Sie die Farbe, das Symbol oder die Farbe des Workflowstatus eines Arbeitselementtyps.

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

Ändern Sie den Typ eines vorhandenen Arbeitselements

Unter Massenverschieben von Arbeitselementen und Ändern des Arbeitselementtyps finden Sie Informationen zu den Features, die basierend auf Ihrer Plattform für Sie verfügbar sind.

Deaktivieren eines Arbeitselementtyps

Wenn Sie die Erstellung eines bestimmten Arbeitselementtyps auf eine Gruppe von Benutzern beschränken möchten, können Sie den Arbeitselementtyp der Gruppe „Ausgeblendete Kategorien” hinzufügen, damit er von den meisten Mitwirkenden nicht erstellt werden kann. Wenn Sie einer Gruppe von Benutzern Zugriff gewähren möchten, können Sie einen Link zu einer Vorlage erstellen, die das Arbeitselementformular öffnet, und diesen Link mit den Teammitgliedern teilen, die zur Erstellung berechtigt sein sollen.

Löschen eines Arbeitselementtyps

Um zu verhindern, dass Teammitglieder einen bestimmten Arbeitsaufgabentyp zum Erstellen einer Arbeitsaufgabe verwenden, können Sie sie aus dem Projekt entfernen. Wenn Sie witadmin destroywitd*verwenden, entfernen Sie dauerhaft alle Arbeitsaufgaben, die mit diesem Arbeitsaufgabentyp erstellt wurden, sowie den Arbeitsaufgabentyp selbst. Wenn Ihr Team beispielsweise "Impediment" nicht verwendet, können Sie den Arbeitsaufgabentyp 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 Arbeitsaufgabentyp 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 Arbeitselementtypen und Importieren und Exportieren von Kategorien.

Umbenennen eines Arbeitsaufgabentyps

Verwenden Sie witadmin renamewitd, um einen vorhandenen Arbeitsaufgabentyp umzubenennen. Sie können beispielsweise einen Arbeitsaufgabentyp 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 Arbeitsaufgabentyp 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, nachdem Sie die Kategoriedefinition aktualisiert haben.

Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen und Importieren und Exportieren von Kategorien.

Verwandte Artikel

In diesem Artikel wurde beschrieben, 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.

Andere verwandte Themen oder Ressourcen:

• Regeln und Regelauswertung
• Leitfaden für administrative Aufgaben
• ProcessConfiguration: XML-Elemente
• witadmin-Befehlszeilentools
• Anpassen der Arbeitsnachverfolgung
• Anpassen von Karten auf einem Board