Lägga till en typ av arbetsobjekt i en backlog och en tavla

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

Viktigt!

Den här artikeln gäller för projektanpassning för värdbaserade XML- och lokala XML-processmodeller. För arvsprocessmodellen, se Anpassa dina kvarvarande uppgifter eller tavlor för en process. En översikt över processmodeller finns i Anpassa din arbetsspårningsupplevelse.

För att uppfylla utvalda affärsprocesser kanske ditt team vill spåra ytterligare typer av arbetsobjekt (WIT) som krav eller som uppgifter. På så sätt kan du lägga till dem och spåra dem i produkt- och sprint-eftersläpningar eller styrelse- och uppgiftstavlor.

Du kanske till exempel vill spåra olika typer av krav baserat på deras målkund eller olika typer av buggar baserat på källan. Här har Fabrikam Fiber-teamet lagt till Service App WIT för att spåra arbete som stöder deras kundtjänstteam.

Lägg till en anpassad WIT, t.ex. Tjänstapp, i kravkategorin för att spåra den som ett krav

Tips

Om allt du vill göra är att lägga till buggar i dina backloggar och boardar, se Visa buggar på backloggar och boardar för att ditt team ska kunna välja. Om du vill lägga till ytterligare en WIT- och portföljloggning kan du läsa Lägga till en portföljs kvarvarande uppgifter.

För att lägga till en WIT för att spåra krav, uppgifter eller buggar, utför motsvarande steg:

Lägg till en WIT för att spåra som ett krav
Lägg till en WIT så att den kan spåras som uppgifter
Lägg till en WIT i buggkategorin

Kommentar

Lägg till en WIT i en och endast en av följande kategorier: Kravkategori, Aktivitetskategori eller Buggkategori. Systemet hindrar dig från att lägga till samma WIT i både kravkategorin och uppgiftskategorin. WIT:er som du lägger till i Bug Category följer den felbeteendeuppsättning som är definierad för teamet.

Anpassningssekvens

Anpassningssekvens för värdbaserad XML-processmodell

Kommentar

Använd följande vägledning om du anpassar processen genom import/export av definitionsfiler. Om du annars anpassar processen via administratörsgränssnittet kan du läsa Lägga till eller ändra en anpassad arbetsobjekttyp för en process.

Du gör dina ändringar i processdefinitionsfilerna och importerar sedan processen för att antingen uppdatera befintliga projekt eller använda processen för att skapa ett projekt.

Om du inte är organisationsägare eller medlem i gruppen Projektsamlingsadministratör läggs du till.
Exportera den process som du vill uppdatera
Om du är nybörjare på att anpassa en process läser du Anpassa en importprocess.

Anpassningssekvens för lokal XML-processmodell

Först exporterar du definitionsfilerna för arbetsspårning, uppdaterar dem och importerar dem sedan till projektet.

Om du inte är medlem i gruppen Projektadministratör eller Projektsamlingsadministratör läggs du till.
Uppdatera projektet för att aktivera de senaste funktionerna
Exportera följande objekt från projektet:
- WIT som du vill lägga till i kvarvarande uppgifter och tavlor (om du inte har skapat det gör du det nu)
- ProcessConfiguration
Om du är nybörjare på att anpassa arbetsspårningsobjekt kan du bekanta dig med följande resurser:
- Lägga till eller ändra ett fält
- Lägga till eller ändra en typ av arbetsobjekt
- Xml-referens för ProcessConfiguration.

Lägg till en WIT för att spåra den som ett krav

WITs som du lägger till i kategorin för krav visas i backloggen och tavlan. Du måste se till att WIT-definitionen innehåller obligatoriska fält för att stödja agila planeringsverktyg.

Exportera din process (värdbaserad XML) eller dina definitionsfiler (lokal XML) enligt de första stegen.

Redigera WIT-definitionen för att stödja planeringsverktyg.

Anpassa/syntax för att lägga till eller uppdatera

Stack Rank-fält (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>

Fältet Backlogprioritet (Scrum)

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

Värdeområdesfält

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

Kravtypsfältet (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 avsnittet Uppdatera eller verifiera avsnittet på WORKFLOW följande sätt:

Agile, User Story: Lägg till övergångar från Active till Removed och Resolved till Removed; ta bort regler som fyller fälten Activated By och Activated Date när status=Resolved
Scrum, produktbackloggpost: Lägg till övergång från Committed till Removed
Om du har anpassat WORKFLOW, ska du definiera de tillstånd-till-metatillstånd-mappningar som krävs i RequirementBacklog ProcessConfiguration.

FORM avsnitt Lägg till eller kontrollera att följande fält har lagts till i avsnittet FORM :

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" />

Redigera definitionen av Kategorier. Lägg till WIT i kategorin Krav. Här lägger vi till Service App.

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

Uppdatera eller verifiera definitionen för ProcessConfiguration: RequirementBacklog avsnitt för den WIT som du håller på att lägga till. Mer specifikt kontrollerar du att följande villkor är uppfyllda:
- Mappa starten av varje arbetsflödestillstånd till type="Proposed"
- Mappa varje mellanliggande arbetsflödestillstånd som du vill visa på tavlan till type="InProgress"
- Mappa slutet av varje arbetsflödestillstånd till type="Complete"
- Kontrollera att du bara har ett tillstånd som är kopplat till type="Complete"
  Lägg till exempel till tillståndet Väntande arbetsflöde:
```
<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>   
```
Lägg till WIT-färgdefinitionen i avsnittet ProcessConfiguration WorkItemColors . Till exempel:
```
<WorkItemColor primary="FF33CC33" secondary="FFD6F5D6" name="Service App" />
```
Uppdatera projektet:
- Värdbaserad XML:Importera din process.
- Lokal XML:Importera definitionsfilerna som du uppdaterade i den här ordningen:
  a. WIT b. Kategorier
  c. ProcessConfiguration

Lägga till en WIT för att spåra den som en uppgift

WITs som du lägger till i uppgiftskategorin visas på sprintbackloggar och uppgiftstavlor. Den WIT som du lägger till måste ange obligatoriska fält som stöd för agila planeringsverktyg.

Exportera din process (värdbaserad XML) eller dina definitionsfiler (lokal XML) enligt de första stegen.

Redigera WIT-definitionen för att stödja planeringsverktyg.

Anpassa/syntax för att lägga till eller uppdatera

Prioritetsrangordning field (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>

** Prioritet för kvarvarande uppgifter** fält (Scrum)

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

Aktivitetsfält (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>

Disciplinfältet (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>

Återstående arbetsfält (alla)

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

Ytterligare schemaläggningsfält (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 avsnitt
Uppdatera eller verifiera avsnittet på WORKFLOW följande sätt:

Agile, User Story: Lägg till övergångar från Active till Removed och Resolved till Removed; ta bort regler som fyller i fälten Activated By och Activated Date när Resolved = tillstånd
Scrum, produktbackloggpost: Lägg till övergång från Committed till Removed
Om du har anpassat WORKFLOW, ska du definiera de mappningar från tillstånd till metavärde som krävs i ProcessConfiguration TestBacklog avsnittet.

FORM avsnitt
Lägg till eller kontrollera att följande fält har lagts till i avsnittet FORM :

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" />

Redigera definitionen av Kategorier. Lägg till WIT i kategorin Aktivitet. Här lägger vi till servicetask.

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

Uppdatera eller verifiera definitionen för ProcessConfiguration: TaskBacklog avsnitt för den WIT som du håller på att lägga till.
Mer specifikt kontrollerar du att följande villkor är uppfyllda:
- Mappa starten av varje arbetsflödestillstånd till type="Proposed"
- Mappa varje mellanliggande arbetsflödestillstånd som du vill ska visas på aktivitetstavlan till type="InProgress"
- Mappa slutet av varje arbetsflödestillstånd till type="Complete"
- Kontrollera att du bara har ett tillstånd som är kopplat till type="Complete"
Lägg till exempel till arbetsflödestillståndet Blocked :
```
<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>  
```
Lägg till WIT-färgdefinitionen i avsnittet ProcessConfiguration WorkItemColors . Till exempel:
```
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Service Task" />
```
Uppdatera projektet:
- Värdbaserad XML:Importera din process.
- Lokal XML:Importera definitionsfilerna som du uppdaterade i den här ordningen:
  a. INTELLIGENS
  b. Kategorier
  c. ProcessConfiguration
Bekräfta att du kan lägga till WIT i aktivitetstavlan. Öppna sidan aktivitetstavla eller uppdatera sidan om den redan är öppen.
Du bör kunna välja antingen uppgift eller tjänsteuppgift som är kopplat till en användarberättelse.

På aktivitetstavlan drar du arbetsobjektet för att uppdatera dess status. Du ser att du inte kan dra ett objekt till en kolumn som tillståndet inte är giltigt för. Du kan till exempel inte dra aktiviteten till tillståndet Blockerad eller en aktivitet till ett löst tillstånd. Om du vill använda dessa tillstånd lägger du till dem i arbetsflödesdefinitionen för motsvarande WIT-definition.

Lägg till en WIT i bugkategori

WIT:er som du lägger till i Buggkategorin behandlas baserat på teaminställningen. Eftersom dessa WIT-nätverk kan behandlas antingen som krav eller uppgifter måste de uppfylla kraven för agilt planeringsverktyg för både krav och uppgifter.

Exportera din process (värdbaserad XML) eller dina definitionsfiler (lokal XML) enligt de första stegen.
Redigera WIT-definitionen för att stödja planeringsverktyg genom att uppfylla de villkor som anges för steg 2 i Lägg till en WIT för att spåra som krav och Lägga till en WIT för att spåra som uppgifter.

Redigera definitionen av Kategorier. Lägg till WIT i buggkategorin. Här lägger vi till två WITs.

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

Uppdatera eller verifiera definitionen för ProcessConfiguration: BugWorkItems avsnitt för den WIT som du håller på att lägga till.

Mer specifikt kontrollerar du att följande villkor är uppfyllda:
- Mappa starten av varje arbetsflödestillstånd till type="Proposed"
- Mappa varje mellanliggande arbetsflödestillstånd som du vill ska visas på tavlan eller i Aktivitetstavlan till type="InProgress"
- Mappa slutet av varje arbetsflödestillstånd till type="Complete"
- Kontrollera att du bara har ett tillstånd som är kopplat till type="Complete"
Lägg till exempel till arbetsflödestillståndet Investigate :
```
<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>  
```

Lägg till WIT-färgdefinitionen i avsnittet ProcessConfiguration WorkItemColors . Till exempel:

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

Uppdatera projektet:
- Värdbaserad XML:Importera din process.
- Lokal XML:Importera definitionsfilerna som du uppdaterade i den här ordningen:
  a. INTELLIGENS
  b. Kategorier
  c. ProcessConfiguration
Välj din teaminställning för hur buggar spåras.
Bekräfta att WIT visas i arbetsförteckningar och på planeringstavlor som förväntat och att du kan lägga till det via arbetsförteckningarna.

Importera och exportera definitionsfiler (lokal XML)

Använd witadmin-kommandona för att importera och exportera definitionsfiler. Mer information finns i witAdmin: Anpassa och hantera objekt för spårningsarbete.

Tips

Med witadmin kan du importera och exportera definitionsfiler. Andra verktyg som du kan använda är processredigeraren (kräver att du har installerat en version av Visual Studio). Installera redigeraren För processmall från Visual Studio Marketplace.

Öppna ett kommandotolkfönster enligt anvisningarna i witAdmin: Anpassa och hantera objekt för spårningsarbete. Till exempel:

witadmin Ange kommandot och ersätt dina data med de argument som visas. Om du till exempel vill importera en WIT:
```
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"
```
För CollectionURL anger du URL:en för en projektsamling och för ProjectName anger du namnet på ett projekt som definierats i samlingen. Du måste ange URL:en i följande format: http://ServerName:Port/VirtualDirectoryName/CollectionName.

För DirectoryPath anger du sökvägen till mappen WorkItem Tracking/TypeDefinitions som innehåller den processmall som du laddade ned. Katalogsökvägen måste följa den här strukturen: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.

Importera till exempel ServiceApp WIT:
```
witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection"/p:MyProject /f:"DirectoryPath/ServiceApp.xml"
```

Använd dessa kommandon för att exportera och importera WIT, kategorier och processkonfiguration:

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"

Den här artikeln visar hur du kan lägga till en annan WIT i dina backloggar eller tavlor. Om du vill lägga till en annan WIT som portföljens eftersläpning, se Lägg till portföljeftersläpningar.

Se Anpassa din arbetsspårningsupplevelse för en översikt över alla tillgängliga alternativ för att anpassa arbetsspårningsobjekt.

För att lära dig hur hierarkiska eller inbäddade element visas på en backlog eller ett bräde, se Så här visar backlogs och bräden hierarkiska (inbäddade) objekt.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-03-28