Fügen Sie einen Arbeitselementtyp zu Backlogs und Boards hinzu

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Um ausgewählte Geschäftsprozesse zu erfüllen, möchte Ihr Team möglicherweise zusätzliche Arbeitsaufgabentypen (WITs) als Anforderungen oder als Aufgaben nachverfolgen. Auf diese Weise können Sie sie hinzufügen und in den Produkt- und Sprint-Backlogs oder auf Boards und Taskboards nachverfolgen.

Sie können z. B. verschiedene Arten von Anforderungen basierend auf ihrem Zielkunden oder verschiedene Arten von Fehlern basierend auf ihrer Quelle nachverfolgen. Hier hat das Fabrikam Fiber-Team die Service-App WIT hinzugefügt, um die Arbeit ihres Kundendienstteams nachzuverfolgen.

Um ein WIT hinzuzufügen, um es als Anforderung, Aufgabe oder Fehler zu verfolgen, führen Sie die entsprechenden Schritte aus:

• Fügen Sie ein WIT hinzu, um Anforderungen zu verfolgen
• Fügen Sie ein WIT hinzu, um Aufgaben zu verfolgen
• Hinzufügen eines WIT zur Fehlerkategorie

Anpassungssequenz

Anpassungssequenz des gehosteten XML-Prozessmodells

Sie nehmen Ihre Änderungen an den Prozessdefinitionsdateien vor, und importieren sie dann, um vorhandene Projekte zu aktualisieren oder den Prozess zum Erstellen eines Projekts zu verwenden.

• Wenn Sie nicht der Organisationsbesitzer oder Mitglied der Gruppe der Projektgruppensammlungsadministratoren sind, lassen Sie sich hinzufügen.
• Exportieren des Prozesses, den Sie aktualisieren möchten
• Wenn Sie mit dem Anpassen eines Prozesses noch nicht fertig sind, lesen Sie " Anpassen eines Prozesses für den Import".

Lokale XML-Prozessmodellanpassungssequenz

Sie exportieren zuerst Ihre Arbeitsverfolgungsdefinitionsdateien, aktualisieren sie und importieren sie dann in Ihr Projekt.

• Wenn Sie kein Mitglied der Gruppe "Projektadministrator" oder "Projektsammlungsadministrator" sind, werden Sie hinzugefügt.
• Aktualisieren Ihres Projekts, um die neuesten Features zu aktivieren
• Exportieren Sie die folgenden Objekte aus Ihrem Projekt:
  • WIT, die Sie zu Backlogs und Boards hinzufügen möchten (wenn Sie es noch nicht erstellt haben, tun Sie dies jetzt)
  • Prozesskonfiguration
• Wenn Sie noch nicht mit der Anpassung von Arbeitsverfolgungsobjekten vertraut sind, machen Sie sich mit den folgenden Ressourcen vertraut:
  • Hinzufügen oder Ändern eines Felds
  • Hinzufügen oder Ändern eines Arbeitselementtyps
  • ProcessConfiguration XML-Referenz.

Fügen Sie ein WIT hinzu, um es wie eine Anforderung nachzuverfolgen.

WITs, die Sie zur Anforderungskategorie hinzufügen, werden im Produktrückstand und auf dem Board angezeigt. Sie müssen sicherstellen, dass die WIT-Definition erforderliche Felder enthält, um die Agile-Planungstools zu unterstützen.

1. Exportieren Sie Ihren Prozess (gehostetes XML) oder Ihre Definitionsdateien (lokales XML), wie in den ersten Schritten angegeben.

2. Bearbeiten Sie die WIT-Definition, um Planungstools zu unterstützen.

   Anpassen/Syntax zum Hinzufügen oder Aktualisieren

   Stack Rank-Feld (Agile, CMMI)

   <FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">     
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage. 
   </HELPTEXT>      
   </FIELD> 
   

   Backlog Priority-Feld (Scrum)

   <FIELD name="Backlog Priority" refname="Microsoft.VSTS.Common.BacklogPriority" type="Double" reportable="detail" /> 
   

   Wertbereichsfeld

   <FIELD name="Value Area" refname="Microsoft.VSTS.Common.ValueArea" type="String"> 
   <REQUIRED />   
   <ALLOWEDVALUES>    
   <LISTITEM value="Architectural" />   
   <LISTITEM value="Business"/>   
   </ALLOWEDVALUES>   
   <DEFAULT from="value" value="Business" /> 
   <HELPTEXT>Business = delivers value to a user or another system; Architectural = work to support other stories or components  
   </HELPTEXT>   
   </FIELD>
   

   Anforderungstypfeld (CMMI)

   <FIELD name="Requirement Type" refname="Microsoft.VSTS.CMMI.RequirementType" type="String" reportable="dimension">  
   <REQUIRED />  
   <ALLOWEDVALUES>  
   <LISTITEM value="Scenario" />  
   <LISTITEM value="Quality of Service" />  
   <LISTITEM value="Functional" /> 
   <LISTITEM value="Operational" />  
   <LISTITEM value="Interface" />  
   <LISTITEM value="Security" />  
   <LISTITEM value="Safety" />  
   <LISTITEM value="Business Objective" />  
   <LISTITEM value="Feature" />  
   </ALLOWEDVALUES> 
   <DEFAULT from="value" value="Functional" />  
   </FIELD>
   

   WORKFLOW Abschnitt aktualisieren oder überprüfen Sie den WORKFLOW Abschnitt wie folgt:

   • Agile, User Story: Übergänge von Active nach Removed und von Resolved nach Removed hinzufügen; Regeln entfernen, die die Felder Activated By und Activated Date ausfüllen, wenn der Zustand Resolved ist.
   • Scrum, Produktrückstandselement: Übergang von Committed zu Removed
     Wenn Sie das angepasst haben, stellen Sie sicher, dass Sie die erforderlichen Zustands-zu-Metastate-Zuordnungen im Abschnitt ProcessConfiguration definieren.

   Fügen Sie im Abschnitt FORM hinzu oder überprüfen Sie, ob die folgenden Felder zum Abschnitt FORM hinzugefügt wurden:

   • Agil:

   <Control FieldName="Microsoft.VSTS.Scheduling.StoryPoints" Type="FieldControl" Label="Story Points" LabelPosition="Left" />  
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

   • CMMI:

   <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.Size" Label="Size" LabelPosition="Left" />
   <Control Type="FieldControl" FieldName="Microsoft.VSTS.CMMI.RequirementType" Label="Type" LabelPosition="Left" /> 
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

   • Scrum:

   <Control FieldName="Microsoft.VSTS.Scheduling.Effort" Type="FieldControl" Label="Effort" LabelPosition="Left" />  
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

3. Bearbeiten Sie die Kategoriendefinition. Fügen Sie die WIT zur Kategorie "Anforderung" hinzu. Hier fügen wir die Service-App hinzu.

   <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
      <DEFAULTWORKITEMTYPE name="User Story" />
      <WORKITEMTYPE name="Service App" />
   </CATEGORY>
   

4. Aktualisieren oder Überprüfen Sie die ProcessConfiguration-Definition im RequirementBacklog-Abschnitt für das WIT, das Sie hinzufügen möchten. Stellen Sie insbesondere sicher, dass die folgenden Bedingungen erfüllt sind:

   • Zuordnen des Beginns jedes Workflow-Status zu type="Proposed"
   • Ordnen Sie jeden zwischengeschalteten Workflowstatus zu, den Sie auf der Tafel anzeigen lassen möchten, zu type="InProgress".
   • Zuordnen des Endes jedes Workflowstatus zu type="Complete"
   • Stellen Sie sicher, dass nur ein Zustand type="Complete" zugeordnet ist.
     Fügen Sie beispielsweise den Workflowstatus "Ausstehend" hinzu:

   <States>    
        <State value="New" type="Proposed" />  
        <State value="Active" type="InProgress" />  
        <State value="Pending" type="InProgress" />  
        <State value="Resolved" type="InProgress" />  
        <State value="Closed" type="Complete" />  
   </States>   
   

5. Fügen Sie die WIT-Farbdefinition zum Abschnitt "ProcessConfiguration WorkItemColors " hinzu. Zum Beispiel:

   <WorkItemColor primary="FF33CC33" secondary="FFD6F5D6" name="Service App" />
   

6. Aktualisieren Sie Ihr Projekt:

   • Gehosteter XML:Importieren Sie Ihren Prozess.
   • Lokale XML:Importieren Sie die Definitionsdateien, die Sie in dieser Reihenfolge aktualisiert haben:
     a. WIT b. Kategorien
     c. Prozesskonfiguration

Fügen Sie ein WIT zur Nachverfolgung als Aufgabe hinzu

WITs, die Sie der Aufgabenkategorie hinzufügen, werden in den Sprint-Backlogs und Taskboards angezeigt. Das WIT, das Sie hinzufügen, muss erforderliche Felder angeben, die die Unterstützung der agilen Planungstools ermöglichen.

1. Exportieren Sie Ihren Prozess (gehostetes XML) oder Ihre Definitionsdateien (lokales XML), wie in den ersten Schritten angegeben.

2. Bearbeiten Sie die WIT-Definition, um Planungstools zu unterstützen.

   Anpassen/Syntax zum Hinzufügen oder Aktualisieren

   Stack Rank-Feld (Agile, CMMI)

   <FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">  
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.  
   </HELPTEXT>   
   </FIELD> 
   

   **Backlog-Priorität**-Feld (Scrum)

   <FIELD name="Backlog Priority" refname="Microsoft.VSTS.Common.BacklogPriority" type="Double" reportable="detail" />   
   

   Aktivitätsfeld (Agile, Scrum)

   <FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension"> 
   <HELPTEXT&gt;Type of work involved&lt/HELPTEXT> 
   <SUGGESTEDVALUES&gt;  
   <LISTITEM value="Development" />    
   <LISTITEM value="Testing" />    
   <LISTITEM value="Requirements" />    
   <LISTITEM value="Design" />    
   <LISTITEM value="Deployment" />    
   <LISTITEM value="Documentation" />    
   </SUGGESTEDVALUES>    
   </FIELD>    
   

   Feld „Discipline“ (CMMI)

   <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">  
   <ALLOWEDVALUES&gt;  
   <LISTITEM value="Analysis" />    
   <LISTITEM value="User Experience" />   
   <LISTITEM value="User Education" />    
   <LISTITEM value="Development" />   
   <LISTITEM value="Test" />   
   </ALLOWEDVALUES>    
   </FIELD>    
   

   Verbleibende Arbeit Feld (alle)

   <FIELD name="Remaining Work" refname="Microsoft.VSTS.Scheduling.RemainingWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>    
   An estimate of the work remaining to complete the task (in person hours)  
   </HELPTEXT>
   </FIELD>    
   

   Zusätzliche Planungsfelder (Agile, CMMI)

   <FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT&gt; The original estimate of work required to complete the task (in person hours)</HELPTEXT>   
   </FIELD>    
   <FIELD name="Remaining Work" refname="Microsoft.VSTS.Scheduling.RemainingWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>An estimate of the work remaining to complete the task (in person hours)
   </HELPTEXT>  
   </FIELD>    
   <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>    
   The work that has been completed for this task (in person hours)  
   <HELPTEXT>    
   </FIELD>    
   <FIELD name="Start Date" refname="Microsoft.VSTS.Scheduling.StartDate" type="DateTime" reportable="dimension" />   
   <FIELD name="Finish Date" refname="Microsoft.VSTS.Scheduling.FinishDate" type="DateTime" reportable="dimension" />   
   

   WORKFLOW-Abschnitt
   Aktualisieren oder überprüfen Sie den WORKFLOW Abschnitt wie folgt:

   • Agile, User Story: Hinzufügen von Übergängen von Active zu Removed und von Resolved zu Removed; Entfernen von Regeln, die die Felder Activated By und Activated Date befüllen, wenn der Zustand = Resolved ist.
   • Scrum, Produktrückstandselement: Übergang von Committed zu Removed
     Wenn Sie die Eigenschaft angepasst haben, müssen Sie die erforderlichen Zustands-zu-Metastate-Zuordnungen in der ProcessConfiguration--Sektion definieren.

   FORM-Abschnitt
   Fügen Sie dem Abschnitt die folgenden Felder hinzu, oder überprüfen Sie, ob sie dem FORM Abschnitt hinzugefügt wurden:

   • Agil:

   <Control FieldName="Microsoft.VSTS.Scheduling.StoryPoints" Type="FieldControl" Label="Story Points" LabelPosition="Left" />    
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

   • CMMI:

   <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.Size" Label="Size" LabelPosition="Left" /&gt;    
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

   • Scrum:

   <Control FieldName="Microsoft.VSTS.Scheduling.Effort" Type="FieldControl" Label="Effort" LabelPosition="Left" />   
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

3. Bearbeiten Sie die Kategoriendefinition. Fügen Sie die WIT zur Kategorie "Aufgabe" hinzu. Hier fügen wir "Dienstaufgabe" hinzu.

   <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
      <DEFAULTWORKITEMTYPE name="Task" />
      <WORKITEMTYPE name="Service Task" />
   </CATEGORY>
   

4. Aktualisieren oder Überprüfen Sie die ProcessConfiguration-Definition im TaskBacklog-Abschnitt für das WIT, das Sie hinzufügen möchten.
   Stellen Sie insbesondere sicher, dass die folgenden Bedingungen erfüllt sind:

   • Zuordnen des Beginns jedes Workflow-Status zu type="Proposed"
   • Ordnen Sie jeden Zwischenzustand des Workflows zu, den Sie auf dem Taskboard anzeigen möchten. type="InProgress"
   • Zuordnen des Endes jedes Workflowstatus zu type="Complete"
   • Stellen Sie sicher, dass nur ein Zustand type="Complete" zugeordnet ist.

   Fügen Sie beispielsweise den Blocked Workflowstatus hinzu:

   <States>  
      <State value="New" type="Proposed" />  
      <State value="Active" type="InProgress" />  
      <State value="Blocked" type="InProgress" />  
      <State value="Resolved" type="InProgress" />  
      <State value="Closed" type="Complete" />  
   </States>  
   

5. Fügen Sie die WIT-Farbdefinition zum Abschnitt "ProcessConfiguration WorkItemColors " hinzu. Zum Beispiel:

   <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Service Task" />
   

6. Aktualisieren Sie Ihr Projekt:

   • Gehosteter XML:Importieren Sie Ihren Prozess.
   • Lokale XML:Importieren Sie die Definitionsdateien, die Sie in dieser Reihenfolge aktualisiert haben:
     a. WIT
     b. Kategorien
     c. Prozesskonfiguration

7. Vergewissern Sie sich, dass Sie das WIT zum Task Board hinzufügen können. Öffnen Sie die Task Board-Seite, oder aktualisieren Sie die Seite, wenn sie bereits geöffnet ist.
   Sie sollten entweder "Aufgabe" oder "Servicetask" als verknüpftes Arbeitselement für eine Benutzergeschichte auswählen können.
   

   Ziehen Sie auf der Task board die Arbeitsaufgabe, um den Status zu aktualisieren. Sie werden feststellen, dass Sie ein Element nicht in eine Spalte ziehen können, für die der Zustand ungültig ist. Beispielsweise können Sie "Aufgabe" nicht in den Status "Blockiert" oder "Aufgabe" in einen aufgelösten Zustand ziehen. Wenn Sie diese Zustände verwenden möchten, fügen Sie sie der Workflowdefinition für die entsprechende WIT-Definition hinzu.

WIT zur Fehlerkategorie hinzufügen

WITs, die Sie der Bug-Kategorie hinzufügen, werden entsprechend der Teameinstellung behandelt. Da diese WITs entweder als Anforderungen oder Aufgaben behandelt werden, müssen sie die Anforderungen des Agile-Planungstools sowohl für Anforderungen als auch für Aufgaben erfüllen.

1. Exportieren Sie Ihren Prozess (gehostetes XML) oder Ihre Definitionsdateien (lokales XML), wie in den ersten Schritten angegeben.

2. Bearbeiten Sie die WIT-Definition, um Planungstools zu unterstützen, indem Sie die in Schritt 2 aufgeführten Bedingungen erfüllen, um ein WIT hinzuzufügen, das als Anforderungen oder als Aufgaben nachverfolgt werden kann.

3. Bearbeiten Sie die Kategoriendefinition. Fügen Sie die WIT zur Fehlerkategorie hinzu. Hier fügen wir zwei WITs hinzu.

   <CATEGORY name="Bug Category" refname="Microsoft.BugCategory">  
      <DEFAULTWORKITEMTYPE name="Bug" />  
      <WORKITEMTYPE name="Service Bug" />  
      <WORKITEMTYPE name="Feedback" />  
   </CATEGORY>
   

4. Aktualisieren oder Überprüfen Sie die ProcessConfiguration-Definition im BugWorkItems-Abschnitt für das WIT, das Sie hinzufügen möchten.

   Stellen Sie insbesondere sicher, dass die folgenden Bedingungen erfüllt sind:

   • Zuordnen des Beginns jedes Workflow-Status zu type="Proposed"
   • Ordnen Sie jeden Zwischenworkflowstatus zu, den Sie auf dem Board oder Taskboard anzeigen möchten. type="InProgress"
   • Zuordnen des Endes jedes Workflowstatus zu type="Complete"
   • Stellen Sie sicher, dass nur ein Zustand type="Complete" zugeordnet ist.

   Fügen Sie beispielsweise den Investigate Workflowstatus hinzu:

   <States>  
    <State value="New" type="Proposed" />  
    <State value="Active" type="InProgress" />  
    <State value="Investigate" type="InProgress" />  
    <State value="Resolved" type="InProgress" />  
    <State value="Closed" type="Complete" />  
   </States>  
   

5. Fügen Sie die WIT-Farbdefinition zum Abschnitt "ProcessConfiguration WorkItemColors " hinzu. Zum Beispiel:

   <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Service Bug" />  
   <WorkItemColor primary="FFFF00FF" secondary="FFFFCCFF" name="Feedback" />  
   

6. Aktualisieren Sie Ihr Projekt:

   • Gehosteter XML:Importieren Sie Ihren Prozess.
   • Lokale XML:Importieren Sie die Definitionsdateien, die Sie in dieser Reihenfolge aktualisiert haben:
     a. WIT
     b. Kategorien
     c. Prozesskonfiguration

7. Wählen Sie Ihre Teameinstellung für die Nachverfolgung von Fehlern aus.

8. Vergewissern Sie sich, dass das WIT auf den Backlogs und Boards erwartungsgemäß angezeigt wird und dass es erwartungsgemäß durch die Backlogs hinzugefügt werden kann.

Importieren und Exportieren von Definitionsdateien (lokales XML)

Verwenden Sie die Befehle "witadmin ", um Definitionsdateien zu importieren und zu exportieren. Weitere Informationen finden Sie unter witAdmin: Anpassen und Verwalten von Objekten zum Nachverfolgen von Arbeiten.

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

1. Geben Sie den witadmin Befehl ein, und ersetzen Sie ihre Daten durch die angezeigten Argumente. So importieren Sie beispielsweise ein WIT:

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

   Geben Sie für CollectionURL die URL einer Projektauflistung und für ProjectName den Namen eines projekts an, das in der Auflistung definiert ist. Sie müssen die URL im folgenden Format angeben: http://ServerName:Port/VirtualDirectoryName/CollectionName.

   Geben Sie für DirectoryPath den Pfad zu dem Ordner an, der WorkItem Tracking/TypeDefinitions die von Ihnen heruntergeladene Prozessvorlage enthält. Der Verzeichnispfad muss der folgenden Struktur folgen: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.

   Importieren Sie beispielsweise die ServiceApp WIT:

   witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection"/p:MyProject /f:"DirectoryPath/ServiceApp.xml"
   

Verwenden Sie die folgenden Befehle, um WITs, Kategorien und Prozesskonfigurationen zu exportieren und zu importieren:

witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:TypeName /f:"DirectoryPath\WITDefinitionFile.xml"  
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"  
witadmin exportcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"  
witadmin importcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"   
witadmin exportprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"  
witadmin importprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"  

Verwandte Inhalte

In diesem Artikel wird gezeigt, wie Sie Ihrem Backlog oder Board ein weiteres WIT hinzufügen können. Wenn Sie ein weiteres WIT hinzufügen möchten, das als Portfolio-Backlog fungiert, lesen Sie "Hinzufügen von Portfolio-Backlogs".

Eine Übersicht über alle verfügbaren Optionen zum Anpassen von Arbeitsverfolgungsobjekten finden Sie unter Anpassen der Arbeitsverfolgungsfunktionen .

Informationen dazu, wie hierarchische oder geschachtelte Elemente in einem Backlog oder Board angezeigt werden, finden Sie unter Wie Backlogs und Boards hierarchische (geschachtelte) Elemente anzeigen.