Úprava nebo přidání vlastního typu pracovní položky (WIT)

Jako správce projektu můžete chtít upravit existující typ pracovní položky (WIT) pro podporu dalšího sledování požadavků nebo pracovních postupů. Mezi nejběžnější důvody pro úpravu WIT patří přidání nebo úprava sady polí nebo pravidel polí, změna pracovního postupu nebo přizpůsobení formuláře pracovní položky. Tyto tři důvody odpovídají třem hlavním částem XML souboru definice WIT: FIELDS, WORKFLOW a FORM.

Všechny tyto změny vyžadují úpravy definice WIT, což lze provést pouze pro místní nasazení TFS. Toto téma obsahuje přehled možností úprav a odkazy na obsah, který vám ukáže způsob jejich provedení.

Přidání nebo upravení pole, pravidla pole, popisku nebo prázdného textu

Pole a pravidla polí můžete přidat do části FIELDS. Aby se pole zobrazilo ve formuláři pracovní položky, je třeba jej také přidat do části FORM definice WIT.

Například pro přidání ID pracovní položky do formuláře zadejte následující syntaxi XML do části FORM.

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

Další informace o definování polí naleznete v tématu Přidání nebo úprava pole pro podporu dotazů, sestav a pracovního postupu.

Změna stavu pracovního postupu, důvody, přechody nebo přidání pravidel polí pracovního postupu

Časti STATES a REASONS v rámci oddílu WORKFLOW určují hodnoty v rozevíracím seznamu v polích Stav a Důvod. Sledují stav pracovních položek. Část TRANSITIONS určuje platné přechody mezi stavy, jak je znázorněno na následujícím obrázku. Můžete určit přechody dopředu i dozadu.

Příklad diagramu stavu pracovního postupu

V rámci dosažení těchto cílů můžete změnit pracovní postup:

• Přidání nebo odebrání stavu, důvodu nebo přechodu.

• Zadání hodnoty pro pole, které chcete použít při změně stavu, důvodu nebo přechodu.

• Určení vlastní ACTION k automatizaci přiřazení polí na základě změny stavu, důvodu nebo přechodu.

Při vlastním nastavování pracovního postupu proveďte tyto dva kroky:

1. Upravte PRACOVNÍ POSTUP definice WIT.

2. Upravte konfiguraci procesu pro mapování stavů nových pracovních postupů na metastavy.

   Tento druhý krok je nezbytné v následujících případech:

   • Při změně pracovního postupu pro kon, zobrazené na stránce agilní plánování nástroje. Tyto WIT patří buď do kategorie Požadavek, nebo Úkol. Další informace o konfiguraci těchto nástrojů naleznete v tématu Configure and customize Agile planning tools for a team project.

   • Pokud změnit pracovní postup pro testovací plán nebo testovací sady a práce součástí Visual Studio 2013.2 nebo starší verze klienta Test Manager. Tyto WITs byla k dispozici při instalaci aktualizace vrstva aplikace serveru TFS 2013.3. které se zobrazí na stránce agilní plánování nástroje.

     Pokud se setkáte aplikace zjistil neočekávanou chybu Chyba při připojení k týmovému projektu po změně pracovního postupu lze vyřešit jeho mapování nové stavy pracovního postupu na metastates. Chcete-li vyřešit tuto chybu, viz Import and export process configuration [witadmin].

Pravidla polí pracovního postupu

Pravidla polí můžete použít při změně stavu, zadání důvodu nebo v průběhu přechodu pracovního postupu.

Například přidáním pravidla EMPTY, pokud je stav nastaven na Aktivní, můžete automaticky nastavit pole Datum uzavření a Uzavřel na hodnotu null a určit je jen pro čtení. To je užitečné při opakované aktivaci pracovní položky z uzavřeného stavu.

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

Pravidla polí pracovního postupu použijte pro provedení následujících akcí:

• Kvalifikování hodnoty, kterou může pole mít, zadáním CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY a REQUIRED.

• Zkopírování hodnoty do pole pomocí COPY, DEFAULT a SERVERDEFAULT.

• Omezení toho, kdo může upravit pole.

• Vynucení vzorce pro porovnávání na pole řetězců pomocí MATCH.

• Podmíněné použití pravidel na základě hodnot v ostatních polích pomocí WHEN, WHENNOT, WHENCHANGED a WHENNOTCHANGED.

• Omezení pravidel vztahujících se na některé uživatele nebo skupiny. Většina pravidel podporuje atributy for nebo not, aby bylo možné zaměřit se na to, na koho se pravidlo vztahuje a na koho se nevztahuje.

Další informace o použití pravidel polí pracovního postupu naleznete v tématu FIELD (pracovní postup) – element (referenční dokumentace).

Přizpůsobení formuláře pracovní položky

Na následujícím obrázku jsou zvýrazněny nejběžnější prvky ve formulářích pracovních položek. Upravit lze všechny z nich s výjimkou názvu oblasti a ovládacích prvků formuláře.

V rámci dosažení těchto cílů můžete přizpůsobit formulář WIT:

• Přidání nebo odebrání pole, změna popisku pole nebo změna umístění pole ve formuláři. Další informace naleznete v tématu Specify work item form controls.

• Přidání nových karet nebo sloupců nebo přesunutí skupin polí z jedné karty na jinou. Další informace naleznete v tématu Design the work item form.

• Přidání informačního textu pro podporu vyplňování formuláře, přidání hypertextových odkazů na podrobné pokyny procesu, vložení textu HTML nebo zobrazení dynamických sestav ve formuláři. Další informace naleznete v tématu Provide help text, hyperlinks, or web content on a work item form.

• Určení karet, které omezují typy odkazů, nebo WIT, které mohou být propojeny s pracovní položkou. Další informace naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními.

• Přidání ovládacího prvku přílohy pro podporu připojování souborů. Další informace naleznete v tématu Přidání ovládacího prvku příloh.

Úprava definice WIT

Chcete-li upravit definici WIT, můžete exportovat, upravit a poté importovat soubor definice WIT.

Pomocí příkazu witadmin můžete importovat a exportovat soubory definic. 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.

1. Pokud nemáte oprávnění správce týmového projektu, získejte je.

2. Otevřete okno příkazového řádku, kde je nainstalována buď aplikace Visual Studio, nebo Průzkumník týmových projektů, a zadejte:

   cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
   

   V 64bitové verzi systému Windows nahraďte výraz %programfiles% výrazem %programfiles(x86)%. Go zde ke stažení Průzkumník týmových projektů zdarma.

3. Exportujte soubor definice WIT, ve kterém chcete změnit nebo přidat pole. Zadejte název WIT a název souboru.

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

   Příkladem CollectionURL je tfs/http://MyServer:8080/TeamProjectCollectionName.

4. Upravte soubor. Podrobnosti naleznete v tématu Work item tracking: Index to XML element definitions.

5. Importujte soubor definice WIT.

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

6. Otevřete buď aplikaci TWA, nebo nástroj Průzkumník týmových projektů a zobrazte změny. Pokud již byl klient spuštěn, aktualizujte stránku.

   V nástroji Průzkumník týmových projektů zvolte tlačítko Obnovit.

   Nejnovější aktualizace jsou staženy ze serveru, včetně změn, které jste importovali. Počkejte několik sekund, dokud se aktualizace nedokončí.

   Další informace o použití příkazu witadmin naleznete v tématu Import, export, and manage work item types [witadmin].

Dotazy a odpovědi

D: Jak lze pracovat se značkami?

O: Informace o přidávání značek a filtrování seznamů naleznete zde.

Q: jaké úpravy lze provádět a nadále používat funkce Průvodce konfigurací po upgradu TFS aktualizovat projekt týmu?

A: můžete přidat vlastní WITs a změnit rozložení formuláře. Průvodce konfigurací funkce aktualizuje týmové projekty, získáte přístup k nejnovějším funkcím.

Změna pracovního postupu nebo přejmenování NEM může být nutné provést některé ruční operace při aktualizaci týmového projektu. Další informace o další vlastní nastavení, které můžete bezpečně provádět a které byste se měli vyhnout, viz přizpůsobit práci Sledování zkušeností: dříve, než můžete přizpůsobit, pochopit souvislosti Údržba a upgrade.

D: Jak lze přidat nový WIT?

O: Nejjednodušší způsob, jak přidat nový WIT, je zkopírovat existující WIT a následně upravit soubor definice. Příklad naleznete v tématu Create a work item type.

O: Lze přejmenovat WIT?

O: Ano. Existující WIT je možné přejmenovat pomocí witadmin renamewitd. Například můžete přejmenovat WIT s popiskem „Položka QoS“ na „Servisní smlouva“.

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

Při přejmenování WIT, který patří do kategorie, je třeba aktualizovat definici kategorií pro týmový projekt tak, aby odrážela nový název. Zejména nástroje pro agilní plánování nebudou fungovat, dokud neaktualizujete definici kategorií.

Další informace naleznete v tématu Import, export, and manage work item types [witadmin] a Import and export categories [witadmin].

D: Jak lze deaktivovat nebo zakázat WIT?Jak lze zabránit uživatelům ve vytváření pracovní položky určitého typu?

O: Pokud máte WIT, který chcete vyřadit, ale chcete zachovat pracovní položky, jež byly vytvořeny podle tohoto typu, můžete přidat pravidlo, které zakazuje všem platným uživatelům ukládat typ pracovní položky.

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

Pokud chcete omezit vytváření specifických WIT na skupinu uživatelů, existují dva způsoby, jak omezit přístup:

• Přidáním typů pracovních položek do skupiny skrytých kategorií můžete zabránit většině přispěvatelů v jejich vytváření. Chcete-li povolit přístup skupině uživatelů, můžete vytvořit hypertextový odkaz na šablonu, jež otevře formulář pracovní položky a sdílí tento odkaz se členy týmu, kteří ji chtějí vytvořit.

• Přidáním pravidla pole k pracovnímu postupu pro pole System.CreatedBy můžete efektivně zabránit skupině uživatelů ve vytváření pracovní položky určitého typu. Jak ukazuje následující příklad, uživatel vytvářející pracovní položku musí náležet do skupiny Allowed Group, aby mohl pracovní položku uložit.

  <TRANSITION from=" " to="New">
     <FIELDS>
       <FIELD refname="System.CreatedBy">
           <VALIDUSER for="Allowed Group" not="Disallowed Group" />
       </FIELD>
     </FIELDS>
  </TRANSITION> 
  

D: Jak lze odstranit nový WIT?

O: Pokud chcete zabránit členům týmu v používání konkrétního WIT k vytvoření pracovní položky, můžete jej odebrat z týmového projektu. Používáte-li witadmin destroywitd, můžete trvale odstranit všechny pracovní položky, které byly vytvořeny pomocí tohoto WIT, a rovněž samotný WIT. Pokud váš tým například nepoužívá položku „Překážka“, můžete z projektu webové stránky Fabrikam odstranit WIT označený jako „Překážka“.

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

Při odstranění WIT, který patří do kategorie, musíte aktualizovat definici kategorií pro týmový projekt tak, aby odrážela nový název. Zejména nástroje pro agilní plánování nebudou fungovat, dokud neaktualizujete definici kategorií.

Další informace naleznete v tématu Import, export, and manage work item types [witadmin] a Import and export categories [witadmin].

D: Mohu změnit barvu přidruženou k WIT?

O: Ano. V aplikaci TWA (Team Web Access) se pracovní položky zobrazí ve výsledcích dotazu a na stránkách nevyřízených položek a panelu nástrojů pro agilní plánování. Pro změnu barvy přidružené k existujícímu WIT nebo přidání barvy pro použití s novým WIT upravte konfiguraci procesu.

D: Je možné přidat nebo odstranit WIT z nevyřízených položek nebo panelu úloh?

O: Ano. Nástroje pro agilní plánování (stránky nevyřízených položek produktu, nevyřízených položek sprintu a panelů úloh) zobrazují konkrétní WIT na základě šablony procesu použité k vytvoření vašeho týmového projektu. Je možné přidat nebo odebrat WIT, které se mají zobrazit na těchto stránkách. Pokud například váš týmový projekt používá WIT Scrum, zobrazí se na stránkách nevyřízených položek nevyřízené položky produktu i chyby. Pokud však byl týmový projekt vytvořen pomocí agilní, CMMI nebo jiné šablony procesu, chyby se v nevyřízených položkách nebo na panelu úloh nezobrazí.

Například můžete přidat chyby ze stránky nevyřízených položek produktu.

Chcete-li získat informace o přidání nebo odebrání WIT z nevyřízených položek nebo panelu úloh, přejděte sem. Chcete-li přidat nový WIT pro podporu portfolia nevyřízených položek, přejděte sem.

D: Když upravím WIT, jak to ovlivní existující pracovní položky?

O: Následující tabulka shrnuje vliv na existující pracovní položky při změně polí nebo definic WIT.

Akce	Vliv na existující pracovní položky
Odebrání polí z WIT	Data pro odebraná pole zůstanou v úložišti dat. Nelze však přidat žádná nová data, protože jste je odstranili z definice WIT.
Přejmenování pole	Data pro přejmenovaná pole zůstanou v úložišti dat pod novým popisným názvem.
Odstranění polí	Data pro odstraněná pole budou odebrána z úložiště dat.
Přejmenování WIT	Všechna data zůstanou beze změny s novým názvem.
Odstranění WIT	Všechna data pro vytvořené pracovní položky v rámci odstraněného WIT budou trvale odstraněna bez možnosti jejich obnovení.

Pokud chcete úplně odstranit pole z úložiště dat, použijte nástroj příkazového řádku witadmin deletefield. Další informace naleznete v tématu Manage work item fields [witadmin].

D: Jak mohu změnit typ existující pracovní položky?

O: Nelze změnit typ pro existující pracovní položku, ale můžete zkopírovat pracovní položku a zadat nový typ. Například můžete zkopírovat existující nevyřízenou položku produktu a změnit typ na chybu, jak je znázorněno na následujícím obrázku.

Rovněž pokud máte několik pracovních položek se změnami typů, které chcete provést, můžete je chtít exportovat pomocí aplikace Excel a potom je znovu přidat jako nový typ.

D: Je možné odstranit pracovní položky z TFS?

O: Ano. Použijte prvek witadmin destroywi k trvalému odebrání pracovních položek z databáze.

D: Co bych měl vědět o přizpůsobení WIT a aktualizacích serveru TFS?

O: Viz Configure features after a TFS upgrade.

D: Kam se obrátit s dalšími dotazy?

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

Další informace naleznete v tématu Specify work item form controls.

Použití editoru procesu k dispozici ke stažení z TFS napájení nástroje, pracovní postup upravit, nebo chcete-li zobrazit diagram stavu pracovního postupu.