Přidání typu pracovní položky do backlogu a panelu

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Důležité

Tento článek se týká přizpůsobení projektu pro hostované modely procesů XML a místních procesů XML. Model procesu dědičnosti najdete v tématu Přizpůsobení backlogů nebo panelů procesu. Přehled modelů procesů najdete v tématu Přizpůsobení prostředí pro sledování práce.

Aby váš tým uspokojil vybrané obchodní procesy, může chtít sledovat další typy pracovních položek (WIT) jako požadavky nebo úkoly. Tímto způsobem je můžete přidat a sledovat v backlogech produktů a sprintů nebo na panelech a na panelech úkolů.

Můžete například chtít sledovat různé typy požadavků na základě jejich cílového zákazníka nebo různé typy chyb na základě jejich zdroje. Tým Fabrikam Fiber přidal službu Service App WIT ke sledování práce, která podporuje tým zákaznických služeb.

Přidejte do kategorie požadavků vlastní wit, například aplikaci služby, abyste ji mohli sledovat jako požadavek.

Tip

Pokud chcete jen přidat do backlogů a panelů chyby, podívejte se na článek Zobrazit chyby v backlogech a panelech , abyste mohli vybrat tým. Pokud chcete přidat další interní informace a backlog portfolia, přečtěte si téma Přidání úrovně backlogu portfolia.

Pokud chcete přidat wiT ke sledování požadavků, úkolů nebo chyb, proveďte odpovídající kroky:

Poznámka:

Doporučujeme přidat pracovní položky do jedné a pouze jedné z následujících kategorií: Kategorie požadavku, Kategorie úkolu nebo Kategorie chyb. Systém vám znemožní přidat stejnou pracovní hodnotu do kategorie požadavku i kategorie úkolu. Technologie WIT, které přidáte do kategorie chyb, budou následovat po nastavení chování chyby pro tým.

Posloupnost přizpůsobení

Pořadí přizpůsobení modelu hostovaného procesu XML

Poznámka:

Pokud proces přizpůsobíte importem nebo exportem definičních souborů, postupujte podle následujících pokynů. Jinak pokud proces přizpůsobíte prostřednictvím uživatelského rozhraní správce, přečtěte si článek Přidání nebo úprava vlastního typu pracovní položky pro proces.

Provedete změny v definičních souborech procesu a pak tento proces naimportujete, abyste aktualizovali existující projekty, nebo pomocí procesu vytvořili projekt.

Pořadí přizpůsobení místního modelu procesu XML

Nejprve exportujete definiční soubory sledování práce, aktualizujete je a pak je naimportujete do projektu.

Přidání wit pro sledování, jako je požadavek

Technologie WIT, které přidáte do kategorie požadavků, se zobrazí v backlogu a panelu produktu. Je nutné zajistit, aby definice WIT obsahovala požadovaná pole pro podporu nástrojů pro agilní plánování.

  1. Exportujte proces (hostovaný XML) nebo definiční soubory (místní XML), jak je uvedeno v prvních krocích.

  2. Upravte definici wit tak, aby podporovala nástroje pro plánování.

    Přizpůsobení nebo syntaxe pro přidání nebo aktualizaci

    Pole Stack Rank (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>

    Pole Priorita backlogu (Scrum)

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

    Pole Oblast hodnoty

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

    Pole Typ požadavku (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 oddíl aktualizujte nebo následujícím způsobem ověřte WORKFLOW :

    • Agilní, uživatelský scénář: Přidání přechodů z Active Removed a Resolved do Removed; odebrání pravidel, která naplňují Activated By a Activated Date pole při stavu=Resolved
    • Scrum, položka backlogu produktu: Přidání přechodu z Committed do Removed
      Pokud jste přizpůsobili WORKFLOWmapování stavu na metastate, nezapomeňte v části ProcessConfiguration RequirementBacklog definovat požadovaná mapování stavu na metastate.

    FORM přidejte nebo ověřte, že se do oddílu FORM přidala následující pole:

    • Hbitý:
    <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" />
    • Skrumáž:
    <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. Upravte definici kategorie. Přidejte hodnotu WIT do kategorie Požadavek. Tady přidáme aplikaci služby.

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

  4. Aktualizujte nebo ověřte definici ProcessConfiguration: RequirementBacklog část pro definici wit, kterou přidáváte. Konkrétně se ujistěte, že jsou splněny následující podmínky:

    • Mapování začátku každého stavu pracovního postupu na type="Proposed"
    • Namapujte každý zprostředkující stav pracovního postupu, který chcete mít na panelu. type="InProgress"
    • Namapujte konec každého stavu pracovního postupu na type="Complete"
    • Ujistěte se, že máte namapovaný jenom jeden stát. type="Complete"
      Přidejte například stav čekajícího pracovního postupu:
    <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. Do části ProcessConfiguration WorkItemColors přidejte definici barvy WIT. Příklad:

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

  6. Aktualizujte projekt:

Přidání pracovní položky ke sledování jako úkolu

Pracovní položky, které přidáte do kategorie úkolů, se zobrazí v backlogech sprintu a na panelech úkolů. Přidaná definice musí určovat požadovaná pole pro podporu nástrojů pro agilní plánování.

  1. Exportujte proces (hostovaný XML) nebo definiční soubory (místní XML), jak je uvedeno v prvních krocích.

  2. Upravte definici wit tak, aby podporovala nástroje pro plánování.

    Přizpůsobení nebo syntaxe pro přidání nebo aktualizaci

    Pole Stack Rank (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>

    ** Pole Priorita backlogu** (Scrum)

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

    Pole Aktivity (Agilní, 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>

    Pole Disciplína (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>

    Pole Zbývající práce (vše)

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

    Další pole plánování (Agilní, 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 oddíl
    Aktualizujte nebo ověřte WORKFLOW oddíl následujícím způsobem:

    • Agilní, uživatelský scénář: Přidání přechodů z Active Removed a Resolved do Removed; odebrání pravidel, která naplňují Activated By a Activated Date pole při stavu=Resolved
    • Scrum, položka backlogu produktu: Přidání přechodu z Committed do Removed
      Pokud jste přizpůsobili WORKFLOWmapování stavu na metastate, nezapomeňte v části ProcessConfiguration TestBacklog definovat požadovaná mapování stavu na metastate.

    FORM oddíl
    Přidejte nebo ověřte, že do oddílu FORM byly přidána následující pole:

    • Hbitý:
    <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" />
    • Skrumáž:
    <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. Upravte definici kategorie. Přidejte pracovní položky do kategorie Úkol. Tady přidáme úlohu služby.

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

  4. Aktualizujte nebo ověřte definici ProcessConfiguration: TaskBacklog část pro definici wit, kterou přidáváte.
    Konkrétně se ujistěte, že jsou splněny následující podmínky:

    • Mapování začátku každého stavu pracovního postupu na type="Proposed"
    • Namapujte každý zprostředkující stav pracovního postupu, který chcete mít na panelu úkolů. type="InProgress"
    • Namapujte konec každého stavu pracovního postupu na type="Complete"
    • Ujistěte se, že máte namapovaný jenom jeden stát. type="Complete"

    Přidejte například Blocked stav pracovního postupu:

    <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. Do části ProcessConfiguration WorkItemColors přidejte definici barvy WIT. Příklad:

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

  6. Aktualizujte projekt:

  7. Potvrďte, že můžete přidat pracovní položku na panel úkolů. Otevřete stránku panelu úkolů nebo aktualizujte stránku, pokud už je otevřená.
    Jako propojenou pracovní položku s uživatelským scénářem byste měli být schopni vybrat úkol nebo úlohu služby.
    Panel úkolů s přidaným typem pracovní položky úkolu služby

    Na panelu úkolů přetáhněte pracovní položku a aktualizujte její stav. Všimněte si, že položku nemůžete přetáhnout do sloupce, pro který není stav platný. Úkol nemůžete například přetáhnout do zablokovaného stavu nebo úkol do vyřešeného stavu. Pokud chcete tyto stavy použít, přidejte je do definice pracovního postupu pro odpovídající definici pracovní položky.

Přidání wit do kategorie chyby

Informace o úpravách, které přidáte do kategorie chyb, se budou zpracovávat na základě nastavení týmu. Vzhledem k tomu, že tyto definice mohou být považovány za požadavky nebo úkoly, musí splňovat požadavky agilního plánování pro požadavky i úkoly.

  1. Exportujte proces (hostovaný XML) nebo definiční soubory (místní XML), jak je uvedeno v prvních krocích.

  2. Upravte definici WIT tak, aby podporovala nástroje plánování podle podmínek uvedených v kroku 2 přidání wit pro sledování požadavků a přidání wit pro sledování úkolů jako úkolů.

  3. Upravte definici kategorie. Přidejte wit do kategorie chyby. Tady přidáme dvě wity.

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

  4. Aktualizujte nebo ověřte definici ProcessConfiguration: BugWorkItems část pro definici wit, kterou přidáváte.

    Konkrétně se ujistěte, že jsou splněny následující podmínky:

    • Mapování začátku každého stavu pracovního postupu na type="Proposed"
    • Namapujte každý zprostředkující stav pracovního postupu, který se má zobrazit na panelu nebo na panelu úloh. type="InProgress"
    • Namapujte konec každého stavu pracovního postupu na type="Complete"
    • Ujistěte se, že máte namapovaný jenom jeden stát. type="Complete"

    Přidejte například Investigate stav pracovního postupu:

    <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. Do části ProcessConfiguration WorkItemColors přidejte definici barvy WIT. Příklad:

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

  6. Aktualizujte projekt:

  7. Zvolte nastavení týmu pro sledování chyb.

  8. Ověřte, že se wit zobrazuje v backlogech a panelech podle očekávání a že ho můžete přidat prostřednictvím backlogů podle očekávání.

Import a export definičních souborů (místní XML)

K importu a exportu definičních souborů použijte příkazy witadmin . Podrobnosti najdete v tématu witAdmin: Přizpůsobení a správa objektů pro sledování práce.

Tip

Pomocí witadminu můžete importovat a exportovat definiční soubory. Mezi další nástroje, které můžete použít, patří Editor procesů (vyžaduje, abyste nainstalovali verzi sady Visual Studio). Nainstalujte editor šablon procesů ze sady Visual Studio Marketplace.

  1. Otevřete okno příkazového řádku podle pokynů uvedených v nástroji witAdmin: Přizpůsobte a spravujte objekty pro sledování práce. Příklad:

  1. witadmin Zadejte příkaz a nahraďte data zobrazenými argumenty. Pokud chcete například importovat WIT:

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

    Pro CollectionURL zadejte adresu URL kolekce projektu a pro ProjectName zadejte název projektu definovaný v rámci kolekce. Adresu URL musíte zadat v následujícím formátu: http://ServerName:Port/VirtualDirectoryName/CollectionName.

    Pro DirectoryPath zadejte cestu ke WorkItem Tracking/TypeDefinitions složce, která obsahuje šablonu procesu, kterou jste stáhli. Cesta k adresáři musí mít tuto strukturu: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.

    Naimportujte například wit aplikace ServiceApp:

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

Pomocí těchto příkazů můžete exportovat a importovat wity, kategorie a konfiguraci procesů:

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"

Právě jsme si ukázali, jak přidat další wit do backlogů nebo panelů. Pokud ale chcete přidat další wit, který bude fungovat jako backlog portfolia, přečtěte si téma Přidání backlogů portfolia.

Přehled všech dostupných možností pro přizpůsobení objektů sledování práce najdete v tématu Přizpůsobení prostředí pro sledování práce.

Pokud chcete zjistit, jak se v backlogu nebo panelu zobrazují hierarchické nebo vnořené prvky, přečtěte si, jak backlogy a panely zobrazují hierarchické (vnořené) položky.