Správa polí pracovních položek

Článek
06/09/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 ze starší verze na aktuální verzi typ přiřazení pro popis (System.Description) pole je automaticky převedeno z PlainText k HTML.S changefield příkaz, 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.
Generování sestav 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.

Chcete-li spustit witadmin příkazového řádku 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 12.0\Common7\IDE

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

Přehled polí definovaných v rámci procesu výchozích šablon opatřeného Team Foundation Server, naleznete v části Referenční dokumentace polí pracovních položek pro 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 a Výchozí skupiny, oprávnění a role serveru 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 Definování a úprava polí pracovní položky.
/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 k HTML nebo z HTML k PlainText.Můžete určit tuto možnost pouze u polí, jehož typ přiřazení je PlainText nebo HTML.Další informace naleznete v tématu Referenční dokumentace elementů FIELD (definice).
/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 nastavena 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 Referenční dokumentace polí přiřazení a pracovních postupů.

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, je-li některou z následujících podmínek je true:

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

Další informace naleznete v tématu Referenční dokumentace všech elementů XML FIELD.

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.Další informace naleznete v tématu Control – referenční dokumentace elementu XML.
Text nápovědy.Další informace naleznete v tématu Definice textu nápovědy ve formuláři pracovní položky.
Povolené hodnoty nebo položky v seznamu Výběr nebo v rozevírací nabídce.Další informace naleznete v tématu Přizpůsobení rozevíracího seznamu (rozevírací nabídky) [přesměrováno].

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 Referenční dokumentace polí pracovních položek pro 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.Další informace naleznete v tématu Referenční dokumentace polí pracovních položek pro 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

In Průzkumník týmových projektů, choose Refresh.

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.
On the Query toolbar, choose Run.
Otevřete místní nabídku pro každý řádek v výsledky a vyberte položku možností sloupce.Scroll down in the Availablecolumns list.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).Klikněte na tlačítko 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 Změna popisku pole [přesměrováno].
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 pro 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.Informace naleznete v tématech Import, export a správa typů pracovních položek [witadmin], Referenční dokumentace elementů FIELD (definice) 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

Řešení konfliktů schémat, které se vyskytují v datovém skladu

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

Referenční dokumentace polí pracovních položek pro Visual Studio ALM

Referenční dokumentace polí umožňujících vytvoření sestavy pro Visual Studio ALM

Další zdroje

witAdmin: Přizpůsobení a správa objektů pro sledování práce

Sdílet prostřednictvím