Dodaj typ elementu roboczego do backlogu i tablicy

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Ważne

Ten artykuł dotyczy dostosowywania projektu dla hostowanych modeli procesów XML i lokalnych plików XML. Aby zapoznać się z modelem procesu dziedziczenia, zobacz Dostosowywanie list prac lub tablic na potrzeby procesu. Aby zapoznać się z przeglądem modeli procesów, zobacz Dostosuj swoje doświadczenie śledzenia pracy.

Aby spełnić wymagania dotyczące wybranych procesów biznesowych, zespół może chcieć śledzić dodatkowe typy elementów roboczych (WIT) jako wymagania lub zadania podrzędne. W ten sposób można je dodać i śledzić w ramach listy prac produktu oraz listy prac przebiegu lub tablicy i tablicy zadań.

Możesz na przykład śledzić różne typy wymagań na podstawie ich docelowego klienta lub różnych typów usterek na podstawie ich źródła. W tym miejscu zespół firmy Fabrikam Fiber dodał do swojej aplikacji Service App WIT, aby śledzić prace wspierające zespół obsługi klienta.

Napiwek

Jeśli chcesz jedynie dodawać usterki do list prac i tablic, zobacz Pokaż usterki na listach prac i tablicach, aby dokonać wyboru dla zespołu. Jeśli chcesz dodać kolejną listę prac WIT i portfolio, zobacz Dodawanie poziomu listy prac portfela.

Aby dodać WIT do śledzenia jako wymagania, zadania lub usterki, przeprowadź odpowiednie kroki:

• Dodaj WIT jako wymagania
• Dodaj WIT do śledzenia jako zadania
• Dodaj WIT do kategorii usterek

Uwaga

Zalecamy dodanie funkcji WIT do jednej i tylko jednej z następujących kategorii: Kategoria wymagań, Kategoria zadań lub Kategoria błędów. System uniemożliwia dodanie tego samego WIT do kategorii wymagań oraz do kategorii zadań. Typy elementów pracy (WIT) dodawane do kategorii błędu będą zgodne z zestawem zachowań dla błędów zespołu.

Sekwencja dostosowywania

Sekwencja dostosowywania hostowanego modelu procesów XML

Uwaga

Skorzystaj z poniższych wskazówek, jeśli dostosujesz proces za pomocą importowania/eksportowania plików definicji. W przeciwnym razie, jeśli dostosujesz proces za pomocą interfejsu użytkownika administratora, zobacz Dodawanie lub modyfikowanie niestandardowego typu elementu roboczego dla procesu.

Wprowadzisz zmiany w plikach definicji procesu, a następnie zaimportujesz ten proces, aby zaktualizować istniejące projekty lub użyć procesu do utworzenia projektu.

• Jeśli nie jesteś właścicielem organizacji ani członkiem grupy administratora kolekcji projektów, poproś o dodanie.
• Eksportowanie procesu, który chcesz zaktualizować
• Jeśli dopiero zaczynasz dostosowywać proces, przeczytaj Dostosowywanie procesu importowania.

Lokalna sekwencja dostosowywania modelu procesu XML

Najpierw wyeksportujesz pliki definicji śledzenia pracy, zaktualizujesz je, a następnie zaimportujesz je do projektu.

• Jeśli nie jesteś członkiem grupy Administrator projektu lub Administrator kolekcji projektów, zostań dodany.
• Aktualizowanie projektu w celu włączenia najnowszych funkcji
• Wyeksportuj następujące obiekty z projektu:
  • Funkcja WIT, którą chcesz dodać do list prac i tablic (jeśli nie została utworzona, zrób to teraz)
  • Konfiguracja procesu
• Jeśli dopiero zaczynasz dostosowywać obiekty śledzenia pracy, zapoznaj się z następującymi zasobami:
  • Dodawanie lub modyfikowanie pola
  • Dodawanie lub modyfikowanie typu elementu roboczego
  • Odwołanie do XML ProcessConfiguration.

Dodaj element WIT, aby śledzić go jak wymaganie

WITy, które dodasz do Kategorii Wymagań, pojawiają się na backlogu produktu i tablicy. Musisz upewnić się, że definicja funkcji WIT zawiera wymagane pola do obsługi narzędzi do planowania Agile.

1. Wyeksportuj proces (hostowany kod XML) lub pliki definicji (lokalny kod XML) zgodnie z instrukcjami w sekcji Pierwsze kroki.

2. Edytuj definicję funkcji WIT, aby obsługiwać narzędzia do planowania.

   Dostosuj składnię, aby dodać lub zaktualizować

   Pole Ranga stosu (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 Priorytet Zaległości (Scrum)

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

   Pole Obszaru Wartości

   <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 Wymagania (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 Zaktualizuj lub zweryfikuj sekcję w WORKFLOW następujący sposób:

   • Agile, User Story: Dodaj przejścia z Active do Removed i z Resolved do Removed; usuń reguły, które wypełniają pola Activated By i Activated Date, gdy stan=Resolved
   • Scrum, element backlogu produktu: Dodaj przejście z Committed do Removed
     Jeśli dostosowałeś element , upewnij się, że wymagane mapowania stanu na metastan są zdefiniowane w sekcji ProcessConfiguration.

   FORM sekcja Dodaj lub sprawdź, czy następujące pola zostały dodane do FORM sekcji:

   • Agile:

   <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. Edytuj definicję Kategorii. Dodaj element WIT do kategorii Wymaganie. W tym miejscu dodajemy aplikację serwisową.

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

4. Zaktualizuj lub zweryfikuj definicję ProcessConfiguration: RequirementBacklog, sekcję dotyczącą dodawanego elementu WIT. W szczególności upewnij się, że spełnione są następujące warunki:

   • Mapuj początek każdego stanu przepływu pracy na type="Proposed"
   • Zamapuj każdy stan pośredniego przepływu pracy, który ma być wyświetlany na tablicy type="InProgress"
   • Mapuj koniec każdego stanu przepływu pracy na type="Complete"
   • Upewnij się, że masz tylko jeden stan zamapowany na type="Complete"
     Na przykład dodaj stan Oczekującego przepływu pracy:

   <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. Dodaj definicję koloru WIT do sekcji ProcessConfiguration WorkItemColors . Na przykład:

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

6. Zaktualizuj projekt:

   • Hostowany plik XML: zaimportuj proces.
   • Lokalny kod XML:Zaimportuj pliki definicji zaktualizowane w tej kolejności:
     a. WIT b. Kategorie
     c. Konfiguracja procesu

Dodaj WIT, aby go śledzić tak jak zadanie.

WITy, które dodajesz do kategorii zadań, są wyświetlane na rejestrach zadań sprintu i tablicach zadań. Element WIT, który dodajesz, musi określać wymagane pola, aby obsługiwać narzędzia metodyki Agile.

1. Wyeksportuj proces (hostowany kod XML) lub pliki definicji (lokalny kod XML) zgodnie z instrukcjami w sekcji Pierwsze kroki.

2. Edytuj definicję funkcji WIT, aby obsługiwać narzędzia do planowania.

   Dostosuj składnię do dodawania lub aktualizowania

   Pole Ranga stosu (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 priorytetu backlogu** (Scrum)

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

   Pole działania (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>    
   

   Pole dyscypliny (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>    
   

   Pozostałe pole Pracy (wszystkie)

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

   Dodatkowe pola planowania (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 sekcja
   Zaktualizuj lub zweryfikuj sekcję WORKFLOW w następujący sposób:

   • Agile, User Story: Dodaj przejścia z Active do Removed i z Resolved do Removed. Usuń reguły, które wypełniają pola Activated By i Activated Date gdy stan=Resolved.
   • Scrum, element listy prac produktu: Dodaj przejście z Committed do Removed
     Jeśli dostosowano element , upewnij się, że zdefiniowano wymagane mapowania stanu na metastan w sekcji ProcessConfiguration.

   FORM sekcja
   Dodaj lub sprawdź, czy następujące pola zostały dodane do FORM sekcji:

   • Agile:

   <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. Edytuj definicję Kategorii. Dodaj element WIT do kategorii Zadanie. W tym miejscu dodajemy zadanie usługi.

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

4. Zaktualizuj lub zweryfikuj definicję ProcessConfiguration: sekcja TaskBacklog dla WIT, który dodajesz.
   W szczególności upewnij się, że spełnione są następujące warunki:

   • Mapuj początek każdego stanu przepływu pracy na type="Proposed"
   • Zamapuj każdy pośredni stan przepływu pracy, który chcesz wyświetlić na tablicy zadań type="InProgress"
   • Mapuj koniec każdego stanu przepływu pracy na type="Complete"
   • Upewnij się, że masz tylko jeden stan zamapowany na type="Complete"

   Na przykład dodaj stan przepływu pracy 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>  
   

5. Dodaj definicję koloru WIT do sekcji ProcessConfiguration WorkItemColors . Na przykład:

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

6. Zaktualizuj projekt:

   • Hostowany plik XML: zaimportuj proces.
   • Lokalny kod XML:Zaimportuj pliki definicji zaktualizowane w tej kolejności:
     a. DOWCIP
     b. Kategorie
     c. Konfiguracja procesu

7. Upewnij się, że możesz dodać element WIT do tablicy zadań. Otwórz stronę tablicy zadań lub odśwież stronę, jeśli jest już otwarta.
   Powinno być możliwe wybranie zadania lub zadania usługi jako połączonego elementu roboczego z historyjką użytkownika.
   

   Na tablicy zadań przeciągnij element roboczy, aby zaktualizować jego stan. Zauważysz, że nie można przeciągnąć elementu do kolumny, dla której stan jest nieprawidłowy. Na przykład nie można przeciągnąć Zadania do stanu Zablokowane ani Zadania do stanu Rozwiązanego. Jeśli chcesz użyć tych stanów, dodaj je do definicji przepływu pracy dla odpowiadającej definicji WIT.

Dodaj WIT do kategorii błędów

WITs dodane do kategorii błędów będą traktowane zgodnie z ustawieniami zespołu. Ze względu na to, że te elementy robocze (WIT) mogą być traktowane jako wymagania lub zadania, muszą spełniać wymagania narzędzia Agile do planowania zarówno wymagań, jak i zadań.

1. Wyeksportuj proces (hostowany kod XML) lub pliki definicji (lokalny kod XML) zgodnie z instrukcjami w sekcji Pierwsze kroki.

2. Edytuj definicję funkcji WIT, aby obsługiwać narzędzia do planowania, spełniając warunki wymienione w kroku 2 sekcji Dodawanie funkcji WIT w celu śledzenia jako wymagań i Dodawanie funkcji WIT do śledzenia jako zadań.

3. Edytuj definicję Kategorii. Dodaj element WIT do kategorii usterek. W tym miejscu dodajemy dwa WITs.

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

4. Zaktualizuj lub zweryfikuj definicję processConfiguration: BugWorkItems sekcję dotyczącą dodawanego elementu WIT.

   W szczególności upewnij się, że spełnione są następujące warunki:

   • Mapuj początek każdego stanu przepływu pracy na type="Proposed"
   • Zamapuj każdy stan pośredniego przepływu pracy, który ma być wyświetlany na tablicy lub tablicy zadań type="InProgress"
   • Mapuj koniec każdego stanu przepływu pracy na type="Complete"
   • Upewnij się, że masz tylko jeden stan zamapowany na type="Complete"

   Na przykład dodaj Investigate stan przepływu pracy:

   <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. Dodaj definicję koloru WIT do sekcji ProcessConfiguration WorkItemColors . Na przykład:

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

6. Zaktualizuj projekt:

   • Hostowany plik XML: zaimportuj proces.
   • Lokalny kod XML:Zaimportuj pliki definicji zaktualizowane w tej kolejności:
     a. DOWCIP
     b. Kategorie
     c. Konfiguracja procesu

7. Wybierz ustawienie zespołu, aby określić sposób śledzenia usterek.

8. Upewnij się, że element WIT jest wyświetlany na rejestrach zadań i tablicach zgodnie z oczekiwaniami i że można go dodać poprzez rejestry zadań zgodnie z oczekiwaniami.

Importowanie i eksportowanie plików definicji (lokalny kod XML)

Użyj poleceń witadmin, aby zaimportować i wyeksportować pliki definicji. Aby uzyskać szczegółowe informacje, zobacz witAdmin: Dostosowywanie obiektów do śledzenia pracy i zarządzanie nimi.

Wskazówka

Za pomocą narzędzia witadmin można importować i eksportować pliki definicji. Inne narzędzia, których można użyć, obejmują Edytor procesów (wymaga zainstalowania wersji programu Visual Studio). Zainstaluj edytor szablonu procesu z witryny Visual Studio Marketplace.

1. Otwórz okno wiersza polecenia zgodnie z instrukcjami podanymi w witAdmin : Dostosowywanie obiektów do śledzenia pracy i zarządzanie nimi. Na przykład:

1. Wprowadź polecenie witadmin, zamieniając wyświetlane argumenty na swoje dane. Aby, na przykład, zaimportować WIT:

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

   W polu CollectionURL określ adres URL kolekcji projektu, a w polu ProjectName określ nazwę projektu zdefiniowanego w kolekcji. Adres URL należy określić w następującym formacie: http://ServerName:Port/VirtualDirectoryName/CollectionName.

   W polu DirectoryPath określ ścieżkę do WorkItem Tracking/TypeDefinitions folderu zawierającego pobrany szablon procesu. Ścieżka katalogu musi być zgodna z tą strukturą: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.

   Na przykład zaimportuj element ServiceApp WIT:

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

Użyj tych poleceń, aby wyeksportować i zaimportować WIT, kategorie i konfigurację procesów.

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"  

Powiązane artykuły

Pokazaliśmy już, jak dodać kolejny element WIT do backlogu lub tablic. Jeśli jednak chcesz dodać kolejny element WIT do działania jako listę prac portfela, zobacz Dodawanie list prac portfela.

Zobacz Dostosowywanie środowiska śledzenia pracy, aby zapoznać się z omówieniem wszystkich dostępnych opcji dostosowywania obiektów śledzenia pracy.

Aby dowiedzieć się, jak hierarchiczne lub zagnieżdżone elementy są wyświetlane na liście prac lub tablicy, zobacz Jak listy prac i tablice wyświetlają elementy hierarchiczne (zagnieżdżone).