Hinzufügen oder Ändern eines Arbeitsaufgabentyps

Azure DevOps Server | Azure DevOps Server 2022

Jedes Projekt enthält eine Reihe von Arbeitsaufgabentypen, die durch seinen Prozess definiert sind– Agile, Basic, Scrum oder CMMI. Verwenden Sie Arbeitsaufgabentypen, um verschiedene Arten von Arbeiten nachzuverfolgen. Ändern Sie vorhandene Typen, oder fügen Sie benutzerdefinierte Typen hinzu, die den Nachverfolgungsanforderungen und dem Workflow Ihres Teams entsprechen.

Häufige Gründe zum Anpassen eines Arbeitsaufgabentyps sind:

• Hinzufügen oder Ändern von Feldern oder Feldregeln
• Ändern des Workflows (Zustände, Gründe, Übergänge)
• Anpassen des Formularlayouts für Arbeitsobjekte

Um ausschließlich Felder zu ändern, siehe Feld hinzufügen oder ändern.

Sie können Arbeitsaufgabentypen über die XML-Definitionsdatei, die Prozesskonfigurationsdefinition oder das Befehlszeilentool witadmin anpassen. In den folgenden Listen wird gezeigt, was Sie mit den einzelnen Ansätzen tun können.

Definition des Arbeitselementtyps

• Hinzufügen oder Ändern eines Felds
• Hinzufügen oder Ändern eines Arbeitselementtyps
• Ändern des Workflows
• Ändern des Arbeitselementformulars

Prozesskonfigurationsdefinition

• 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.

Auswirkungen von Änderungen an Arbeitsaufgabentypen auf vorhandene Arbeitsaufgaben

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

Verwenden Sie das witadmin deletefield Befehlszeilentool, um Felder vollständig aus dem Datenspeicher zu entfernen.

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.

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 eine vorhandene zu ändern, definieren oder ändern Sie die XML-Definitionsdatei, und importieren Sie sie dann basierend auf dem verwendeten Prozessmodell in Ihr Projekt. Die Definitionsdatei enthält drei Hauptabschnitte: FIELDS, WORKFLOW und FORM.

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

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

Fügen Sie ein beliebiges Feld hinzu, das Sie zum Nachverfolgen von Daten zur Definitionsdatei verwenden möchten. Diese Richtlinie gilt für alle außer Systemfeldern (Felder, deren Verweisname 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 Arbeitselementfeldindex.

Fügen Sie dem Abschnitt FELDER Felder und Feldregeln hinzu. Damit das Feld im Arbeitselementformular angezeigt wird, fügen Sie es dem Abschnitt "FORM " der Definition hinzu.

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

In den Abschnitten STÄNDE und GRÜNDE im WORKFLOW werden die Listenwerte in den Feldern Status und Grund angegeben. In diesen Abschnitten wird der Status von Arbeitsaufgaben nachverfolgt. Der ABSCHNITT TRANSITIONS gibt die gültigen Übergänge zwischen Zuständen an, wie im folgenden Diagramm dargestellt. Sie geben sowohl vorwärts- als auch regressive Übergänge an.

Ändern Sie 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 ein Feld an, das während einer Änderung des Zustands, des Grunds oder des Ü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. Diese Regel ist nützlich, wenn Sie eine Arbeitsaufgabe aus einem geschlossenen Zustand reaktivieren.

<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 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 das Musterabgleich bei einem Zeichenfolgenfeld mithilfe von MATCH.
• Bedingt Regeln anwenden, die auf Werten in anderen Feldern basieren, indem Sie WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED verwenden.
• Beschränken Sie Regeln, die auf bestimmte Benutzer oder Gruppen angewendet werden sollen. Die meisten Regeln unterstützen das for- oder not-Attribut, um anzugeben, für wen die Regel gilt oder 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

Der folgende Screenshot zeigt die am häufigsten verwendeten Elemente in Arbeitsaufgabenformularen. 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 aktiviert ist.

Passen Sie das Formular an, 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 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 – Produktrückstand, Sprint-Backlog und Task Board-Seiten – zeigen bestimmte Arbeitsaufgabentypen basierend auf der Prozessvorlage an, die Sie zum Erstellen Ihres Projekts verwenden. Sie können Arbeitsaufgabentypen von diesen Seiten hinzufügen oder entfernen. Wenn Ihr Projekt z. B. Scrum-Arbeitsaufgabentypen verwendet, werden sowohl Produktrückstandselemente als auch Fehler auf den Backlogseiten angezeigt. Wenn Ihr Projekt jedoch die Agile-, CMMI- oder eine andere Prozessvorlage verwendet, werden Fehler nicht im Backlog oder Task Board angezeigt.

Informationen zum Hinzufügen oder Entfernen von Arbeitsaufgabentypen aus dem Backlog oder Task Board finden Sie unter Hinzufügen eines Arbeitsaufgabentyps 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 für einen neuen Arbeitsaufgabentyp hinzu, bearbeiten Sie die Prozesskonfiguration. Um die Farbe für einen Workflowstatus zu ändern, bearbeiten Sie die Prozesskonfiguration.

Ändern Sie den Typ eines vorhandenen Arbeitselements

Die auf Ihrer Plattform verfügbaren Features finden Sie unter Massenverschiebung von Arbeitsaufgaben und Ändern des Arbeitsaufgabentyps.

Deaktivieren eines Arbeitselementtyps

Um die Erstellung eines bestimmten Arbeitsaufgabentyps auf eine Gruppe von Benutzern einzuschränken, fügen Sie der Gruppe "Ausgeblendete Kategorien" den Arbeitsaufgabentyp hinzu , um zu verhindern, dass die meisten Mitwirkenden sie erstellen. Um Zugriff auf eine bestimmte Gruppe von Benutzern zu gewähren, erstellen Sie einen Link zu einer Vorlage , die das Arbeitsaufgabenformular öffnet, und teilen Sie diesen Link mit Teammitgliedern, die ihn erstellen müssen.

Löschen eines Arbeitselementtyps

Um zu verhindern, dass Teammitglieder einen bestimmten Arbeitsaufgabentyp zum Erstellen einer Arbeitsaufgabe verwenden, entfernen Sie sie aus dem Projekt. Wenn Sie diese Option verwenden witadmin destroywitd, entfernen Sie dauerhaft alle Arbeitsaufgaben, die mit diesem Arbeitsaufgabentyp erstellt wurden, und den Arbeitsaufgabentyp selbst. Wenn Ihr Team beispielsweise "Impediment" nicht verwendet, löschen Sie den Arbeitsaufgabentyp mit der Bezeichnung "Impediment" aus dem Fabrikam-Websiteprojekt.

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, aktualisieren Sie die Kategoriendefinition für das Projekt, um den Löschvorgang widerzuspiegeln. Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen und Importieren und Exportieren von Kategorien.

Umbenennen eines Arbeitsaufgabentyps

Verwenden Sie die Verwendung 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, aktualisieren Sie die Kategoriendefinition für das Projekt so, dass er den neuen Namen widerspiegelt. Die Backlogs und Boards funktionieren erst, wenn Sie die Kategoriendefinition aktualisieren.

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

Verwandte Inhalte

• Anpassen eines Prozesses
• Regeln und Regelauswertung
• Leitfaden für administrative Aufgaben
• Anpassen der Arbeitsnachverfolgung
• Anpassen von Karten auf einem Board