Manage work item fields [witadmin]

Článek
09/11/2015

Můžete spravovat pole typu pracovních položek, které jsou definovány pro kolekci týmového projektu s použitím následujících witadmin příkazů:

changefield: Změní jeden nebo více atributů pole. Pokud změníte jednu z následujících atributů, můžete změnit pro všechny typy pracovních položek a týmové projekty v rámci kolekce týmových projektů:
- Datový typ pro PlainText nebo HTML polí.
  
  Důležité
  
  Při upgradu Team Foundation Server z dřívější verze na aktuální verzi typ přiřazení pro Popis (System.Description) pole je automaticky převedeno z PlainText na HTML.S changefield příkazu, můžete obnovit obsah tohoto pole, chcete-li zobrazit ve formátu prostého textu.
- Popisný název zobrazí v dotazu pracovní položky. Tento název se může lišit od zobrazeny ve formuláři pracovní položku.
- Reporting atributy obsahující název pole, v jakém je zobrazen v sestavě, odkaz na název sestavy a typ vykazování.
- Synchronizace se službou Active Directory – vám mohou povolit nebo zakázat synchronizaci polí jméno osoby.
deletefield: Odstraní zadané pole.
indexfield: Zapne indexování zapnuto nebo vypnuto pro zadané pole. Když povolíte indexování pro pole, může zvýšit výkon hledání pracovních položek, jejichž dotazy určují tohoto pole. Pokud chcete přidat vlastní pole, které můžete použít v mnoha dotazy pracovní položky, můžete povolit indexování u tohoto pole.
listfields: Obsahuje seznam atributy pro všechna pole nebo v určeném poli.

witadmin Nástroj příkazového řádku lze použít pouze při spuštění proti TFS místně. Chcete-li spustit nástroj, otevřete okno příkazového řádku kde buď Visual Studio nebo Průzkumník týmových projektů je nainstalován a zadejte:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

Na 32bitovou verzi systému Windows, nahradit %programfiles(x86)% s %programfiles%.

Přehled polí definovaných v rámci výchozí šablonu procesu naleznete v tématu Work item field reference for Visual Studio ALM.

Poznámka

Můžete vytvářet a upravovat pole pracovních položek pomocí procesu editoru, jako nástroj power Visual Studio.Tento nástroj není podporován.Další informace naleznete v tématu na následující stránce webu společnosti Microsoft: Team Foundation Server výkonné nástroje.

Požadavky

Chcete-li list pole, musí mít své Zobrazit informace na úrovni projektu oprávnění pro týmový projekt v kolekci nastavena na Povolit.
Pokud chcete odstranit nebo přejmenovat pole nebo změnit atribut pole, musí být členem skupiny Správci serveru Team Foundation skupiny zabezpečení nebo správce kolekce projektu skupiny zabezpečení.

Další informace naleznete v tématu Oprávnění v prostředí Team Foundation Server.

Poznámka

I když se přihlásíte s oprávněními pro správu, je nutné otevřít okno příkazového řádku se zvýšenými oprávněními k provedení této funkce na serveru, který je spuštěn Windows Server 2008.Otevřete okno příkazového řádku se zvýšenými oprávněními, zvolte Start, spusťte Příkazový řádek místní nabídku a poté zvolte možnost Spustit jako správce.Další informace naleznete na webu společnosti Microsoft: řízení přístupu uživatele.

witadmin changefield /collection:CollectionURL /n:RefName
   [/name:NewName] 
   [/syncnamechanges:true | false]
   [/reportingname:ReportingName] 
   [/reportingrefname:ReportingRefName]
   [/reportingtype:Type]
   [/reportingformula:Formula]
   [/type:PlainText | HTML]
   [/noprompt]

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parametry

Parametr	Popis
/collection:CollectionURL	Určuje identifikátor URI kolekce týmových projektů. Formát pro identifikátor URI je následující: http://název_serveru: port/název_virtuálního_adresáře/CollectionName Pokud je použit žádný virtuální adresář, formát pro identifikátor URI je následující: http://Název_serveru: port / CollectionName
/n:RefName /n:Name	Odkaz na název pole Typ pracovní položky.
/index	Určuje k povolení nebo zakázání indexování pro zadané pole. Zadejte on Chcete-li povolit indexování a off zakázání indexování.
/name: NewName	Určuje nový název pro pole.
/syncnamechanges	Určuje použití pole pracovní položky pro uložení jména a k aktualizaci při provedení změn ve službě Active Directory nebo k pracovní skupině. Tato možnost je platná pouze v případě, že pole s datovým typem řetězce je zadán pro typename. Zadejte true Chcete-li povolit synchronizaci pro pole dat, zadejte false Zakázání synchronizace pro datové pole.
/reportingname:ReportingName	Určuje název pole v datovém skladu, který se má použít pro generování sestav.
/reportingrefname:ReportingRefName	Určuje název odkaz na pole v datovém skladu, který se má použít pro generování sestav.
/reportingtype: Type	Určuje, jak toto pole se používá ve skladu pro generování sestav. Platné jsou následující hodnoty: dimension: Použít pro pole Integer, String nebo data a času. detail: Použít pro pole Integer, Double, řetězec nebo data a času. measure: Použít pro dvojité pole a celé číslo. Výchozí typ agregace je součet. Pomocí můžete zadat jiný typ agregace formula parametru. none: Slouží k zakázání reportability na pole. Další informace naleznete v tématu Define and modify work item fields.
/reportingformula: Formula	Určuje vzorec agregace, který má být použit při pole je označeno jako measure. Je jediný podporovaný vzorec sum.
/type: HTML \| PlainText	Určuje, že převést obsah pole z PlainText na HTML nebo z HTML na PlainText. Můžete určit tuto možnost pouze u polí, jehož typ přiřazení je PlainText nebo HTML. Podívejte se na téma FIELD (Definition) element reference.
/unused	Zobrazí všechna pole, které nejsou využívány jakékoli týmový projekt, který je definován v kolekce týmových projektů.
/noprompt	Zakáže výzvu k potvrzení.
/? or help	Zobrazí nápovědu o příkaz v okně příkazového řádku.

Poznámky

Indexované pole

Index dotazu je založeno na tato pole, které mají indexování povoleno. Tento index vylepšuje doba odezvy při spouštění dotazů, které obsahují indexované 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. Pokud existují další pole, které váš tým často používá v jejich dotazy, přidejte je do indexu dotazu.

Jméno osoby synchronizace s adresářem služby Active Directory

Je třeba ručně povolit synchronizaci pole všech vlastních pracovních položek, které slouží k přiřazení jméno osoby, které odkazují na službě Active Directory. Je nutné povolit synchronizaci pro každé pole pro každé kolekce týmových projektů, který obsahuje vlastní pole.

Všechna pole odkaz systému, které se zobrazí jméno osoby mají atribut syncnamechanges nastaven na true. Tato pole obsahují System.AuthorizedAs, System.AssignedTo, System.ChangedBy a System.CreatedBy. Pro každé pole jméno osoby, který je definován v jednom z výchozí šablony procesu povolena synchronizace v. Další informace naleznete v tématu Assignments and workflow field reference.

Poté, co je synchronizace povolena, pole již zobrazuje statický řetězec. Namísto toho pole zobrazuje název přidružený k uživatelský účet. Pokud změníte uživatelské jméno ve službě Active Directory nebo v pracovní skupině pole s syncnamechanges nastavena na true automaticky zobrazí nový název.

Když přiřadíte syncnamechanges atributu na řetězec pole, pole vždy přijímá ověření uživatelských jmen. Pole však neumožňuje názvy skupin, které jsou uloženy v Team Foundation Server nebo ve službě Active Directory, pokud je některý z následujících podmínek true:

VALIDUSER Pravidlo je zadáno v rámci všechny typy pracovních položek
VALIDUSER Pravidlo je zadán pro typ pracovní položky
ALLOWEDVALUES Pravidlo je zadán pro typ pracovní položky a toto pravidlo má kritéria filtru, které vyloučí skupin

Další informace naleznete v tématu All FIELD XML elements reference.

Atributy, že můžete změnit pro každý typ pracovní položky

Je-li změnit následující atributy nebo hodnot definovaných pro pole změnou definici pracovní položky typu, ve kterém se zobrazí pole:

Název který zobrazí ve formuláři pracovní položky. Podívejte se na téma Control – referenční dokumentace elementu XML.
Text nápovědy. Podívejte se na téma Použití pravidla pro pole pracovní položky.
Povolené hodnoty nebo položky v seznamu Výběr nebo v rozevírací nabídce. Podívejte se na téma Define pick lists.

Příklady

Pokud není uvedeno jinak, platí následující hodnoty v jednotlivých příkladu:

Identifikátor URI pro kolekce týmových projektů: http://AdventureWorksServer:8080, tfs/DefaultCollection
Název pole pracovních položek: AdventureWorks.Field
Výchozí kódování: UTF-8

Seznam polí

Použít witadmin listfields Chcete-li zobrazit sadu polí při použití, vyberte jednu přidat do typ pracovní položky. Můžete také seznam přiřazení atributů definovaných pro určité pole a určit pole, která jsou používány projekty, které týmu.

Zobrazit atributy pole pracovní položky

Zadejte následující příkaz k výpisu atributy definované pro zadané pole, jako je například Microsoft.VSTS.Common.Issue.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Pro pole s názvem, zobrazí se pole a atribut informace, jak je znázorněno v tomto příkladu.
```
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
```
Použití parametr označuje název každý projekt a typ pracovní položky, kde se používá pole. Další informace o atributy pole, naleznete v části Work item field reference for Visual Studio ALM.

Seznam všech polí v kolekci týmového projektu

Zadejte následující příkaz pro zobrazení seznamu všech polí definovaných pro kolekci týmového projektu.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
Zobrazí se informace z pole pro všechna pole pro kolekci pojmenovaného projektu. Podívejte se na téma Work item field reference for Visual Studio ALM.

Seznam polí, které nejsou využívány

Zadejte následující příkaz pro zobrazení seznamu polí, které jsou již využívány v kolekce týmového projektu žádné typ pracovní položky.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

Pro každé pole, které není používán, zobrazí se pole a atribut informace, jak je znázorněno v tomto příkladu.

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Přejmenování pole

Popisný název pole pracovní položka ke splnění zásady vytváření názvů, které používá váš tým, můžete změnit. Všimněte si, že nový název se použije pro všechny typy pracovní položky, které odkazují na změněné pole ve všech projektech týmu v kolekci projektu. Popisný název se zobrazí, pokud definujete kritéria filtru v dotazu pracovní položky. Název, který se zobrazuje ve formuláři pracovní položky se liší od popisný název definované pro pole.

Chcete-li přejmenovat pole pracovní položky

Zadejte následující příkaz, který má přejmenovat popisný název přiřazený k Microsoft.VSTS.Common.Rank na důležité pořadí.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

Na příkazovém řádku zadáte potvrzení y a stiskněte klávesu ENTER. Vyčkejte, než se zobrazí následující zpráva:

Field renamed.

Chcete-li ověřit změny naimportovány do jediného projektu

V Průzkumník týmových projektů, zvolte aktualizace.

Nejnovější aktualizace stáhnou ze serveru, které obsahují změny, které jste právě vytvořili názvu pole. Vyčkejte několik sekund na dokončení aktualizace.
Zvolte Nový dotaz vytvořit dotaz.
Zvolte v editoru dotazu Kliknutím sem přidejte klauzuli odkaz, chcete-li přidat řádek, zvolte prázdný pole buňka a do buňky, zadejte pořadí. Následující zpráva, která se objeví nad seznam výsledků. Tato zpráva znamená, že pořadí nebyl nalezen.

Spuste dotaz, chcete-li zobrazit výsledky dotazu. TF51005: Dotaz odkazuje na pole, které neexistuje. Chyba je způsobena << pořadí >>.
Odstranit hodnotu v rozsahu pole buňky a zadejte důležité pořadí do buňky.
Vyberte <> v operátor buňky a zadejte 1 na portál hodnotu buňky.
Na dotazu nástrojů zvolte Spustit.
Otevřete místní nabídku pro každý řádek v výsledky a vyberte položku možností sloupce. Posun dolů v k dispozici sloupce seznamu. Všimněte si, že pořadí pole se již nenachází ale důležité pořadí pole je k dispozici.
Vyberte důležité pořadí v Dostupné sloupce pole a pak zvolte > tlačítko (Přidat vybrané sloupce). Zvolte OK.

Všimněte si, že popisný název Microsoft.VSTS.Common.Rank byla přejmenována z pořadí na důležité pořadí v celém seznamu tvůrce a výsledky dotazu.
Zavřete dotaz. Zvolte č po zobrazení výzvy dotaz uložte.
Vytvořte novou pracovní položku úkolu. Zvolte nových pracovních položek propojit a poté zvolte možnost úloha.

Typ pracovní položky, která změnit a importovat je tvořen tuto pracovní položku.
Všimněte si, v Stav pole, která popisek pro pole přejmenován pořadí, nebyl změněn. Je to proto popisky polí na formulářích pracovní položky jsou zaměřeny na nadřazený týmového projektu a jsou nezávislé na název pole na úrovni serveru pouze zadaný.

Poznámka

Další informace o tom, jak změnit popisky polí ve formulářích pracovní položka, podívejte se na téma Control – referenční dokumentace elementu XML.
Zavřete nové úlohy a zvolte č po zobrazení výzvy k uložení pracovní položky.

Změna sestavu jako hodnota pole

Následující příkaz určuje schopnost vykazovat typ pole data a času AdventureWorks.CreatedOn na dimenzi. Toto pole dat vstupuje do skladu a databází služby Analysis Services, tak, aby jej lze použít k filtrování sestav.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Následující příkaz určuje schopnost vykazovat typ Double pole AdventureWorks.Field k měření. Všechny míry jsou agregaci součet.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Povolit synchronizaci vlastní pole jméno osoby

Následující příkaz povolí synchronizaci pro AW pracovní položky pole. JménoZákazníka pro Collection1 na AdventureWorksServer definována.

Ověřte datový typ pole, které chcete převést

Zkontrolujte datový typ přiřazen k poli, jako je například MyCompany.CustomerName, který chcete synchronizovat zadáním následujícího příkazu:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Povolit synchronizaci

Chcete-li povolit synchronizaci pro pole s názvem osoby, zadejte následující příkaz, nahrazení dat pro argumenty, které jsou uvedeny zde:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
Zobrazí se následující potvrzovací výzvu:

This will change properties for field {0} on the Team Foundation Server. Do you want to continue?
Typ 0 potvrďte, že chcete změnit pole, nebo 1 pro zrušení požadavku.

Pokud je žádost o změnu úspěšná, zobrazí se následující potvrzující zpráva:

The field was updated.

Pokud žádost o změnu nezdaří, zobrazí se chybová zpráva. Mezi nejběžnější chyby, které lze provést jsou pokusu o změnu systému referenční pole nebo pokusu o změnu na pole datový typ jiný než řetězec. Tyto operace nejsou podporovány.

Odstranit pole

Před odstraněním pole, ověřte, zda pole není používán. Je-li toto pole se používá, je nutné odebrat pole z typů pracovní položky, které jej použít před jejím odstraněním z kolekce týmových projektů. Následující příkaz odstraní pole AdventureWorks.Field z Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Ověřte, zda že pole není používán

Zadejte následující příkaz a určíte název odkazu pro pole pracovních položek, například MyCompany.MyProcess.MyField.

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

V informace zobrazené v poli, ověřte, zda hodnota Use je "Not In Use" takto v tomto příkladu.

Field: MyCompany.MyProcess.MyField
Name: MyField
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Pokud Use pole označuje, zda pole se používá, a pak je nutné odstranit z každého typu pracovní položky pro každý týmový projekt, který je uveden v seznamu. Můžete například pole Microsoft.VSTS.TCM.SystemInfo označuje, že ji je používán typy chyb a kód pracovní položky pro čtyři projekty: Arroyo, poušť, Palm a pružiny.
```
Field: Microsoft.VSTS.TCM.SystemInfo
Name: System Info
Type: Html
Reportable As: None
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
Indexed: False
```
Chcete-li odstranit toto pole, je nutné odebrat z každého z uvedených pro každý týmový projekt, pro který je definován typů pracovní položku. Chcete-li odebrat pole, upravte definici pro typ pracovní položky odstraněním FIELD a Control prvky, které obsahují odkaz na název pole. Podívejte se na téma Import, export, and manage work item types [witadmin], FIELD (Definition) element reference, a Control – referenční dokumentace elementu XML.

Odstranit pole z kolekce týmových projektů

Zadejte následující příkaz Odstranit pole MyCompany.MyProcess.MyField a poté zvolte možnost Enter.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Zadejte y ve výzvě k potvrzení tento krok dokončit.

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: přidat vlastní pole, rozevírací seznam vlastní nastavení 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.

Změna atributy pole se nedoporučuje. Chcete-li zjistit, o které úpravy bezpečně můžete provést, a který neměli byste, naleznete v části Přizpůsobit pracovní Sledování zkušeností: dříve, než můžete přizpůsobit, pochopit, údržbu a upgrade důsledky.

Viz také

Koncepty

Resolve schema conflicts that are occurring in the data warehouse

Přidání a změna polí pracovních položek jako podpora tvorby sestav

Work item field reference for Visual Studio ALM

Reportable fields reference for Visual Studio ALM

Další zdroje

witAdmin: Customize and manage objects for tracking work

Sdílet prostřednictvím