Dodawanie lub modyfikowanie typu elementu roboczego

  • Artykuł

Azure DevOps Server 2022 — Azure DevOps Server 2019

Projekt zawiera wiele typów elementów roboczych na podstawie procesu użytego do utworzenia projektu, takiego jak Agile, Basic, Scrum lub CMMI. Typ elementu roboczego to obiekt używany do śledzenia różnych typów pracy.

Uwaga

W przypadku usług Azure DevOps Services lub kolekcji projektów korzystających z modelu procesu dziedziczonego zobacz Dodawanie typów elementów roboczych i zarządzanie nimi.

Możesz zmodyfikować istniejący typ elementu roboczego lub dodać niestandardowy typ elementu roboczego na podstawie wymagań śledzenia zespołu lub procesów przepływu pracy. Najczęstszymi przyczynami modyfikowania typu elementu roboczego jest dodanie lub zmodyfikowanie zestawu pól lub reguł pól, zmiana przepływu pracy lub dostosowanie formularza elementu roboczego.

Zobacz Dodawanie lub modyfikowanie pola, jeśli chcesz dodać pole niestandardowe lub zmodyfikować reguły pól lub atrybuty istniejącego pola.

Większość dostosowań typu elementu roboczego jest wprowadzana w definicji XML typu elementu roboczego, jednak inne dostosowania są dokonywane za pomocą definicji konfiguracji procesu lub za pomocą narzędzia wiersza polecenia witadmin .

Uwaga

W przypadku usług Azure DevOps Services lub kolekcji korzystających z modelu procesu dziedziczonego zobacz Dodawanie typów elementów roboczych i zarządzanie nimi.

Definicja typu elementu roboczego

Definicja konfiguracji procesu

Zmiana wiersza polecenia

Wymagania wstępne

  • Aby wyświetlić listę typów elementów roboczych, musisz mieć uprawnienie Wyświetl informacje na poziomie projektu dla projektu w kolekcji ustawione na wartość Zezwalaj.
  • Aby dodać lub dostosować typ elementu roboczego przez dostosowanie szablonu procesu, musisz być członkiem grupy kolekcji projektów Administracja istratorów lub mieć uprawnienie Edytuj proces na Wartość Zezwalaj.

Aby dodać go jako administratora, zobacz Zmienianie uprawnień na poziomie kolekcji projektów.

Jak modyfikacje typów elementów roboczych wpływają na istniejące elementy robocze?

Poniższa tabela zawiera podsumowanie wpływu na istniejące elementy robocze podczas modyfikowania pól lub definicji typu elementu roboczego.

Akcja Wpływ na istniejące elementy robocze
Usuwanie pól z typu elementu roboczego Dane dla usuniętych pól pozostają w magazynie danych. Nie można jednak dodać żadnych nowych danych, ponieważ zostały usunięte z definicji typu elementu roboczego.
Zmienianie nazwy pola Dane dla zmienionych pól pozostają w magazynie danych pod nową przyjazną nazwą.
Usuwanie pól Dane usuniętych pól są usuwane z magazynu danych.
Zmienianie nazwy typu elementu roboczego Wszystkie dane pozostają nienaruszone pod nową nazwą.
Usuwanie typu elementu roboczego Wszystkie dane elementów roboczych utworzonych jako usunięty typ elementu roboczego są trwale usuwane bez szans na odzyskanie.

Jeśli chcesz całkowicie usunąć pola z magazynu danych, użyj witadmin deletefield narzędzia wiersza polecenia.

Importowanie i eksportowanie plików definicji typu elementu roboczego

Uwaga

Jeśli używasz modelu procesów Hostowany kod XML, musisz zaimportować i wyeksportować szablon procesu używany przez projekt. Aby uzyskać szczegółowe informacje, zobacz Dostosowywanie formularza internetowego śledzenia elementów roboczych.

  1. Jeśli nie masz uprawnień administracyjnych dla projektu, pobierz je.

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

  2. Wyeksportuj plik definicji typu elementu roboczego, w którym chcesz zmodyfikować lub dodać pole. Określ nazwę typu elementu roboczego i nazwę pliku.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Przykładem kolekcjiURL jest http://MyServer:8080/tfs/TeamProjectCollectionName.

  3. Edytuj plik . Aby uzyskać szczegółowe informacje, zobacz Indeksowanie do definicji elementów XML.

  4. Zaimportuj plik definicji.

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

  5. Otwórz portal internetowy lub odśwież stronę, aby wyświetlić zmiany.

    Aby uzyskać więcej informacji na temat używania programu witadmin, zobacz Importowanie, eksportowanie i zarządzanie typami elementów roboczych.

Dodawanie lub modyfikowanie typu elementu roboczego

Aby dodać niestandardowy typ elementu roboczego lub zmodyfikować istniejący typ elementu roboczego, zdefiniujesz lub zmodyfikujesz plik definicji XML, a następnie zaimportujesz go do projektu na podstawie używanego modelu procesu. Typ elementu roboczego można zmodyfikować, określając elementy zdefiniowane w trzech głównych sekcjach pliku definicji: FIELDS, WORKFLOW i FORM.

Podsumowanie elementów typu elementu roboczego

Najprostszym sposobem dodania nowego typu elementu roboczego jest skopiowanie istniejącego typu elementu roboczego, a następnie zmodyfikowanie pliku definicji.

Dodawanie lub modyfikowanie pola, reguły pola, etykiety lub pustego tekstu

Każde pole, którego chcesz użyć do śledzenia danych, musi zostać dodane do pliku definicji. Dotyczy to wszystkich pól systemowych (pól, których nazwa odwołania zaczyna się od system.). Wszystkie pola systemowe są definiowane dla wszystkich typów elementów roboczych, niezależnie od tego, czy są one uwzględniane w definicji typu elementu roboczego. Aby dowiedzieć się więcej o każdym polu, zobacz Indeks pól elementu roboczego.

Do sekcji FIELDS dodasz pola i reguły pól. Aby pole było wyświetlane w formularzu elementu roboczego, należy go również dodać do sekcji FORM definicji.

Aby na przykład dodać identyfikator elementu roboczego do formularza, określ następującą składnię XML w FORM sekcji .

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Aby dowiedzieć się więcej na temat definiowania pól, zobacz Dodawanie lub modyfikowanie pola.

Modyfikowanie przepływu pracy

Sekcje STANY i POWODY w przepływie pracy określają wartości listy wyboru w polach Stan i Przyczyna. Śledzą stan elementów roboczych. Sekcja TRANSITIONS określa prawidłowe przejścia między stanami, jak pokazano na poniższej ilustracji. Należy określić przejścia zarówno do przodu, jak i regresji.

Przykładowy diagram stanu przepływu pracy, historia użytkownika Agile

Zmienisz przepływ pracy, aby osiągnąć następujące cele:

  • Dodawanie lub usuwanie stanu, przyczyny lub przejścia
  • Określ wartość pola, która ma zostać zastosowana podczas zmiany stanu, przyczyny lub przejścia
  • Określ niestandardową akcję , aby zautomatyzować przypisania pól na podstawie zmiany stanu, przyczyny lub przejścia.

Podczas dostosowywania przepływu pracy wykonaj następujące dwa kroki:

  1. Zmodyfikuj przepływ pracy definicji typu elementu roboczego.

  2. Zmodyfikuj konfigurację procesu, aby zamapować nowe stany przepływu pracy na metastany.

    Ten drugi krok jest wymagany w przypadku zmiany przepływu pracy dla typu elementu roboczego wyświetlanego na stronie narzędzia Agile. Te typy elementów roboczych należą do kategorii Wymaganie lub Zadanie.

Reguły pól przepływu pracy

Reguły pól można stosować podczas zmieniania stanu, określania przyczyny lub przejścia przepływu pracy.

Na przykład dodając regułę EMPTY , gdy stan jest ustawiony na Aktywny, możesz automatycznie unieważnić pola Data zamknięta i Zamknięte według i ustawić je jako tylko do odczytu. Jest to przydatne podczas ponownego aktywowania elementu roboczego ze stanu zamkniętego.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>

Zastosuj reguły pól przepływu pracy, aby wykonać następujące akcje:

  • Kwalifikowanie wartości, którą może mieć pole, określając wartość CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY i REQUIRED
  • Kopiowanie wartości do pola przy użyciu polecenia COPY, DEFAULT i SERVERDEFAULT
  • Ogranicz, kto może modyfikować pole
  • Wymuszanie dopasowywania wzorca w polu ciągu przy użyciu funkcji MATCH
  • Warunkowe stosowanie reguł na podstawie wartości w innych polach przy użyciu funkcji WHEN, WHENNOT, WHENCHANGED i WHENNOTCHANGED
  • Ogranicz reguły dotyczące stosowania do określonych użytkowników lub grup. Większość reguł obsługuje atrybuty , aby skoncentrować się na tym, kto robi regułę i do których nie ma zastosowania.

Aby uzyskać więcej informacji na temat stosowania reguł pól przepływu pracy, zobacz dokumentacja elementów FIELD (Workflow) oraz Reguły i ocena reguł.

Dostosowywanie formularza elementu roboczego

Na poniższych ilustracjach przedstawiono najczęstsze elementy formularzy elementów roboczych. Można dostosować wszystkie z nich z wyjątkiem obszaru tytułu i kontrolek formularza. Elementy używane do dostosowywania formularza zależą od tego, czy nowy formularz został włączony przez administratora.

Zrzut ekranu przedstawiający element nagłówka w formularzu internetowym elementu roboczego.

Formularz można dostosować, aby osiągnąć następujące cele:

Dodawanie lub usuwanie typu elementu roboczego z listy prac lub tablicy zadań

Narzędzia do planowania Agile — lista prac produktu, lista prac przebiegu i strony tablicy zadań — wyświetlają określone typy elementów roboczych na podstawie szablonu procesu użytego do utworzenia projektu. Na tych stronach można dodawać lub usuwać typy elementów roboczych. Jeśli na przykład projekt używa typów elementów roboczych Scrum, zarówno elementy listy prac produktu, jak i usterki są wyświetlane na stronach listy prac. Jeśli jednak projekt został utworzony przy użyciu szablonu Agile, CMMI lub innego szablonu procesu, usterki nie są wyświetlane na liście prac ani tablicy zadań.

Możesz na przykład dodać usterki ze strony listy prac produktu.

Aby dowiedzieć się, jak dodawać lub usuwać typy elementów roboczych z listy prac lub tablicy zadań, zobacz Dodawanie typu elementu roboczego do listy prac i tablicy. Aby dodać nowy typ elementu roboczego do obsługi listy prac portfela, zobacz Dodawanie poziomu listy prac portfela.

Zmienianie koloru, ikony lub koloru stanu przepływu pracy typu elementu roboczego

W portalu internetowym elementy robocze są wyświetlane w wynikach zapytania oraz na stronach listy prac i tablicy narzędzi Agile. Aby zmienić kolor lub ikonę skojarzona z istniejącym typem elementu roboczego lub dodać kolor do użycia dla nowego typu elementu roboczego, edytuj konfigurację procesu. Aby zmienić kolor stanu przepływu pracy, należy również edytować konfigurację procesu.

Zrzut ekranu przedstawiający wyniki zapytania z kolorem, ikoną i kolorem stanu elementu roboczego.

Zmienianie typu istniejącego elementu roboczego

Zobacz Zbiorcze przenoszenie elementów roboczych i zmienianie typu elementu roboczego dla funkcji dostępnych na podstawie platformy.

Dezaktywowanie lub wyłączanie typu elementu roboczego

Jeśli chcesz ograniczyć tworzenie określonego typu elementu roboczego do grupy użytkowników, dodaj typ elementu roboczego do grupy Ukryte kategorie, aby zapobiec tworzeniu ich przez większość współautorów. Jeśli chcesz zezwolić grupie użytkowników na dostęp, możesz utworzyć hiperlink do szablonu , który otwiera formularz elementu roboczego i udostępnia ten link tym członkom zespołu, którzy chcesz je utworzyć.

Uwaga

Nie można dodać reguł pól, aby ograniczyć przepływ pracy, ponieważ nie można stosować reguł do pól systemowych.

Usuwanie typu elementu roboczego

Aby uniemożliwić członkom zespołu używanie określonego typu elementu roboczego w celu utworzenia elementu roboczego, możesz usunąć go z projektu. Gdy używasz metody witadmin destroywitd*, trwale usuniesz wszystkie elementy robocze, które zostały utworzone przy użyciu tego typu elementu roboczego, a także sam typ elementu roboczego. Jeśli na przykład zespół nie używa "Impediment", możesz usunąć typ elementu roboczego z etykietą "Impediment" z projektu witryny sieci Web firmy Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Po usunięciu typu elementu roboczego należącego do kategorii należy zaktualizować definicję kategorii projektu, aby odzwierciedlić nową nazwę. Aby uzyskać więcej informacji, zobacz Importowanie, eksportowanie i zarządzanie typami elementów roboczych oraz Importowanie i eksportowanie kategorii.

Zmienianie nazwy typu elementu roboczego

Aby zmienić nazwę istniejącego typu elementu roboczego, użyj polecenia witadmin renamewitd. Możesz na przykład zmienić nazwę typu elementu roboczego z etykietą "Element QoS" na "Umowa serwisowa".

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

Po zmianie nazwy typu elementu roboczego należącego do kategorii należy zaktualizować definicję kategorii projektu, aby odzwierciedlić nową nazwę. W szczególności listy prac i tablice nie będą działać, dopóki nie zaktualizujesz definicji kategorii.

Aby uzyskać więcej informacji, zobacz Importowanie, eksportowanie i zarządzanie typami elementów roboczych oraz Importowanie i eksportowanie kategorii.

W tym artykule opisano sposób dodawania i dostosowywania typów elementów roboczych dla hostowanych modeli procesów XML i lokalnych xml. Aby uzyskać informacje na temat dodawania i dostosowywania typów elementów roboczych dla modelu procesów dziedziczonego, zobacz Dostosowywanie procesu.

Inne powiązane tematy lub zasoby: