Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů

Článek
06/10/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.

Názvy polí definicí, atributy a pravidla

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

Seznamy výběru jsou výčtové hodnoty, které se objeví v rozbalovací nabídce ve formulář pracovní položky a sloupci Hodnota v editoru dotazů.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

Výběr seznamu vlastní pole.

<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 Definování rozevíracích seznamů a Definování globálních seznamů.

Určitá pole, jejichž výběr zobrazí jsou definovány jinými prostředky

Chcete-li upravit seznamů pro výběr pro následující pole, naleznete v tématu odpovídajících:

Oblasti a iteraci: Přidání a změna cest oblastí a iterací.
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 pravidel podporuje atributy for nebo not, aby bylo možné zaměřit se na to, na koho se pravidlo a na koho se nevztahuje.

S následující fragment kódu, například může vynutit pravidlo, že pouze členové týmu správy, zákazník definované skupiny sady TFS, pořadí zásobníku pole můžete změnit, jakmile byla vytvořena pracovní položku.

<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
Vynutit pravidla pro porovnávání na 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 Referenční dokumentace všech elementů XML FIELD.

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.

Proces k přizpůsobení ŽÁ objektu

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í u všech systémových polí (pole jejichž odkazovaný název začíná System.), která jsou definována automaticky pro každý WIT.

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.

Chcete-li přidat vlastní 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 nainstalovanou sadu Visual Studio nebo Průzkumníka 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 typ a která začíná s FIELDS.
Přidat prvek FIELD, který určuje název vlastního pole, které chcete přidat.Musí určit následující povinné atributy: popisný name, refname (název odkazu) a type.Další informace naleznete v tématu Referenční dokumentace elementů FIELD (definice).

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

Elementy v seznamu se zobrazí vždy v abecedním pořadí, bez ohledu na to, jak je zadat v souboru XML definice.

Název odkazu nebo, nebo refname, je programový název pole.Ostatní pravidla by se měla vztahovat na tuto 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é prvky prvku FORM jako velbloudí notace a všechny další prvky jako všechna velká.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řízené položky produktu nyní obsahuje nové pole.

Další informace o použití witadmin, naleznete v části Import, export a správa typů pracovních položek [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.
Generování sestav atributy	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 Referenční dokumentace polí umožňujících vytvoření sestavy pro Visual Studio ALM.Další informace o datové krychle OLAP, naleznete v části Perspektivy a skupiny měr poskytované v rámci datové krychle služby Analysis Services pro Visual Studio.
Synchronizace	Můžete povolit nebo zakázat synchronizaci se službou Active Directory pro pole, které jsou přidruženy k uživatelských účtů.

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 pole atributy již definována pro svůj týmový projekt?

O: index pole definovaná v rámci procesu sady TFS výchozí šablony, naleznete v části Referenční dokumentace polí pracovních položek pro 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

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 Pole na podporu integrace s testováním, sestavováním a správou verzí.

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

Odpověď: Při použití seznamu několika položek WIT nebo v několika týmových projektech, jejich zachování jako globální seznam minimalizuje požadavky na údržbu.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 Definování rozevíracích seznamů a Definování globálních seznamů.

D: jsou jejich omezení o úpravách systémová pole?

A: Ano.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 Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

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

Odpověď: Ano, ale několik faktorů ovlivňuje, jak systém vyhodnocuje více pravidel tak, aby konečný výsledek nemohl být na začátku úplně známý.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?

Odpověď: Pro podporu vytváření sestav můžete přidat pole nebo změnit atributy existujících polí.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: existuje způsob, jak omezit počet názvy, které se zobrazí v poli přiděleno?

A: Ano.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.

Vytvořit vlastní skupiny, které můžete spravovat v systému Windows nebo v rámci TFS je nejefektivnější způsob, jak použít omezení zabezpečení.

Vytvořte skupinu zabezpečení, kterou chcete použít, a přidejte účty ke skupině.Například vytvořte novou skupinu s názvem Přispěvatelé v týmu.Podívejte se na téma Přidávání uživatelů do týmových projektů.
Upravte soubor definice pro každý typ pracovní položky, u které chcete omezit skupinu uživatelů.Přidejte prvek VALIDUSER do definice prvku FIELD pro pole Přiřazeno k a určete skupinu TFS.

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 prvku ALLOWEXISTINGVALUE zabráníte chybám ověření, které by jinak nastaly, když členové týmu opustí tým a nejsou již registrováni 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:

Snímek obrazovky ovládací prvek, který umožňuje operaci 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 Vytvoření nevyřízených položek a úloh s použitím aplikace Project.

D: co je to nejlepší způsob, jak spravovat velký počet 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 Správa polí pracovních položek [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