Modyfikowanie lub dodawanie dostosowanego typu elementu pracy

Artykuł
09/13/2015

Będąc administratorem projektu, możesz zechcieć zmodyfikować istniejący typ elementu roboczego (WIT) w celu obsługi dodatkowych wymogów śledzenia lub procesów przepływu pracy. Najbardziej typowe przyczyny modyfikowania WIT to dodawanie lub modyfikowanie zestawu pól lub reguł pól, zmiana przepływu pracy lub dostosowywanie formularza elementu roboczego. Te trzy powody korespondują z trzema głównymi sekcjami pliku definicji XLM WIT: FIELDS, WORKFLOW i FORM.

Wszystkie te zmiany wymagają do edycji definicji WIT, co można zrobić tylko dla lokalnych wdrożeń TFS. Ten temat zawiera omówienie tego, co można dostosować i wskaźniki do zawartości, która pokazuje w jaki sposób to zrobić.

Work item types, customize

Dodaj lub zmodyfikuj pole, regułę pola, etykietę lub pusty tekst

Dodawanie pól i reguł pól do sekcji FIELDS. Aby pole pojawiło się w formularzu elementu roboczego, należy także dodać go do sekcji FORM definicji WIT.

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

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

Aby dowiedzieć się więcej o definiowaniu pól, zobacz Dodawanie lub modyfikowanie pola do obsługi kwerend, raportów i przepływu pracy.

Zmień stany przepływu pracy, przyczyny, przejścia albo dodaj reguły przepływu pracy pola

STATES i REASONS sekcje w ramach WORKFLOW należy określić wartości listy pobrania w polach Stan i Przyczyny. Śledzą one 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ć zarówno przejścia do przodu, jak i do tyłu.

Przykładowy diagram stanów przepływu pracy

User Story workflow states, Agile process template

Zmienianie przepływu pracy, aby osiągnąć następujące cele:

Dodawanie lub usuwanie stanu, przyczyny lub przejścia.
Określanie wartości dla pola, które mają być stosowane podczas zmiany stanu, powodu lub przejścia...
Określ akcję niestandardową ACTION do zautomatyzowania przydziałów pola na podstawie zmiany stanu, przyczyny lub przejścia.

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

Modyfikuj PRZEPŁYW PRACY w definicji WIT.
Modyfikuj konfigurację procesu w celu mapowania nowych stanów przepływu pracy do metastanów.

Ten drugi krok jest wymagany w następujących okolicznościach:
- Po zmianie przepływu pracy dla WIT, pojawiający się na stronie narzędzia planowania spojrzenia. Te możliwości WIT należą do kategorii wymogu lub zadania. Aby uzyskać więcej informacji dotyczących konfigurowania tych narzędzi, zobacz Konfigurowanie i dostosowywanie narzędzi planowania Agile do projektu zespołowego.
- Kiedy zmieniasz przepływu pracy dla planu badań lub pakietu testów i możesz pracować na kliencie Test Menedżera wyposażone w 2013.2 programu Visual Studio lub wcześniejszych wersji. Możliwości te stały się dostępne podczas aktualizacji serwera warstwie aplikacji do TFS 2013.3. który jest wyświetlany na stronie narzędzia planowania spojrzenia.
  
  Jeśli napotkasz aplikacji wykryto nieoczekiwany błąd błąd podczas łączenia się z zespołu projektu po zmianie przepływu pracy, można rozwiązać, mapując nowe stany przepływu pracy do metastates. Aby rozwiązać ten problem, zobacz Importowanie i eksportowanie konfiguracji procesów [witadmin].

Reguły pól przepływu pracy

Reguły pól można zastosować tylko podczas zmiany stanu, określania przyczyny lub przejścia w przepływie pracy.

Na przykład poprzez dodanie reguły EMPTY, gdy stan jest ustawiony na Aktywny, można automatycznie ustawiać na wartość null pola Data zamknięcia i Zamknięte do oraz sprawić, że będą one tylko do odczytu. Jest to przydatne w przypadku uaktywniania 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 do wykonywania następujących czynności:

Wartość pola można kwalifikować przez określenie CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY i REQUIRED.
Kopiowanie wartości do pola za pomocą atrybutów COPY, DEFAULT i SERVERDEFAULT.
Ogranicz liczbę osób, które mogą modyfikować pole.
Wymuszanie dopasowania do wzorca w polu ciągu znaków za pomocą atrybutu MATCH.
Warunkowe zastosowanie reguł na podstawie wartości w pozostałych polach za pomocą atrybutów WHEN, WHENNOT, WHENCHANGED i WHENNOTCHANGED.
Ogranicz zasady mające zastosowanie do określonych użytkowników lub grup. Większość reguł obsługuje atrybuty for lub not w celu podkreślenia, która reguła ma zastosowanie, a która nie.

Aby uzyskać więcej informacji dotyczących stosowania reguł dotyczących pól przepływu pracy, zobacz Dokumentacja elementu FIELD (Workflow).

Dostosuj formularz elementu roboczego

Następująca ilustracja wyróżnia najbardziej typowe elementy na formularzach elementów roboczych. Można dostosować je wszystkie z wyjątkiem obszaru tytułu i formantów formularza.

Work item form elements and controls

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

Dodawanie lub usuwanie pola, zmiana etykiety pola lub zmiana położenia pola w formularzu. Aby uzyskać więcej informacji, zobacz Określanie sterowania formularzem elementu pracy.
Dodaj nowe karty lub kolumny lub przenieś grupy pól z jednej karty na drugą. Zobacz Projektowanie formularza elementu roboczego.
Dodawanie tekstu informacyjnego do obsługi wypełniania formularza, hiperłączy do szczegółowych wskazówek dotyczących procesów, osadzania tekstu w formacie HTML lub wyświetlania dynamicznych raportów w formularzu. Zobacz Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.
Określ karty, które ograniczają typy łączy, lub WIT, które mogą być połączone z elementem roboczym. Zobacz Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi.
Dodawanie formantu załącznika do obsługi dołączania plików. Zobacz Dodawanie funkcji kontroli załączników.

Edytowanie definicji typu elementu roboczego

Aby edytować definicję WIT, należy wyeksportować, zmodyfikować i następnie zaimportować plik definicji WIT.

Process for customizing a WIT object

Z witadmin można importować i eksportować pliki definicji. Other tools you can use to modify the XML syntax for an object include the Process Editor, available with the download of TFS Power Tools, or TFS Team Project Manager, a community resource project available on CodePlex.

Jeśli nie masz uprawnień administracyjnych dla projektu zespołowego, uzyskaj je.
Otwórz okno wiersza polecenia, w którym jest zainstalowany program Visual Studio lub Team Explorer, i wprowadź:
```
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
```
W 64-bitowej wersji systemu Windows należy zastąpić % programfiles % elementem % programfiles(x86) %. Przejdź tutaj, aby pobrać Eksplorator zespołów za darmo.
Wyeksportuj plik definicji typu elementu roboczego, w którym chcesz zmodyfikować lub dodać pole. Określ nazwę WIT i nazwę pliku.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"
```
Przykład CollectionURL TeamProjectCollectionName-http://MyServer:8080/tfs jest.
Edytuj plik. Szczegółowe informacje – zobacz: Śledzenie elementu pracy: Indeks do definicji elementów XML.

Zaimportuj plik definicji typu elementu roboczego.

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

Otwórz TWA lub Team Explorer, aby wyświetlić zmiany. Jeśli klient jest już otwarty, należy odświeżyć stronę.

W Team Explorer wybierz przycisk Odśwież.

Najnowsze aktualizacje są pobrane z serwera, łącznie ze zmianami, które właśnie pobrałeś. Odczekaj kilka sekund, aby zakończyć odświeżanie.

Aby uzyskać więcej informacji na temat używania witadmin, zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin].

Pytania i odpowiedzi

P: Jak pracować ze znacznikami

Odp.: Aby dowiedzieć się, jak dodawać znaczniki i filtrować listy, przejdź tu.

P: co dostosowań I zrobić i nadal korzystać z Kreatora konfigurowania funkcji zaktualizować mojego zespołu projektu po uaktualnieniu TFS?

A: można dodać niestandardowe możliwości i zmienić układ formularza. Kreatora konfigurowania funkcji będzie aktualizowanie projektów zespołu i uzyskasz dostęp do najnowszych funkcji.

Zmienianie przepływu pracy lub zmiana nazwy WIT może wymagać do wykonywania niektórych operacji ręcznego podczas aktualizowania projektu zespołu. Aby dowiedzieć się o innych dostosowań, że można bezpiecznie zrobić, które należy unikać, zobacz dostosować pracy śledzenia doświadczenie: zanim zostaną dostosowane, zrozumienie wpływu konserwacji i uaktualnienia.

P: Jak mam dodać nowy WIT?

Odp.: Najprostszym sposobem dodania nowego WIT jest skopiowanie istniejącego WIT i zmodyfikowanie pliku definicji. Aby zapoznać się z przykładem, zobacz Tworzenie typu elementu roboczego.

P: Czy można zmienić nazwę WIT?

Odp. Tak. Aby zmienić nazwę istniejącego WIT, użyj polecenia witadmin renamewitd. Na przykład można zmienić nazwę typu elementu roboczego z „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 WIT, który należy do kategorii, musisz zaktualizować definicję kategorii dla projektu zespołowego, aby odzwierciedlały nową nazwę. W szczególności narzędzia planowania Agile nie będą działać, dopóki nie zaktualizujesz definicji kategorii.

Aby uzyskać więcej informacji, zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin] i Importowanie i eksportowanie kategorii [witadmin].

P: Jak dezaktywować lub wyłączyć WIT?Jak ograniczać użytkownikom tworzenie elementów roboczych określonego typu?

Odp.: Jeśli masz typ elementu roboczego, który ma zostać wycofany, ale utrzymujesz elementy robocze, które zostały utworzone na podstawie tego typu, można dodać regułę, która wyłącza wszystkim prawidłowym użytkownikom możliwość zapisywania typu elementu roboczego.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Jeśli chcesz ograniczyć tworzenie szczególnych WIT do grupy użytkowników, istnieją dwa sposoby ograniczania dostępu:

Dodaj typ elementów roboczych do grupy kategorii ukrytych, aby uniemożliwić większości współautorów tworzenie ich. Jeśli chcesz zezwolić na dostęp grupie użytkowników, możesz utworzyć hiperłącze do szablonu, które otwiera formularz elementu roboczego i dzielić się tym łączem z członkami zespołu, którzy mają je tworzyć.
Dodaj reguły pola do przepływu pracy dla pola System.CreatedBy, aby w praktyce uniemożliwić grupie użytkowników tworzenie elementu roboczego określonego typu. Jak pokazano na poniższym przykładzie, użytkownik tworzący element roboczy musi należeć do Allowed Group, aby zapisać element roboczy.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

P: Jak mam usunąć nowy WIT?

Odp.: Aby uniemożliwić członkom zespołu tworzenie elementu roboczego przy użyciu określonego WIT, można usunąć go z projektu zespołowego. Użycie witadmin destroywitd powoduje trwałe usunięcie wszystkich elementów roboczych, które zostały utworzone przy użyciu tego WIT, jak również samego WIT. Na przykład jeżeli zespół nie używa "Przeszkoda", można usunąć WIT z etykietą "Przeszkoda" z projektu witryny sieci Web firmy Fabrikam.

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

Po usunięciu WIT, który należy do kategorii, musisz zaktualizować definicję kategorii dla projektu zespołowego, aby odzwierciedlały nową nazwę. W szczególności narzędzia planowania Agile nie będą działać, dopóki nie zaktualizujesz definicji kategorii.

Aby uzyskać więcej informacji, zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin] i Importowanie i eksportowanie kategorii [witadmin].

P: Czy można zmienić kolor skojarzony z WIT?

Odp. Tak. W programie Team Web Access elementy robocze pojawiają się w wynikach kwerendy na stronach zaległości i tablicy w narzędziach planowania Agile. Aby zmienić kolor skojarzony z istniejącym WIT lub dodać kolor do używania z nowym WIT, edytuj konfigurację procesu.

Color assignments to different work item types

P: Czy można dodawać lub usuwać WIT z zaległości lub z tablicy zadań?

Odp. Tak. Narzędzia planowania Agile — dziennik zaległości produktu, dziennik zaległości sprint i strony tablicy zadań — wyświetlają specyficzne WIT na podstawie szablonu procesu używanego do tworzenia projektu zespołowego. Możesz dodać lub usunąć możliwość wyświetlania elementów WIT na tych stronach. Na przykład jeśli projekt zespołowy korzysta z typów elementów roboczych w scrumie, zarówno elementy zaległości produktu, jak i błędy pojawiają się na stronach zaległości. Jednakże jeśli projekt zespołowy został utworzony za pomocą projektowania zwinnego, metody CMMI lub innego szablonu procesu, błędy nie pojawiają się w dzienniku zaległości ani na tablicy zadań.

Na przykład można dodać usterki ze strony zaległości produktów.

Updated panel with bug work item type added

Aby dowiedzieć się, jak dodać lub usunąć WIT z tablicy zaległości lub zadań, przejdź tutaj. Aby dodać nowy WIT do obsługi zaległości portfolio, przejdź tu.

P: Jak modyfikowanie WIT wpływa na istniejące elementy robocze?

Odp.: W poniższej tabeli zestawiono wpływ modyfikowania pola lub definicji WIT na istniejące elementy robocze.

Akcja	Wpływ na istniejące elementy robocze
Usuń pola z WIT	Dane dla usuniętych pól pozostają w magazynie danych. Jednakże żadne nowe dane nie mogą być dodawane, ponieważ zostały one usunięte z definicji WIT.
Zmień nazwę pola	W magazynie danych pod nową przyjazną nazwą pozostają dane dla pól, których nazwy zostały zmienione.
Usuń pola	Dane usuniętych pól są usuwane z magazynu danych.
Zmień nazwę WIT	Wszystkie dane pozostaną niezmienione pod nową nazwą.
Usuń WIT	Wszystkie dane dla elementów roboczych utworzonych jako usunięty WIT są usuwane na stałe bez możliwości odzyskiwania.

Jeśli chcesz całkowicie usunąć pola z magazynu danych, użyj witadmin deletefield narzędzia wiersza polecenia. Zobacz Zarządzanie polami elementów pracy [witadmin].

P: Jak zmienić typ istniejącego elementu roboczego?

Odp.: Nie można zmienić typu istniejącego elementu roboczego, ale można skopiować element roboczy i określić nowy typ. Na przykład można skopiować istniejący element zaległości produktu i zmienić typ na usterkę, jak pokazano na poniższej ilustracji.

Copy a work item and specify a new type

Ponadto jeśli masz kilka elementów roboczych, których typy chcesz zmienić, warto wyeksportować je za pomocą programu Excel, a następnie ponownie dodać je jako nowe typy.

P: Czy można usunąć elementy robocze z TFS?

Odp. Tak. Polecenie witadmin destroywi trwale usuwa elementy robocze z bazy danych.

P: Co należy wiedzieć o dostosowaniu WIT i uaktualnieniach TFS?

Odp.: Zobacz sekcję Konfigurowanie funkcji po uaktualnieniu TFS.

P: Do kogo mogę się zwrócić, aby uzyskać dodatkowe informacje?

A: To find answers or post a question, visit the forum: Team Foundation Server - Project Management & Work Item.

Aby uzyskać więcej informacji, zobacz Określanie sterowania formularzem elementu pracy.

Edytor procesów, dostępne z pobierania TFS Power Tools, aby zmodyfikować przepływu pracy, lub aby wyświetlić diagram stanu przepływu pracy.

Udostępnij za pośrednictwem