Přidání nebo úprava pole pro sledování práce

Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Váš projekt obsahuje 100 nebo více datových polí v závislosti na procesu použitém k jeho vytvoření, jako jsou Agilní, Základní, Scrum nebo CMMI. Každá pracovní položka je svázaná s typem pracovní položky (WIT) a data, která můžete sledovat, odpovídají polím přiřazeným k této pracovní položce. Data pracovních položek můžete aktualizovat úpravou datového pole v rámci pracovní položky.

Poznámka:

Pokud používáte model zděděného procesu, přečtěte si téma Přidání vlastního pole do typu pracovní položky.

Můžete upravit existující pole nebo přidat vlastní pole, abyste mohli sledovat více dat. Můžete například přizpůsobit rozevírací seznam, nastavit výchozí hodnotu nebo omezit hodnoty, které pole může přijmout.

Seznamy výběrů se definují různými způsoby, například prostřednictvím uživatelského rozhraní, pracovních postupů WIT nebo přidáním uživatelských účtů do projektu, jak je uvedeno v následující tabulce.

Definice DEFINICE WIT	Změna příkazového řádku (místní proces XML)
- Přizpůsobení seznamu pro výběr - Přidání pravidel do pole - Přidání vlastního pole - Změna popisku pole ve formuláři - Přidání vlastního ovládacího prvku	- Pole seznamu - Změna atributu pole - Odstranění pole - Indexování pole

Požadavky

Kategorie	Požadavky
Seznamová pole	Nastavit oprávnění k zobrazení informací na úrovni projektu pro projekt v kolekci na Povolit.
Přidání nebo přizpůsobení pole	Být členem skupiny Správci projektu nebo mít oprávnění Upravit informace na úrovni projektu nastavené na Povolit.
Odstranění, přejmenování nebo změna pole	Být členem skupiny zabezpečení Team Foundation Administrators nebo skupiny zabezpečení Správci kolekce projektů .

Pokud chcete být přidáni jako správce, změňte oprávnění na úrovni kolekce projektů.

Metody, podle kterých se přidají pole pracovních položek

Pole pracovních položek sledují data pro typ pracovní položky, definují kritéria filtru dotazů a generují sestavy. Libovolný datový prvek, který chcete sledovat, s výjimkou systémových polí, musí být definován jako pole pracovní položky. Pole můžete definovat v rámci typu pracovní položky (WIT) nebo globální definice pracovního postupu.

Pole pracovních položek jsou spravována na úrovni projektové kolekce a jsou přidávána v následujících scénářích.

Vytvoření projektu: Vytvoří se pole definovaná ve vybrané šabloně procesu pro typy pracovních položek nebo globální toky práce. Základní systémová pole se automaticky zahrnou pro každý typ pracovní položky. Seznam základních systémových polí najdete v tématu Index polí pracovní položky. Další informace o šablonách najdete v tématu Zpracování šablon.
Import definice WIT: Nová pole definovaná v definici WIT se přidají do kolekce. Další informace najdete v referenčních informacích o všech elementech WITD XML.
Import globální definice pracovního postupu: Do kolekce se přidají nová pole definovaná v globálním pracovním postupu. Globální pracovní postupy umožňují sdílená pole napříč více typy pracovních položek. Podrobnosti najdete v tématu Přizpůsobení globálního pracovního postupu .

Úplná sada polí v kolekci zahrnuje všechna pole definovaná v pracovních postupech a globálních pracovních postupech ve všech projektech. Můžete upravit atributy, přejmenovat nebo odstranit pole, ale tyto změny můžou ovlivnit místní servery a reportování.

Chcete-li přidat nebo přizpůsobit pole, upravte obsah XML definice WIT. Definujte každé pole pomocí elementu FIELD v oddílu POLE . Další informace naleznete v tématu referenční příručka pro všechny prvky FIELD XML.

Přidání pole, použití pravidla nebo změna atributu

Pokud chcete přidat vlastní pole, přidat pravidla polí nebo změnit popisek pole ve formuláři pracovní položky, upravte typ položky práce (WIT) nebo typy, které toto pole používají. Postupujte podle posloupnosti přizpůsobení, která odpovídá vašemu modelu procesu.

Pokud chcete změnit atribut pole nebo přejmenovat pole, použijte nástroj příkazového řádku witadmin . V opačném případě přidáte nebo upravíte pravidla přidružená k poli v definici wit.

Snímek obrazovky se souhrnem atributů polí a pravidel polí

Úprava definičního souboru WIT

Pokud chcete přidat pravidla nebo přidat vlastní pole, exportujte, upravte a importujte definiční soubor WIT.

Návod

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.

Chcete-li sledovat data, přidáte pole do definičního souboru WIT s výjimkou systémových polí, což jsou pole s názvem odkazu začínajícím na System.. Systémová pole se automaticky definují pro všechny wity, i když nejsou zahrnuté v definici WIT. Podrobnosti naleznete v Index pole pracovních položek.

Přidání zaškrtávacího políčka nebo logického pole

Pomocí následující syntaxe přidejte logické pole v oddílu POLE definice WIT.

<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
   <DEFAULT from="value" value="False" />
   <HELPTEXT>Triage work item</HELPTEXT>
</FIELD>

Potom do oddílu FORM přidejte následující syntaxi, aby se pole zobrazilo ve formuláři.

<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" />

Pole se ve formuláři zobrazí jako zaškrtávací políčko.

Přizpůsobení seznamu pro výběr

Výběrové seznamy jsou číselné hodnoty zobrazené v rozevíracích nabídkách ve formulářích pracovních položek a ve sloupci Hodnota v editoru dotazů. Pokud chcete přizpůsobit výběrový seznam pro většinu řetězcových nebo celočíselná pole, upravte definici wit. Pomocí následujícího kódu XML můžete například přidat vlastní pole Rozlišení se seznamem pro výběr.

Vlastní pole a výběr seznamu
Snímek obrazovky ukazuje seznam vlastního výběru.

<FIELD name="Resolution" refname="MyCompany.Resolution" type="String">    
<ALLOWEDVALUES>
   <LISTITEM value="By Design" />
   <LISTITEM value="Duplicate" />
   <LISTITEM value="External" />
   <LISTITEM value="Fixed" />
   <LISTITEM value="Not Repro" />
   <LISTITEM value="Postponed" />
   <LISTITEM value="Won't Fix" />
</ALLOWEDVALUES>
</FIELD>

Pravidla umožňují kombinovat seznamy, omezit, kdo může získat přístup k seznamu, a nastavit podmínky pro zobrazení seznamu ve formuláři pracovní položky. Atributy expanditems a filteritems můžete použít k řízení, zda distribuční seznam zobrazuje jednotlivé členy nebo filtruje konkrétní položky.

Pokud chcete zjednodušit údržbu, použijte globální seznamy pro sdílené seznamy v rámci pracovních položek nebo projektů. Globální seznamy snižují úsilí potřebné k aktualizaci sdílených seznamů. Pokud se části seznamu musí lišit v rámci pracovních položek nebo projektů, můžete definovat globální seznam pro konkrétní části výběrového seznamu. Další informace naleznete v tématu Definování seznamů výběrů a Definování globálních seznamů.

Přidání pravidel do pole

Chcete-li přidat vlastní pole nebo použít pravidla pro pole, upravte definici definice WIT. Pravidla můžete omezit na konkrétní uživatele nebo skupiny pomocí atributů pro nebo ne , abyste definovali, na koho se pravidlo vztahuje nebo které pravidlo vylučuje.

Například následující fragment kódu vynucuje pravidlo, že pole Stack Rank může po vytvoření pracovní položky upravit pouze členové týmu managementu, vlastní naddefinované skupiny.

<FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">  
   <FROZEN not="[project]\Management Team" />  
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.</HELPTEXT>
</FIELD>

Pravidla můžete použít u polí, abyste dosáhli následujících akcí:

Činnost	XML prvek
Přidejte do pole nápovědu.	HELPTEXT
Definujte nebo omezte hodnoty, které pole může mít.	CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, REQUIRED
Zkopírujte hodnotu nebo nastavte výchozí hodnotu pole.	COPY, DEFAULT, SERVERDEFAULT
Omezit, kdo může změnit pole.	VALIDUSER, pro, ne
Vynucujte vzorové porovnávání pro stringová pole.	UTKÁNÍ
Podmíněné použití pravidel na základě jiných hodnot polí	WHENNOT, WHENCHANGED, WHENNOTCHANGED

Systémová pole identifikovaná předponou "Systém", například System.ID, umožňují omezené přizpůsobení pravidel. Nemůžete například kopírovat nebo vymazat pole, která sledují, kdo vytvořil, změnil nebo zavřel pracovní položku nebo pole data a času spravované systémem.

Podrobnosti o pravidlech a omezeních polí najdete v tématu Pravidla a vyhodnocení pravidel.

Přidání vlastního pole

Pokud chcete přidat vlastní pole, upravte definici WIT a přidejte prvek FIELD v oddílu POLE a ovládací prvek v oddílu FORM .

Exportujte definiční soubor WIT na základě použitého modelu procesu.
Vyhledejte část souboru XML, která začíná FIELDSna .
FIELD Přidejte prvek, který určuje název vlastního pole, které chcete přidat. Je nutné zadat následující požadované atributy: popisný name, refname (název odkazu) a type. Další informace naleznete v tématu FIELD (Definition) element reference.

Následující kód určuje vlastní pole Requestor s referenčním názvem FabrikamFiber.MyTeam.Requestor a výběrem seznamu povolených hodnot s výchozí hodnotou Zákazník.
```
<FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>
```
Návod

Prvky v seznamu se vždy zobrazují v alfanumerickém pořadí bez ohledu na to, jak je zadáte do definičního souboru XML. Název odkazu nebo refnameje programový název pole. Všechna ostatní pravidla by měla odkazovat na refname. Další informace najdete v tématu Omezení a konvence pojmenování.
Control Přidejte prvek v oddíluFORM, aby se vlastní pole zobrazilo ve formuláři ve skupině prvků, ve kterých se má zobrazit.

Například následující fragment kódu přidá pole Žadatele, které se zobrazí pod pole Důvod ve formuláři pracovní položky.
```
<Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>
```
Návod

V definici schématu pro sledování práce musí všechny podřízené prvky elementu FORM použít camel case, zatímco všechny ostatní prvky musí být velkými písmeny. Zajistěte, aby struktura případů otevírání a zavírání značek odpovídala pravidlům syntaxe XML, aby nedocházelo k chybám ověřování. Další informace naleznete v tématu Control XML element reference.
Importujte definiční soubor WIT podle používaného modelu procesu.
Otevřete webový portál nebo Team Explorer a zobrazte změny. Pokud je klient již otevřený, aktualizujte stránku.

Následující obrázek ukazuje, že formulář pracovní položky pro položku backlogu produktu teď obsahuje nové pole.

Změna popisku pole ve formuláři pracovní položky

Chcete-li upravit popisek pole, změňte hodnotu přiřazenou atributu elementu ControlLabel . Chcete-li odebrat pole z formuláře pracovní položky, odstraňte Control prvek přidružený k poli.

Exportujte definiční soubor WIT podle modelu procesu.

FORM V částech a Layout částech vyhledejte definici pole, které chcete upravit. Tento příklad upraví popisek pole Název :

<Column PercentWidth="70">  
   <Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" />  
</Column>

Změňte popisek pole tak, aby portugalská pobočka pracující na tomto konkrétním projektu při práci s formulářem pracovní položky přečetla název pole Název . Do pole Název zahrňte portugalské slovo pro název (Titulo).
```
<Column PercentWidth="70">  
   <Control Type="FieldControl" FieldName="System.Title" Label="Title (Titulo):" LabelPosition="Left" />  
</Column>
```
Naimportujte upravenou definici wit.

Přidání vlastního ovládacího prvku

Pomocí rozhraní REST API pro sledování pracovních položek můžete programově vytvářet, aktualizovat a vyhledávat chyby, úkoly a další typy pracovních položek (WIT). Kromě toho můžete vytvořit vlastní ovládací prvky pro vylepšení funkčnosti formuláře úkolu.

Alternativně můžete použít vlastní ovládací prvky, které jsou k dispozici prostřednictvím Visual Studio Marketplace, například:

Vícehodnotový ovládací prvek: Umožňuje zadávání více hodnot pro pole pomocí seznamu zaškrtávacích políček.
Ovládací prvek barevného rozevíracího seznamu: Umožňuje přidávat barvy k položkám seznamu.
Formulář pracovní položky - akce s jedním výběrem: Poskytuje přizpůsobitelnou sadu pravidel pro akce s jedním výběrem.

Pokud chcete do nového webového formuláře přidat vlastní ovládací prvek, přečtěte si článek WebLayout a ovládací prvky.

Změna atributu existujícího pole

Pomocí changefieldu witadmin můžete změnit atributy existujícího pole. Například následující příkaz změní uživatelsky příjemný název definovaný pro MyCompany.Type na metodu vyhodnocení.

witadmin changefield /collection:http://AdventureWorksServer:8080/ DefaultCollection/n:MyCompany.Type /name:"Evaluation Method"

Následující tabulka shrnuje atributy, které můžete změnit pomocí changefieldu witadmin.

Atribut	Popis
Datový typ	Určuje typ dat, která pole přijímá. Obecně platí, že datový typ pole nemůžete po definování změnit. Datový typ pole můžete přepnout pouze pro pole typu HTML nebo PlainText.
Popisný název	Popisný název se zobrazí v rozevíracích nabídkách dotazů pracovních položek a musí být jedinečný pro všechna pole definovaná v kolekci projektů. Popisný název se může lišit od popisku formuláře, který se zobrazí ve formuláři pracovní položky.
Atributy generování sestav	Název pole, které se zobrazí v sestavě, název odkazu na sestavu a typ sestavy, můžete změnit. Popisný název sestav můžete lokalizovat. Typ generování sestav určuje, zda se data pole zapisují do databáze relačního skladu, do databáze relačního skladu i do datové krychle OLAP, nebo k vygenerování předem počítaného součtu hodnot při zpracování datové krychle OLAP. Úplný seznam výchozích polí s možností sestavy naleznete v tématu Odkaz na pole s možností sestavy . Další informaceoch
Synchronizace	Synchronizaci můžete povolit nebo zakázat u polí jmen osob se službou Active Directory.

Změna atributu indexu pole

Povolte indexování pole, aby se zlepšila doba odezvy dotazů při filtrování. Ve výchozím nastavení jsou indexována následující pole: Přiřazeno, Datum vytvoření, Změněno podle, Stav, Důvod, ID oblasti, ID iterace a Typ pracovní položky.

Pokud chcete povolit nebo zakázat indexování pro pole, použijte příkaz witadmin indexfield.

Odstranění pole

Když odeberete pole z konkrétního WIT, zůstane pole v kolekci nebo na databázovém serveru, i když už na něj neodkazuje žádný WIT. Pokud chcete pole úplně odebrat, postupujte takto.

Odeberte definici FIELD ze všech definic wit a všech globálních pracovních postupů, které na ni odkazují.

Ověřte, že se pole nepoužívá. Příklad:

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact

Field: MyCompany.CustomContact
Name: Custom Contact
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Odstraňte pole. Příklad:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact

Pokud bylo odstraněné pole sestavitelné a váš projekt používá službu SQL Server Reporting Services, znovu sestavte datový sklad, aby se vyprázdnilo staré pole a jeho hodnoty.

Další informace najdete v tématu Správa polí pracovních položek.

Pole pro testování, sestavení a správu verzí

Některé typy pracovních položek zahrnují pole generovaná automatizovanými procesy, které se integrují s Team Foundation Buildem, Microsoft Test Managerem a správou verzí Team Foundation. Pokud chcete tato pole přidat do vlastních typů pracovních položek (WIT), upravte definici pracovní položky podle výše uvedených kroků.

Například můžete přidat pole Nalezeno v a Integrované v sestavení, která přidružují chyby k sestavením, kde byly nalezeny nebo opraveny. Pomocí následujícího fragmentu kódu zahrňte tato pole do definice wit:

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Další informace najdete v tématu Dotaz na základě polí integrace sestavení a testování.

Názvy polí a vytváření sestav

Můžete přidat pole nebo změnit atributy existujících polí tak, aby podporovaly vytváření sestav. Když přidáte nebo změníte pole, měli byste je systematicky pojmenovat, abyste ho mohli najít v datové krychli služby Analysis Services, protože pole se logicky seskupí do složek. Další informace naleznete v tématu Přidání nebo úprava polí pracovních položek pro podporu vytváření sestav.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-10-08