Hinzufügen oder Ändern eines Arbeitselementtyps

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

Wichtig

Dieser Artikel gilt für die Projektanpassung für lokale XML-Prozessmodelle. Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

Ihr Projekt enthält eine Reihe von Arbeitselementtypen (WITs), die auf dem Prozess — Agile, Csvoder CMMIbasieren, — der zum Erstellen des Projekts verwendet wird. Ein WIT ist das Objekt, das Sie zum Nachverfolgen verschiedener Arbeitstypenverwenden.

Sie können ein vorhandenes WIT ändern oder basierend auf den Nachverfolgungsanforderungen Oder Workflowprozessen Ihres Teams ein benutzerdefiniertes WIT hinzufügen. Die häufigsten Gründe für die Änderungen eines WITs sind das Hinzufügen oder Ändern des Satzes von Feldern oder Feldregeln, das Ändern des Workflows oder eine Anpassung 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 WIT-Anpassungen werden an der WIT-Definition vorgenommen, andere Anpassungen werden jedoch über die Definition der Prozesskonfiguration oder das Befehlszeilentool witadmin vorgenommen.

Hinweis

Featureverfügbarkeit: Sie können einige Features nur aus einer lokalen Bereitstellung nutzen und sind als solche notiert.

WIT-Definition

ProcessConfiguration-Definition

Befehlszeilenänderung

Voraussetzungen

  • Um Arbeitselementtypen aufzulisten, müssen Sie über die Berechtigung View project-level information (Informationen auf Projektebene anzeigen) für das Projekt in der Sammlung verfügen, die auf Zulassen festgelegt ist.
  • (TFS) Um eine WIT hinzuzufügen oder anzupassen, müssen Sie Mitglied der Gruppe Project Administratoren sein oder ihre Berechtigung Zum Bearbeiten von Informationen auf Projektebene auf Zulassen festgelegt haben.
  • (Azure DevOps Services, gehostetes XML) Um eine WIT durch Anpassen einer Prozessvorlage hinzuzufügen oder anzupassen, müssen Sie Mitglied der Gruppe Project Sammlungsadministratoren sein oder die Berechtigung Prozess bearbeiten auf Zulassen festlegen.

Informationen zum Hinzufügen als Administrator finden Sie unter Hinzufügen von Administratoren.

Importieren und Exportieren von WIT-Definitionsdateien (lokales XML)

Hinweis

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

  1. Wenn Sie nicht über Administratorberechtigungen für Ihr Projekt verfügen, erhalten Sie diese.

    1. Öffnen Sie ein Eingabeaufforderungsfenster gemäß den Anweisungen unter witAdmin: Anpassen und Verwalten von Objekten für die Nachverfolgung von Arbeitsschritten. Beispiel:
    %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
  2. Exportieren Sie die WIT-Definitionsdatei, in der Sie ein Feld ändern oder hinzufügen möchten. Geben Sie den Namen des WIT 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. Weitere Informationen finden Sie unter Index to XML element definitions (Index to XML-Elementdefinitionen).

  4. Importieren Sie die WIT-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 WIT

Um ein benutzerdefiniertes WIT hinzuzufügen oder ein vorhandenes WIT zu ändern, definieren oder ändern Sie die XML-Definitionsdatei für das WIT und importieren sie dann basierend auf dem verwendeten Prozessmodellin Ihr Projekt. Sie ändern eine WIT, indem Sie die in den drei Hauptabschnitten der WIT-Definitionsdatei definierten Elemente angeben: FIELDS, WORKFLOW und FORM.

Zusammenfassung der WIT-Elemente

Die einfachste Möglichkeit, einen neuen WIT hinzuzufügen ist, einen vorhandenen WIT 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 WIT-Definitionsdatei hinzugefügt werden. Dies gilt für alle Felder außer System (Felder, deren Verweisname mit System beginnt). Alle Systemfelder werden für alle WITs definiert, unabhängig davon, ob Sie sie in der WIT-Definition einschließen. Weitere Informationen zu den einzelnen Feld finden Sie unter Arbeitselementfeldindex.

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

Um z. B. die Arbeitselement-ID einem Formular hinzuzufügen, 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

Die Abschnitte STATES und REASONS innerhalb des WORKFLOWS geben die Werte der Auswahlliste in den Feldern Zustand 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.

Beispiel für ein Workflowzustandsdiagramm, Agile User Story

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

  • Hinzufügen oder Entfernen eines Zustands, einer Ursache oder eines Übergangs
  • Geben Sie einen Wert für das Feld an, das während einer Änderung des Zustands, der Ursache 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 WIT-Definition.

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

    Dieser zweite Schritt ist erforderlich, wenn Sie den Workflow für eine WIT ändern, die auf einer Agile-Toolseite angezeigt wird. Diese WITs gehören den Anforderungs- und Aufgabenkategorien an.

Feldregeln für den Workflow

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

Wenn Sie z. B. die EMPTY-Regel hinzufügen, wenn der Status auf Aktiv festgelegt ist, können Sie die Felder Closed Date und Closed By automatisch auf NULL setzen 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 aufweisen kann, indem Sie CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY und REQUIRED angeben.
  • Kopieren eines Werts in ein Feld mit COPY, DEFAULT und SERVERDEFAULT
  • Einschränken, wer ein Feld ändern kann
  • Erzwingen des Musterabgleichs für ein Zeichenfolgenfeld mithilfe von MATCH
  • Bedingtes 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 for oder not, um sich darauf zu konzentrieren, für wen die Regel gilt und für die sie nicht gilt.

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

Anpassen des Arbeitselementformulars

In den folgenden Abbildungen werden die gängigsten Elemente in Arbeitselementformularen hervorgehoben. Sie können alle Elemente außer den Titelbereich und die Formularsteuerelemente anpassen. Welche Elemente Sie zum Anpassen des Formulars verwenden, hängt davon ab, ob das neue Formular von Ihrem Administrator aktiviert wurde.

Webformular mit aktivierten neuen Formularen (VSTS, TFS 2017)

Headerelement innerhalb des Webformulars

Altes web form in use (TFS 2015, TFS 2013)

WIT-Formularsteuerelemente

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

Hinzufügen oder Entfernen eines WIT aus dem Backlog oder Task board

Die — Produktbacklog-, Sprintbacklog- und Taskboardseiten der Agile-Planungstools — zeigen spezifische WITs basierend auf der Prozessvorlage an, die zum Erstellen Ihres Projekts verwendet wird. Sie können WITs hinzufügen oder entfernen, die auf diesen Seiten angezeigt werden sollen. Wenn Ihr Projekt z. B. Die WiTs von "Items" 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 keine Fehler in Ihrem Backlog oder Task board angezeigt.

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

Hinweis

Die Bilder, die In Ihrem Webportal angezeigt werden, können sich von den In diesem Artikel angezeigten Bildern unterscheiden. Diese Unterschiede ergeben sich aus Updates, die 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.

Auf diesem Bildschirm wird gezeigt, wie Sie Fehler von der Produktbacklogseite hinzufügen.

Informationen zum Hinzufügen oder Entfernen von WITs zum Backlog oder Task board finden Sie unter Hinzufügen eines Arbeitselementtyps zu einem Backlog und Board. Informationen zum Hinzufügen eines neuen WIT zur Unterstützung eines Portfoliobacklogs finden Sie unter Hinzufügen einer Portfoliobacklogebene.

Ändern der WIT-Farbe, des Symbols oder der Workflowzustandsfarbe

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 bzw. das einer vorhandenen WIT zugeordnet ist, oder um die Farbe hinzuzufügen, die für eine neue WIT 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 lokales XML können Sie die Workflowzustandsfarbe für TFS 2015.2 oder höhere Versionen und das WIT-Symbol für TFS 2017.2 und höhere Versionen anpassen.

Query results showing wit color, icon, and state color

Ändern des Typs eines vorhandenen Arbeitselements

Informationen zu den funktionen, die Ihnen basierend auf Ihrer Plattform zur Verfügung stehen, finden Sie unter Verschieben, Ändern oder Löschen von Arbeitselementen.

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 WIT

Wenn Sie über mehrere Arbeitselemente mit Typänderungen verfügen, die Sie vornehmen möchten, können Sie sie mit Excel exportierenund sie dann als neuen Typ erneut hinzufügen.

Deaktivieren oder Deaktivieren eines WIT (lokales XML)

Wie schränken Sie Benutzer daran ein, Arbeitselemente eines bestimmten Typs zu erstellen?

Wenn Sie über eine WIT verfügen, die Sie außer Kraft setzen möchten, aber die Arbeitselemente verwalten, die basierend auf diesem Typ erstellt wurden, können Sie eine Regel hinzufügen, die verhindert, dass alle gültigen Benutzer den Arbeitselementtyp speichern.

<TRANSITION from=" " to="New">
  <FIELDS>
     <FIELD refname="System.CreatedBy">
        <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
  </FIELDS>
</TRANSITION> 

Wenn Sie die Erstellung eines bestimmten Arbeitselementtyps auf eine Gruppe von Benutzern beschränken möchten, können Sie dies auf zwei Arten tun:

  • Fügen Sie der Gruppe Ausgeblendete Kategorien den Arbeitselementtyp hinzu, um zu verhindern, dass die meisten Mitwirkenden sie erstellen. Wenn Sie einer Gruppe von Benutzern den Zugriff erlauben möchten, können Sie einen Link zu einer Vorlage erstellen, die das Arbeitselementformular öffnet, und diesen Link für die Teammitglieder freigeben, die Sie erstellen möchten.

  • Fügen Sie dem Workflow eine Feldregel für das Feld System.CreatedBy hinzu, um eine Gruppe von Benutzern effektiv daran zu hindern, ein Arbeitselement eines bestimmten Typs zu erstellen. Wie im folgenden Beispiel gezeigt, muss der Benutzer, der das Arbeitselement erstellt, dem Allowed Group angehören, um das Arbeitselement zu speichern.

    <TRANSITION from=" " to="New">
        <FIELDS>
            <FIELD refname="System.CreatedBy">
            <VALIDUSER for="Allowed Group" not="Disallowed Group" />
            </FIELD>
        </FIELDS>
    </TRANSITION> 
    

Löschen eines Arbeitselementtyps (lokales XML)

Um zu verhindern, dass Teammitglieder ein bestimmtes WIT zum Erstellen eines Arbeitselements verwenden, können Sie es aus dem Projekt entfernen. Wenn Sie witadmin destroywitd verwenden, entfernen Sie dauerhaft alle Arbeitselemente, die mit diesem WIT und dem WIT selbst erstellt wurden. Wenn Ihr Team beispielsweise "Impediment" nicht verwendet, können Sie die WIT-Bezeichnung "Impediment" aus dem Fabrikam-Websiteprojekt löschen.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment" 

Wenn Sie eine WIT löschen, die 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.

In diesem Thema wurde erläutert, wie WITs und die Prozesskonfiguration für gehostete XML- und lokale XML-Prozessmodelle hinzugefügt und angepasst werden. Informationen zum Hinzufügen und Anpassen von Feldern für gehostete XML- und lokale XML-Prozessmodelle finden Sie unter Hinzufügen oder Ändern eines Arbeitselementtyps. Informationen zum Vererbungsprozessmodell finden Sie unter Anpassen eines Prozesses.

Weitere verwandte Themen oder Ressourcen:

Umbenennen eines WIT (lokales XML)

Hinweis

Sie können witadmin renamewitd nur aus einer lokalen Bereitstellung ausführen.

Um eine vorhandene WIT umzubenennen, verwenden Sie witadmin renamewitd. Beispielsweise können Sie einen WIT mit der Bezeichnung "QoS-Element" in "Service Agreement" umbenennen.

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

Wenn Sie eine WIT umbenennen, die 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 Arbeitselementtypen und Importieren und Exportieren von Kategorien.

Aktivieren von Features nach dem Upgrade (lokales XML)

Hinweis

Sie können den Assistenten zum Konfigurieren von Features nur aus einer lokalen Bereitstellung ausführen.

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

Sie können benutzerdefinierte WITs 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 eine WIT umbenennen, müssen Sie möglicherweise einige manuelle Vorgänge ausführen, wenn Sie Ihr Projekt aktualisieren. Weitere Informationen zu anderen Anpassungen, die Sie sicher vornehmen können und die Sie vermeiden sollten, finden Sie unter Anpassen der Arbeitsnachverfolgungserfahrung: Bevor Sie anpassen, sollten Sie sich mit den Auswirkungen auf Wartung und Upgrade auskennen.

Wie wirken sich WIT-Änderungen auf vorhandene Arbeitselemente aus?

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

Aktion Auswirkungen auf vorhandene Arbeitselemente
Entfernen von Feldern aus einem WIT Die Daten der entfernten Felder verbleiben im Datenspeicher. Es können jedoch keine neuen Daten hinzugefügt werden, da Sie sie aus der WIT-Definition 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 WIT Alle Daten bleiben unter dem neuen Namen erhalten.
Löschen eines WITs Alle Daten für Arbeitselemente, die als gelöschtes WIT erstellt wurden, werden dauerhaft entfernt, ohne dass eine Wiederherstellungsmöglichkeit besteht.

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

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

Wenn Sie den Workflow für den Testplan oder die Testsammlung ändern — und von einem Test Manager Client arbeiten, der mit Visual Studio 2013.2 oder früheren Versionen bereitgestellt wurde, wurden diese — WITs verfügbar, als Sie Ihren Anwendungsschichtserver 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 Metazuständen zuordnen. Informationen zum Beheben dieses Fehlers finden Sie unter Importieren und Exportieren der Prozesskonfiguration.