Modify or add a field to support queries, reports, and workflow

Článek
09/11/2015

Podle šablony procesu použité k vytvoření týmového projektu obsahuje týmový projekt 100 nebo více datových polí. Každé pole je spojeno s dvěma názvy, atributy a pravidly. Je možné upravit existující pole nebo přidat vlastní pole za účelem podpory sledování dalších požadavků na data. Například lze upravit seznam výběru v rozevírací nabídce, přidat pravidlo pro zadání výchozí hodnoty či omezení hodnoty, kterou může nabývat, nebo můžete změnit atribut pole.

Chcete-li přidat pravidla polí či vlastní pole nebo změnit popisek pole ve formuláři pracovní položky, můžete upravit definici XML pro typ pracovní položky (WIT). Chcete-li změnit atribut, který pole nebo přejmenovat pole, použijte witadmin nástroj příkazového řádku.

Field definition names, attributes, and rules

Přizpůsobení rozevíracího seznamu

Seznamů pro výběr jsou výčtové hodnoty, které se zobrazí v rozevírací nabídce v formuláře pracovních položek a hodnotu sloupce v editoru dotazu. Způsob, který použijete pro přizpůsobení seznamu výběru, se liší v závislosti na poli.

Pole obecného řetězce nebo celočíselná pole

Chcete-li změnit seznam výběru pro většinu polí řetězce nebo celočíselných polí ve formuláři pracovní položky, upravte definici WIT. Chcete-li například přidat vlastní pole Řešení a seznam výběru, zadejte kód XML tak, jak je uvedeno na obrázku.

Vlastní pole a seznam výběru

Pick list for a custom field

<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 podporují sloučení seznamů, omezení jejich zobrazení pro určité osoby a nastavení podmínek toho, kdy se seznam zobrazí ve formuláři pracovní položky. Pravidla ovládacího prvku, zda je distribuční seznamy rozbalená jeho jednotlivých členů nebo pomocí volitelného je filtrovaný seznam expanditems a filteritems atributy. Použijte globální seznamy, abyste minimalizovali práci, která je vyžadována pro aktualizaci seznamu, jenž je sdílen mezi WIT nebo týmovými projekty.

Další informace naleznete v tématu Define pick lists a Define global lists.

Specifická pole, jejichž seznamy výběru jsou definovány jinými způsoby

Chcete-li upravit seznamy výběru pro následující pole, přečtěte si příslušné téma:

Oblasti a iteraci: Add and modify area and iteration paths.
Stav a důvod: přizpůsobení pracovního postupu.
Přiřazeno nebo jiná pole s názvem osoby: přidejte uživatelský účet do platné skupiny zabezpečení sady TFS.

Chcete-li přidat hodnoty pro pole, které jsou spojené s uživatelskými účty, jako je například přiřazeno přidat uživatele do skupiny zabezpečení sady TFS nebo omezením přístupu k skupiny nebo více uživatelů. Ve výchozím nastavení obsahuje seznam pole Přiřazeno názvy účtů všech uživatelů a skupin přidaných na server TFS. Tyto účty jsou často synchronizovány se službou Active Directory. Podívejte se na téma Nastavení skupin pro použití v nasazeních serveru TFS.
Stavů řešení nebo selhání typy (používaný správcem Test): tcm fieldmapping nástroje.

U všech ostatních polí, které mají výběr seznamy přidružené k them─such jako aktivity, automatizace stav, oboru, Priority, plus others─you mohou vyhledávat definice z těchto polí z index pole pracovních položek.

Přidání pravidel do pole

Chcete-li přidat vlastní pole nebo pravidla k poli, upravte definici WIT. Pravidla lze omezit tak, aby se vztahovala na určité uživatele nebo skupiny. Většina pravidla podpory for nebo not atributy zaměřit, který nepodporuje pravidla a se nevztahuje na.

Například pomocí následujícího fragmentu kódu můžete vynutit pravidlo, že pole Řazení zásobníku mohou po vytvoření pracovní položky upravit pouze členové řídícího týmu, což je skupina TFS definovaná zákazníkem.

<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 lze použít pro provedení následujících akcí:

K provedení této akce:	Použijte tento prvek XML:
Zadání popisu tlačítka.	HELPTEXT
Určení hodnoty, kterou pole může mít.	CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, and REQUIRED
Zkopírování hodnoty nebo určení výchozí hodnoty.	COPY, DEFAULT, a SERVERDEFAULT
Omezení toho, kdo může upravit pole.	VALIDUSER, for a not pole pravidlo atributy
Vynucení vzorové shody u pole řetězce.	MATCH
Podmíněné použití pravidel na základě hodnot v ostatních polích.	WHEN, WHENNOT, WHENCHANGED, and WHENNOTCHANGED

Další informace o použití pravidel pole, naleznete v části All FIELD XML elements reference.

Upravení XML souboru definice WIT pro přidání pravidel nebo přidání vlastního pole

Chcete-li přidat pravidla nebo vlastní pole, exportujte, upravte a potom importujte soubor definice WIT.

Process for customizing a WIT object

S witadmin, můžete importovat a exportovat definici soubory. Další nástroje, které můžete použít zahrnují Editor procesu, který je k dispozici pro stažení této sady TFS výkonné nástroje, nebo sady TFS týmu projektový manažer, projekt zdroje komunity k dispozici na webu CodePlex.

Jakékoli pole, které chcete použít ke sledování dat, musí být přidáno do souboru definice WIT. To platí pro všechny s výjimkou polí systému (pole jehož počáteční název odkazu s System.) automaticky které jsou definovány pro každý ŽÁ.

Chcete-li přidat vlastní pole, upravte definici ŽÁ Chcete-li přidat FIELD element v rámci FIELDS oddílu a Control element v rámci FORM oddílu.

Přidání vlastního pole

Pokud nemáte oprávnění správce projektu pro váš týmový projekt je získat tak.
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)%. Je možné Stáhnout průzkumníka týmových projektů zdarma.
Exportujte definici WIT.

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

Příklad CollectionURL je http://fabrikamprime:8080, tfs/DefaultCollection.
Vyhledejte část souboru XML, který definuje pole pro daný typ a který začíná FIELDS.
Přidat FIELD element, který určuje název vlastní pole, které chcete přidat. Je třeba 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, Žadatel, s názvem odkazu FabrikamFiber.MyTeam.Requestor, a seznam pro výběr 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>
```
Tip

Prvky v seznamu se vždy zobrazí v abecedním pořadí, bez ohledu na to, jak je zadáte v souboru definice XML.

Název odkazu nebo refname, je programový název pro pole.Všechna ostatní pravidla by měla odkazovat na to refname.Další informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.
Přidat Control element v rámci FORM oddílu tak, aby se zobrazí vlastní pole se ve formuláři v rámci skupiny elementů, které chcete zobrazit.

Například následující fragment kódu přidá pole Žadatel a zobrazí jej ve formuláři pracovní položky pod polem Důvod.
```
<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>
```
Tip

Definice schématu pro sledování pracovních položek definuje všechny podřízené elementy FORM element jako camelCase a další prvky jako všechny převedených na velká písmena.Pokud narazíte na chyby při ověřování souborů definic typů, zkontrolujte strukturu malých a velkých písmen ve vašich prvcích.Také struktura počátečních a koncových značek musí odpovídat pravidlům pro syntaxi XML.

Další informace naleznete v tématu Control – referenční dokumentace elementu XML.
Importujte soubor definice WIT.

witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"
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.

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

Další informace o použití witadmin, naleznete v části Import, export, and manage work item types [witadmin].

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

Exportujte soubor definice WIT.

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

V FORM a Layout oddíly, najít definici pole, které chcete upravit. V tomto příkladu upraví popisek pro Nadpis pole:

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

Změnit popisek pro pole tak, aby portugalština větví office pracujících na tomto projektu týmem může číst název Nadpis pole při práci s formulář pracovní položky. Zahrňte portugalské slovo pro název (Titulo) do pole Název.
```
<Column PercentWidth="70">
  <Control Type="FieldControl" FieldName="System.Title" Label="Title (Título):" LabelPosition="Left" />
</Column>
```
Importujte soubor definice WIT.

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

Změna atributu existujícího pole

Použijete witadmin changefield na změnu atributů existující pole. Například následující příkaz změní popisný název definovaný pro MyCompany.Type na Evaluation Method.

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

Následující tabulka shrnuje atributy lze změnit pomocí witadmin changefield.

Atribut	Popis
Datový typ	Určuje typ dat, které lze do pole zadat. Jakmile je definován typ dat pole, nelze jej obecně změnit. Můžete přepnout datový typ pole pouze u polí 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ý ve všech polích, která jsou definována v kolekci týmového projektu. Popisný název se může lišit od popisku formuláře, který se zobrazuje ve formuláři pracovní položky.
Indexovatelný	Můžete povolit indexování pole k urychlení odpovědi na dotaz při filtrování pole. Ve výchozím nastavení jsou indexována následující pole: Přiřazeno, Datum vytvoření, Změněno, Stav, Důvod, ID oblasti, ID iterace a Typ pracovní položky.
Atributy vytváření sestav	Můžete změnit název pole tak, jak se zobrazuje v sestavě, referenční název sestavy a typ vytváření sestav. Je možné lokalizovat popisný název vytváření sestav. Typ vytváření sestav určuje, zda jsou data pole zapsána do databáze relačního skladu, do databáze relačního skladu i datové krychle OLAP nebo zda generují předvypočítaný součet hodnot při zpracování datové krychle OLAP. Úplný seznam polí událostí podléhajících jako výchozí, naleznete v části Reportable fields reference for Visual Studio ALM. Další informace o datové krychle OLAP, naleznete v části Perspectives and measure groups provided in the Analysis Services cube for Visual Studio.
Synchronizace	Synchronizaci se službou Active Directory můžete povolit nebo zakázat pro pole, která jsou spojena s uživatelskými účty.

Dotazy a odpovědi

D: jaké úpravy lze provádět a nadále používat funkce Průvodce konfigurací aktualizace svůj týmový projekt po upgradu sady TFS?

O: lze přidat vlastní pole, seznam výběr přizpůsobit, přidat nebo upravit oblasti a iterace cesty a přidání pravidla do pole. Průvodce konfigurací funkce aktualizujeme týmové projekty a získáte přístup k nejnovější funkce.

Další informace o další vlastní nastavení, které jsou možné bezpečně a které neměli byste naleznete v tématu Přizpůsobit pracovní Sledování zkušeností: dříve, než můžete přizpůsobit, pochopit, údržbu a upgrade důsledky.

D: Kde lze získat informace o všech polích a atributech polí, které jsou již pro můj týmový projekt definovány?

O: index pole definovaná v rámci procesu sady TFS výchozí šablony, naleznete v části Work item field reference for Visual Studio ALM.

Kromě atributů, které lze změnit pro pole pracovní položky, existuje několik neměnitelných a prakticky skrytých atributů pro každé pole. Přiřazení těchto polí můžete vyhledat pomocí nástroje Průzkumník polí pracovní položky. Tento nástroj přistupujete z nástroj power Editor proces po instalaci sady TFS výkonné nástroje.

Průzkumník polí pracovní položky

Work item field explorer

Popis jednotlivých atributů naleznete v tématu tento příspěvek: pracovní položka atributy pole – je možné a Nepovolit úpravy.

D: Jak mohu přidat pole, které podporuje integraci s testem, sestavením a správou verzí?

O: několik WITs obsahovat pole, které poskytují informace, které je generováno automatizované procesy, jež jsou integrovány do správy verzí Team Foundation Build, nástroje Microsoft Test Manager a Team Foundation. Chcete-li přidat jednoho z těchto polí na vaše vlastní WITs vám upravte definici kon podle kroků uvedených dříve v tomto tématu.

Například můžete přidat pole Nalezeno v a Integrováno v sestavení, která se zobrazují v definicích typu pro chyby. Tato pole přidružují chyby k sestavením, ve kterých byly nalezeny nebo opraveny. Chcete-li přidat tato pole k definici typu pracovní položky, můžete použít následující fragment kódu.

<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 naleznete v tématu Fields that support integration with test, build, and version control.

D: Kdy použít globální seznam namísto jednoduchého seznamu výběru?

O: při použití seznam v několika WITs nebo napříč několika týmové projekty, jeho zachování jako globální seznam minimalizuje vaše požadavky údržby. Navíc pokud potřebujete mít části seznamů zobrazeny u různých WIT nebo týmových projektů odlišně, můžete definovat globální seznam pro část seznamu výběru. Podívejte se na téma Define pick lists a Define global lists.

D: Existují omezení z hlediska provádění změn systémových polí?

A: Yes. Systémová pole nelze přejmenovat a nelze u nich použít některá pravidla. Například nelze provést kopírování nebo nastavení na prázdná pole ke sledování toho, kdo vytvořil, změnil nebo uzavřel pracovní položku, ani nastavení polí s datem a časem používaných systémem.

Všechny názvy systémových polí začínají předponou „System“ (například System.ID). Všechna systémová pole jsou definována pro všechny WIT bez ohledu na to, zda je zahrnete do definice WIT. Další informace o každé pole, naleznete v části Work item field reference for Visual Studio ALM.

D: Jsou pravidla vyhodnocována v konkrétním pořadí?

O: Ano, však několika různými faktory mít vliv na způsob systém vyhodnocuje více pravidel tak, že konečným výsledkem vždy je známa plně na začátku. Získání některé představu o očekávané chování a interakce získáte Použití pravidla pro pole pracovní položky.

D: Jak mám pojmenovat pole pro podporu vytváření sestav?

O: můžete přidat pole nebo změnu atributů existující pole pro podporu vytváření sestav. Při přidání nebo změně polí je nutné je pojmenovat systematicky tak, abyste mohli najít pole v datové krychli služby Analysis Services, protože pole jsou logicky seskupena do složek. Další informace naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.

D: Je možné omezit počet jmen, která se zobrazí v poli Přiřazeno?

A: Yes. Ve výchozím nastavení obsahuje rozevírací nabídka pole Přiřazeno všechny uživatele, kterým byl udělen přístup k serveru TFS. Toto je výchozí skupina platných uživatelů. Výjimka, která má toto pravidlo je, že v Team Web Access, kontextové nabídky, které podporují přiřazení pracovních položek jsou omezeny na členy týmu.

Nejúčinnější způsob, jak použít bezpečnostní omezení, je vytvořit vlastní skupiny, které můžete spravovat buď v systému Windows, nebo pomocí serveru TFS.

Vytvořte skupinu zabezpečení, kterou chcete použít, a přidejte účty ke skupině. Můžete například vytvořit novou skupinu s názvem týmu přispěvatelé. Podívejte se na téma Add users to team projects.
Upravte soubor definice pro každý typ pracovní položky, u které chcete omezit skupinu uživatelů. Přidat VALIDUSER elementu, který chcete FIELD přiřazeno uživateli pole a zadat skupinu TFS v definici elementu.

Například lze do definice úkolu přidat následující fragment kódu a omezit tak skupinu uživatelů pro pole Přiřazeno pouze na ty členy týmu, kteří byli přidáni do skupiny týmových úkolů TFS.
```
<FIELD name="Assigned To" refname="System.AssignedTo" type="String" reportable="dimension" syncnamechanges="true">
   <HELPTEXT>The person currently working on this task</HELPTEXT>
   <ALLOWEXISTINGVALUE />
   <VALIDUSER group="Team Contributors" />
</FIELD>
```
Zadáním ALLOWEXISTINGVALUE elementu, nepoužívejte chyby ověření, které by jinak dojít v případě členy zůstat týmu a jsou již není zaregistrován jako přispěvatelé projektu.

D: Jak mohu přidat vlastní ovládací prvky k poli?

O: Using objektový model pro sledování pracovních položek, lze programově vytvářet, změnit a vyhledejte chyby, úkoly a dalších WITs. Můžete také vytvořit vlastní ovládací prvky, které přidávají funkce do formuláře pracovní položky.

Například můžete přidat následující vlastní ovládací prvky, které jsou k dispozici prostřednictvím vlastní ovládací prvky pro sady TFS pracovní položka sledování CodePlex projektu:

Ovládací prvek kopie obrazovky, který umožňuje provádět operace vyjmutí a vložení obrázků do pole HTML.
Ovládací prvek webového prohlížeče, který umožňuje uživatelům hostovat webovou stránku a předat hodnoty polí webové stránce.
Vícehodnotový ovládací prvek, který podporuje zadávání vícenásobných hodnot pro pole zobrazením seznamu zaškrtávacích políček.

D: Jak mohu změnit mapování polí, která podporují integraci projektového serveru TFS?

O: týmové projekty vytvořena na základě výchozí šablonu procesu sady TFS zahrnout výchozí soubor mapování projektu společnosti Microsoft. Používáte-li aplikaci Project k plánování a sledování pracovních položek uložených na serveru TFS, můžete chtít mapovat další pole aplikace Project nebo změnit způsob publikování a aktualizace pole serveru TFS. To lze provést Přizpůsobení souboru mapování projektu Microsoft.

Další informace o použití projektu s pracovních položkách sady TFS, naleznete v části Create your backlog and tasks using Project.

D: Jaký je nejlepší způsob, jak spravovat velké množství vlastních polí?

O: Pokud potřebujete přidat velký počet vlastní pole, které budou použity v několika WITs nebo napříč několika týmové projekty, použijte globální pracovního postupu. Pomocí globálního pracovního postupu můžete prostřednictvím správy globální sady polí a seznamů výběru zjednodušit operace údržby. Podívejte se na téma Referenční dokumentace XML elementů globálních pracovních postupů.

D: Jak mohu odstranit pole?

O: pole odebrat z určitého typu pracovní položky, toto pole odstraněna z kolekce nebo databázový server, i v případě, že se již odkazuje jakékoli ŽÁ. Chcete-li pole odstranit, postupujte takto.

Odebrat FIELD definice ze všech ŽÁ definice a globální pracovní postupy, 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 byl odstraněné pole událostí podléhajících, znovu vytvořit datového skladu vymazání původní pole a jeho hodnoty.

Další informace naleznete v tématu Manage work item fields [witadmin].

D: Jaké další oblasti mohu přizpůsobit?

O: naleznete v části Komplexní pohled na možnosti konfigurace a přizpůsobení ve Visual Studiu TFS.

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

O: Pokud chcete najít odpovědi nebo odešlete dotaz, navštivte fórum: Team Foundation Server – řízení projektů & pracovní položka.

Sdílet prostřednictvím