Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT)

Als Projektadministrator können Sie einen vorhandenen Arbeitsaufgabentyp (Work Item Type, WIT) ändern, um zusätzliche Nachverfolgungsanforderungen oder Workflowprozesse zu unterstützen. 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 Arbeitsaufgabenformulars. Diese drei Gründe entsprechen den drei Hauptabschnitten der WIT-XML-Definitionsdatei: FIELDS, WORKFLOW und FORM.

Alle diese Änderungen erfordern eine Bearbeitung der WIT-Definition. Dies können Sie nur in lokalen Bereitstellungen von TFS durchführen. Dieses Thema enthält eine Übersicht darüber, was Sie anpassen können, sowie Verweise auf Inhalte, in denen dies veranschaulicht wird.

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

Sie fügen Felder und Feldregeln zum FIELDS-Abschnitt hinzu. Damit das Feld im Arbeitsaufgabenformular erscheint, müssen Sie es dem FORM-Abschnitt der WIT-Definition hinzufügen.

Um beispielsweise die Arbeitsaufgaben-ID einem Formular hinzuzufügen, 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, um Abfragen, Berichte und Workflows zu unterstützen.

Ändern von Workflowzuständen, Gründen, Übergängen oder Hinzufügen von Workflowfeldregeln

Die Abschnitte STATES und REASONS im WORKFLOW geben die Werte der Auswahlliste in den Feldern Zustand und Grund an. Sie verfolgen den Status von Arbeitsaufgaben. Der TRANSITIONS-Abschnitt gibt die gültigen Übergänge zwischen Zuständen an, wie in der folgenden Abbildung gezeigt. Sie geben sowohl vor- als auch rückwärtige Übergange an.

Beispiel für ein Workflowzustandsdiagramm

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

• Hinzufügen oder Entfernen eines Zustands, Grunds oder Übergangs

• Angeben eines Werts für ein Feld, der während einer Änderung des Zustands, Grunds oder Übergangs angewendet werden kann

• Angeben einer benutzerdefinierten ACTION, um Feldzuweisungen auf Grundlage von Änderungen des Zustands, Grunds oder Übergangs zu automatisieren

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

1. Ändern des WORKFLOWS der WIT-Definition.

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

   Dieser zweite Schritt ist unter den folgenden Umständen erforderlich:

   • Wenn Sie den Workflow für einen WIT ändern, der auf einer Agile-Planungstoolseite angezeigt wird. Diese WITs gehören den Anforderungs- und Aufgabenkategorien an. Weitere Informationen zur Konfiguration dieser Tools finden Sie unter Configure and customize Agile tools for a team project.

   • Wenn Sie den Workflow für den Testplan oder die Testsammlung ändern und Sie in einem mit Visual Studio 2013.2 oder früheren Versionen bereitgestellte Test-Manager-Client arbeiten. Diese WITs wurde bei der Aktualisierung Ihres Anwendungsebenenserver auf TFS 2013.3 verfügbar, das auf einer Agile-Planungstoolseite angezeigt wird.

     Falls bei einer Verbindung mit Ihrem Teamprojekt der Fehler Die Anwendung hat einen unerwarteten Fehler erkannt auftritt, nachdem Sie den Workflow geändert haben, können Sie ihn beheben, indem der neue Workflow-Status Metastates zugeordnet wird. Informationen zum Beheben dieses Fehlers finden Sie unter Importieren und Exportieren der Prozesskonfiguration [witadmin].

Feldregeln für den Workflow

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

Zum Beispiel können Sie beim Hinzufügen der EMPTY-Regel, sofern der Zustand auf "Aktiv" gesetzt ist, die Felder "Schließungsdatum" und "Geschlossen von" automatisch auf NULL setzen und als schreibgeschützt festlegen. Dies ist hilfreich, wenn eine Arbeitsaufgabe 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 Sie einen Wert in ein Feld, indem Sie COPY, DEFAULT und SERVERDEFAULT verwenden.

• Einschränken des Personenkreises, von dem ein Feld geändert werden kann

• Erzwingen Sie einen Mustervergleich für ein Zeichenfolgenfeld, indem Sie MATCH verwenden.

• Wenden Sie Regeln bedingt auf Grundlage von Werten in anderen Feldern an, indem Sie WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED verwenden.

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

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

Anpassen des Arbeitsaufgabenformulars

In der folgenden Abbildung werden die gängigsten Elemente auf Arbeitsaufgabenformularen hervorgehoben. Sie können alle Elemente außer den Titelbereich und die Formularsteuerelemente anpassen.

Sie können ein WIT-Formular anpassen, um die folgenden Ziele zu erreichen:

• Fügen Sie ein Feld hinzu, entfernen Sie eine Feldbezeichnung, oder ändern Sie die Platzierung eines Felds auf dem Formular. Weitere Informationen finden Sie unter Specify work item form controls.

• Fügen Sie neue Registerkarten oder Spalten hinzu, oder verschieben Sie Gruppen von Feldern von einer Registerkarte auf eine andere. Siehe Design the work item form.

• Fügen Sie Informationstext hinzu, um das Ausfüllen des Formulars und Hyperlinks zu detaillierten Prozessleitfäden zu unterstützen bzw. HTML-Text einzubetten oder dynamische Berichte im Formular anzuzeigen. Siehe Provide help text, hyperlinks, or web content on a work item form.

• Geben Sie Registerkarten an, die die Linktypen oder WITs einschränken, die mit einer Arbeitsaufgabe verknüpft werden können. Siehe Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen.

• Fügen Sie ein Dateianlage-Steuerelement hinzu, um das Anhängen von Dateien zu unterstützen. Siehe Hinzufügen des Anlagen-Steuerelements.

Bearbeiten der WIT-Definition

Zur Bearbeitung einer WIT-Definition exportieren Sie die WIT-Definitionsdatei, bearbeiten Sie sie, und importieren Sie sie anschließend.

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie zum Ändern der XML-Syntax für ein Objekt verwenden können, sind der Prozess-Editor, den Sie mit dem Download von TFS Power Tools oder TFS Team Project Manager, in Communityressourcenprojekt, das auf CodePlex verfügbar ist.

1. Wenn Sie nicht über Administratorberechtigungen für das Teamprojekt verfügen, rufen Sie sie ab.

2. Öffnen Sie ein Eingabeaufforderungsfenster auf dem Computer, auf dem entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

   cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
   

   Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%. Hier können Sie Team Explorer kostenlos herunterladen.

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

4. Bearbeiten Sie die Datei. Ausführliche Informationen finden Sie unter Arbeitsaufgabennachverfolgung: Index für XML-Elementdefinitionen.

5. Importieren Sie die WIT-Definitionsdatei.

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

6. Öffnen Sie entweder TWA oder Team Explorer, um die Änderungen anzuzeigen. Wenn der Client bereits geöffnet ist, aktualisieren Sie ihn.

   Klicken Sie in Team Explorer auf die Schaltfläche zum Aktualisieren.

   Die aktuellen Updates werden vom Server heruntergeladen, einschließlich der Änderungen, die Sie gerade importiert haben. Warten Sie einige Sekunden, bis die Aktualisierung abgeschlossen ist.

   Weitere Informationen zur Verwendung von witadmin finden Sie unter Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin].

Fragen und Antworten

F: Wie arbeite ich mit Tags?

A: Informationen über das Hinzufügen von Tags und das Filtern von Listen finden Sie hier.

F: Welche Anpassungen kann ich vornehmen und trotzdem den Assistenten zum Konfigurieren von Funktionen verwenden, um mein Teamprojekt nach einem TFS-Upgrade zu aktualisieren?

A: Sie können Arbeitsaufgabentypen hinzufügen und das Formularlayout ändern. Der Assistent zum Konfigurieren von Funktionen aktualisiert Ihre Teamprojekte und Sie erhalten Zugang zu den neuesten Features.

Wenn Sie den Workflow ändern oder ein WIT umbenennen, können manuelle Eingriffe beim Aktualisieren Ihres Teamprojekts nötig sein. Informationen über andere Anpassungen, die Sie sicher durchführen können bzw. die Sie vermeiden sollten, finden Sie unter Anpassen der Arbeitsnachverfolgung: Vor Durchführung einer Anpassung mit den Auswirkungen auf Wartung und Upgrades vertraut machen.

F: Wie füge ich einen neuen WIT hinzu?

A: Die einfachste Möglichkeit, einen neuen WIT hinzuzufügen ist, einen vorhandenen WIT zu kopieren und dann die Definitionsdatei zu ändern. Ein Beispiel finden Sie unter Create a work item type.

F: Kann ich einen WIT umbenennen?

A: Ja. Um einen vorhandenen WIT umzubenennen, verwenden Sie witadmin renamewitd. Beispielsweise können Sie einen WIT mit der Bezeichnung "QoS-Element" in "Dienstleistungsvertrag" ändern.

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

Wenn Sie einen WIT umbenennen, der einer Kategorie angehört, müssen Sie die Kategoriendefinition für das Teamprojekt aktualisieren, sodass sie dem neuen Namen entspricht. Insbesondere die Agile-Planungstools werden nicht funktionieren, bis Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin] und Importieren und Exportieren von Kategorien [witadmin].

F: Wie deaktiviere ich einen WIT?Wie hindere ich Benutzer an der Erstellung von Arbeitsaufgaben eines bestimmten Typs?

A: Wenn Sie über einen WIT verfügen, den Sie zurückziehen möchten, die auf Grundlage dieses Typs erstellten Arbeitsaufgaben jedoch beibehalten möchten, können Sie eine Regel hinzufügen, die alle gültigen Benutzer daran hindert, den Arbeitsaufgabentyp zu 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 WIT auf eine bestimmte Gruppe von Benutzern beschränken möchten, gibt es zwei Möglichkeiten, den Zugriff einzuschränken:

• Durch Hinzufügen des WITs zur Gruppe der ausgeblendeten Kategorien werden die meisten Mitwirkenden an deren Erstellung gehindert. Wenn Sie einer Gruppe von Benutzern Zugriff gewähren möchten, können Sie einen Hyperlink zu einer Vorlage erstellen, um das Arbeitsaufgabenformular zu öffnen, und diesen Link für die Teammitglieder freigeben, die sie erstellen sollen.

• Wenn Sie dem Workflow eine Feldregel für das Feld "System.CreatedBy" hinzufügen, wird eine Benutzergruppe effektiv daran gehindert, eine Arbeitsaufgabe eines bestimmten Typs zu erstellen. Wie das folgende Beispiel zeigt, muss der Benutzer, der die Arbeitsaufgabe erstellt, zur Allowed Group gehören, um die Arbeitsaufgabe zu speichern.

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

F: Wie lösche ich einen WIT?

A: Um zu verhindern, dass Teammitglieder einen bestimmten WIT zur Erstellung einer Arbeitsaufgabe verwenden, können Sie diesen aus dem Teamprojekt entfernen. Wenn Sie witadmin destroywitd verwenden, entfernen Sie dauerhaft alle Arbeitsaufgaben, die mit diesem WIT erstellt wurden, sowie den WIT selbst. Wenn das Team beispielsweise "Impediment" nicht verwendet, können Sie den WIT 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 WIT löschen, der einer Kategorie angehört, müssen Sie die Kategoriendefinition für das Teamprojekt aktualisieren, sodass sie dem neuen Namen entspricht. Insbesondere die Agile-Planungstools werden nicht funktionieren, bis Sie die Kategoriendefinition aktualisieren.

Weitere Informationen finden Sie unter Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin] und Importieren und Exportieren von Kategorien [witadmin].

F: Kann ich die einem WIT zugeordnete Farbe ändern?

A: Ja. In Team Web Access werden Arbeitsaufgaben in den Abfrageergebnissen und auf den Backlog- und Board-Seiten der Agile-Planungstools angezeigt. Um die einem vorhandenen WIT zugeordnete Farbe zu ändern oder die für einen neuen WIT zu verwendende Farbe hinzuzufügen, bearbeiten Sie die Prozesskonfiguration.

F: Kann ich einen WIT zu einem Backlog oder Task Board hinzufügen oder diesen daraus entfernen?

A: Ja. Die Agile-Planungstools – Product Backlog-, Sprint-Backlog- und Task Board-Seite – zeigen bestimmte WITs basierend auf der Prozessvorlage an, die zum Erstellen des Teamprojekts verwendet wird. Sie können WITs hinzufügen oder entfernen, die auf diesen Seiten angezeigt werden sollen. Wenn das Teamprojekt beispielsweise Scrum-WITs verwendet, werden Product Backlog-Elemente und -Fehler auf den Backlog-Seiten angezeigt. Wenn das Teamprojekt jedoch mit Agile, CMMI oder einer anderen Prozessvorlage erstellt wurde, werden Fehler nicht im Backlog oder Task Board angezeigt.

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

Informationen zum Hinzufügen oder Entfernen von WITs aus dem Backlog oder Task Board finden Sie hier. Informationen zum Hinzufügen eines neuen WITs, der einen Portfolio-Backlog unterstützt, finden Sie hier.

F: Welche Auswirkungen hat die Änderung eines WITs auf vorhandene Arbeitsaufgaben?

A: In der folgenden Tabelle werden die Auswirkungen von Änderungen an Feldern oder WIT-Definitionen auf vorhandene Arbeitsaufgaben zusammengefasst.

Aktion	Auswirkungen auf vorhandene Arbeitsaufgaben
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 diese 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 der Arbeitsaufgaben, die als gelöschter WIT erstellt wurden, werden dauerhaft und ohne Möglichkeit zur Wiederherstellung entfernt.

Wenn Sie die Felder aus dem Datenspeicher vollständig löschen möchten, verwenden Sie das Befehlszeilentool witadmin deletefield. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin].

F: Wie ändere ich den Typ einer vorhandenen Arbeitsaufgabe?

A: Sie können den Typ für eine vorhandene Arbeitsaufgabe nicht ändern, Sie haben jedoch die Möglichkeit, die Arbeitsaufgabe zu kopieren und einen neuen Typ anzugeben. Sie können beispielsweise ein vorhandenes Product Backlog-Element kopieren und den Typ in Fehler ändern, wie in der folgenden Abbildung gezeigt.

Wenn Sie über mehrere Arbeitsaufgaben verfügen, deren Typ Sie ändern möchten, können Sie sie mit Excel exportieren und anschließend erneut als neuen Typ hinzufügen.

F: Kann ich Arbeitsaufgaben aus TFS löschen?

A: Ja. Verwenden Sie witadmin destroywi, um Arbeitsaufgaben permanent aus der Datenbank zu entfernen.

F: Was sollte ich über die WIT-Anpassung und TFS-Upgrades wissen?

A: Siehe Configure features after a TFS upgrade.

F: An wen kann ich mich bei weiteren Fragen wenden?

A: Besuchen Sie das folgende Forum, um nach Antworten zu suchen oder dort eine Frage zu stellen: Team Foundation Server – Projektmanagement & Arbeitsaufgabe.

Weitere Informationen finden Sie unter Specify work item form controls.

Verwenden Sie den Prozess-Editor, der im Download von TFS Power Tools enthalten ist, um den Workflow zu ändern oder ein Zustandsdiagramm des Workflows anzuzeigen.