Správa polí pracovních položek

Článek
03/22/2013

Typ pole na pracovní položky, které jsou definovány pro kolekci týmového projektu pomocí následujících můžete spravovat witadmin příkazy:

changefield: Jeden nebo více atributů pole se změní.Změníte-li jeden z následujících atributů, změní pro všechny typy položek práce a týmové projekty v rámci kolekce týmového projektu:

Datový typ pro PlainText nebo HTML pole.

Důležité
Při upgradu Team Foundation Server z předchozí verze na aktuální verzi přiřazení typu Popis (System.Description) automaticky převedena z PlainText na HTML.Se changefield příkazu, můžete obnovit obsah tohoto pole k zobrazení prostého textu.

Popisný název , které má zobrazit v dotazu položky práce.Tento název se může lišit od barvy zobrazené na formulář pracovní položky.
Vykazování atributy obsahující název pole, jak je uveden v sestavě, odkaz na název sestavy a typ výkaznictví.
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í nebo vypnutí zadaného pole.Povolíte-li indexování pole, může zvýšit výkon vyhledávání pracovních položek, jejichž dotazy určete pole.Je-li přidat vlastní pole, které můžete použít v mnoha dotazů pracovní položky, můžete povolit indexování pro dané pole.
listfields: Seznam atributů pro všechna pole nebo zadaného pole.

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%\Microsoft Visual Studio 11.0\Common7\IDE

64Bitové edice systému Windows nahradit %programfiles% s %programfiles(x86)%.

Přehled polí definovaných v rámci výchozích šablon procesu s Team Foundation Server, viz Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

[!POZNÁMKA]

Můžete vytvářet a upravovat pole položky pracovní proces editoru nástroj power tool pro Visual Studio.Tento nástroj není podporován.Další informace získáte na následující stránce na webu společnosti Microsoft: Team Foundation Server nářadí.

Požadavky

Seznam polí, musí mít vaše zobrazení informací na úrovni projektu nastavte oprávnění pro týmového projektu v kolekci Povolit.
Chcete-li odstranit nebo přejmenovat pole nebo změnit atribut pole, musíte být členem Správci serveru Team Foundation skupina zabezpečení nebo Správci kolekcí projektů skupiny zabezpečení.

Další informace naleznete v tématu Team Foundation Oprávnění serveru a Team Foundation Výchozí skupiny serveru, oprávnění a role.

[!POZNÁMKA]

I v případě, že přihlásíte s oprávněním správce, je nutné otevřít se zvýšenými oprávněními okno příkazového řádku, chcete-li provést tuto funkci na serveru se systémem Windows Server 2008.Otevření okna příkazového řádku se zvýšenými oprávněními, zvolte Start, spusťte příkazového řádku místní nabídce a potom zvolte Spustit jako správce.Další informace naleznete na webu společnosti Microsoft: Řízení uživatelských účtů.

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	Description
/collection:CollectionURL	Určuje identifikátor URI kolekce týmového projektu.Formát identifikátoru URI je následující: http://název_serveru: port/název_virtuálního_adresáře/Název_kolekce Pokud není virtuální adresář, formát pro identifikátor URI je následující: http://Název_serveru: port / Název_kolekce
/n:RefName /n:Name	Název odkazu pole položky typu práce.
/index	Určuje, zda chcete povolit nebo zakázat indexování pro zadané pole.Zadejte on Chcete-li povolit indexování a off Chcete-li zakázat indexování.
/name:NewName	Určuje nový název pole.
/syncnamechanges	Určuje, že práce položky pole použít k ukládání jmen a aktualizace, jakmile jsou změny ve službě Active Directory nebo k pracovní skupině.Tato možnost je platná pouze v případě, že pole s datovým typem String je určen pro typename. Zadejte true Chcete-li povolit synchronizaci pro datové pole, zadejte false Chcete-li zakázat synchronizaci pro datové pole.
/reportingname:ReportingName	Určuje název pole v úložišti dat, které mají být použity pro vytváření sestav.
/reportingrefname:ReportingRefName	Určuje název odkazu na pole do datového skladu pro vykazování.
/reportingtype:Type	Určuje, jak toto pole se používá ve skladu pro vykazování.Platné jsou následující hodnoty: dimension:Používá se pro pole celé číslo, řetězec nebo datum a čas. detail:Používá se pro pole Integer, Double, řetězec nebo datum a čas. measure:Použít pro dvojitého pole a celé číslo.Výchozí typ agregace je součet.Můžete nastavit jiný typ agregace pomocí formula parametr. disable:Sloužící k zakázání reportability na pole. Další informace naleznete v tématu Práce s poli pracovní položky.
/reportingformula:Formula	Určuje agregace vzorec, který chcete použít, pokud je toto pole hlášeno jako measure.Jediným podporovaným vzorec je sum.
/type:HTML \| PlainText	Určuje, že převést obsah tohoto pole z PlainText na HTML nebo z HTML na PlainText.Můžete určit tuto možnost pouze u polí, jejichž typ přiřazení je PlainText nebo HTML.Viz téma Prvek pole (definice).
/unused	Seznam všech polí, které nejsou používány žádné týmového projektu definované v kolekci týmového projektu.
/noprompt	Zakáže výzvu k potvrzení.
/?or help	Zobrazí nápovědu k příkazu v okně Příkazový řádek.

Poznámky

Indexovaná pole

Index dotazu je založeno na těchto polí, které mají indexování povolena.Tento index zvyšuje dobu odezvy při spouštění dotazů, které obsahují indexovaná pole.

Ve výchozím nastavení, jsou indexovány následující pole: přiřazeno, datum vytvoření, změnil stav, důvod, ID oblasti, ID iterace a položky typu práce.Pokud existují další pole, které tým často používá v jejich dotazy, můžete je přidat do indexu dotazu.

Synchronizace s adresářem Active Directory jména osob

Synchronizace všechna pole položky vlastní práce, která slouží k přiřazení jména osob, které odkazují na službě Active Directory, musíte povolit ručně.Je nutné povolit synchronizaci pro každé pole pro jednotlivé kolekce týmového projektu, který obsahuje vlastní pole.

Všechna pole referenční systém, zobrazující jména osob mají atribut syncnamechanges nastavena na true. Tato pole obsahují System.AuthorizedAs, System.AssignedTo, System.ChangedBy a System.CreatedBy. Synchronizace povolena pro každé pole název osoby, která je definována v jednom z výchozích šablon procesu.Další informace naleznete v tématu Referenční dokumentace polí přiřazení a pracovních postupů.

Po povolení synchronizace pole již ukazuje statické řetězec.Místo toho pole zobrazí název přidruženého uživatelského účtu.Pokud změníte název uživatele 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 atribut řetězce pole, pole vždy přijímá platná uživatelská jména.Pole však neumožňuje názvy skupin, které jsou uloženy v Team Foundation Server nebo ve službě Active Directory v případě, že některá z následujících podmínek je true:

Je stanoveno pravidlo VALIDUSER přes všechny typy pracovních položek
VALIDUSER pravidlo je určen pro položky typu práce
ALLOWEDVALUES pravidlo je určen pro položky typu práce a toto pravidlo má kritéria filtru, které vylučuje skupin

Další informace naleznete v tématu Všechny referenční elementy jazyk XML pole.

Atributy, že se může měnit pro každý typ položky práce

Můžete změnit následující atributy nebo hodnoty, které jsou definované pro pole tak, že změníte definici pracovní položky typu, ve kterém se zobrazí pole:

Název , které má zobrazit na formulář pracovní položky.Viz téma Odkaz Element jazyk XML řízení.
Text nápovědy.Viz téma Definice textu nápovědy pro pole pracovní položky.
Povolené hodnoty nebo položky v seznamu nebo rozevíracího seznamu.Viz téma Definice vlastních seznamů, rozevíracích seznamů a globálních seznamů.

Příklady

Pokud není stanoveno jinak, platí následující hodnoty v obou příkladech:

Identifikátor URI pro kolekce týmového projektu: http://AdventureWorksServer:8080/tfs/DefaultCollection
Pracovní položka pole jméno: AdventureWorks.Field
Výchozí kódování: UTF-8

Seznam polí

Použít witadmin listfields Chcete-li zobrazit sadu polí používá k výběru jedné přidat položky typu práce.Můžete také uvést atribut přiřazení určitého pole a určit, která pole jsou používány které týmové projekty.

Zobrazit atributy položky pole práce

Zadejte následující příkaz k zobrazení seznamu atributy definované pro zadané pole, například Microsoft.VSTS.Common.Issue.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Jak je znázorněno v tomto příkladu, zobrazí se pole s názvem pole a atribut informace.
```
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ého projektu a položky typu práce, kde je toto pole použito.Další informace o atributech polí naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

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

Zadáním následujícího příkazu zobrazíte seznam všech polí, které jsou definovány pro kolekci týmového projektu.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
Zobrazí se informace o pole pro všechna pole pro kolekci s názvem projektu.Viz téma Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

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

Zadejte následující příkaz pro zobrazení seznamu polí, které jsou již používány v kolekce týmového projektu všechny položky typu práce.

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

Informace o poli a atribut se zobrazí pro každé pole, které není používán, 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

Můžete změnit popisný název položky pole práce podle názvů, které používá váš tým.Všimněte si, že nový název platí pro všechny typy položek práce, které odkazují na změněné pole ve všech projektech týmu v kolekci projektu.Popisný název se zobrazí při definování kritérií filtru v dotazu položky práce.Název, který se objeví na formulář pracovní položka může být jiný než popisný název pro dané pole definovány.

Chcete-li přejmenovat pole položku práce

Zadejte následující příkaz Přejmenovat na 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.Počkejte, až se zobrazí následující zpráva:

Field renamed.

Chcete-li ověřit změny, které jsou importovány do jednoho projektu

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

Nejnovější aktualizace budou staženy ze serveru, které obsahují změny, které jste právě vytvořili, do pole název.Počkejte několik sekund na dokončení aktualizace.
Zvolte Nový dotaz k vytvoření dotazu.
V editoru dotazu zvolte Kliknutím sem přidáte klauzuli odkaz Přidat řádek, vyberte slepý pole buňky a buňky, zadejte pořadí.Následující zpráva, která se zobrazí nad seznamem výsledků.Tato zpráva znamená, že pořadí nebyl nalezen.

Spuste dotaz, který chcete zobrazit ve výsledcích dotazu. TF51005: Dotaz odkazuje na pole, která neexistuje.Chyba je způsobena << pořadí >>.
Odstranit hodnotu seřadit od pole buněk a zadejte do buňky důležité pořadí.
Vyberte < > v operátor buněk a zadejte 1 do hodnoty buňky.
Na dotaz nástrojů, zvolte Spustit.
Otevření místní nabídky pro všechny řádky ve výsledcích a vyberte Možnosti.Posun dolů k dispozicisloupce seznamu. Všimněte si, že pořadí pole je již k dispozici, ale Důležité pořadí pole je k dispozici.
Vyberte Důležité pořadí v sloupce k dispozici pole a pak zvolte > tlačítko (Přidat vybrané sloupce).Klepněte na tlačítko OK.

Všimněte si, že popisný název pro Microsoft.VSTS.Common.Rank byl přejmenován z pořadí na důležité pořadí v celém seznamu tvůrce a výsledky dotazu.
Zavřete dotaz.Zvolte č při se zobrazí výzva k uložení dotazu.
Vytvoření nové pracovní položky úkolu.Zvolte Nové pracovní položky propojit a pak zvolte úkol.

Tato pracovní položka je vytvořena z položky typu práce, který změní a importovat.
Všimněte si, v Stav pole, která na popisky přejmenované pole, pořadí, nebyl změněn.Důvodem je skutečnost, že popisky polí ve formulářích položky práce mají rozsah nadřazeného projektu týmu a jsou nezávislé na právě zadaný název pole na úrovni serveru.

[!POZNÁMKA]

Další informace o tom, jak změnit popisky polí ve formulářích položky práce, viz Změna popisku pole.
Zavřete nový úkol a zvolte č Pokud se výzva k uložení pracovní položky.

Změnit sestavu jako hodnoty pro pole

Následující příkaz určuje schopnost vykazovat typ pole data a času AdventureWorks.CreatedOn dimenzi.Data tohoto pole zadá skladu a databáze 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šechna opatření jsou agregovány součtu.

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 AW pracovní položky pole.Pole KontaktníOsoba definované pro Collection1 na AdventureWorksServer.

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

Ověřte typ dat, který je přiřazen do pole, 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, nahrazování 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í výzva k potvrzení:

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
Typ 0 k potvrzení, že chcete změnit pole, nebo 1 požadavek zrušit.

Pokud je požadavek na změnu úspěšný, zobrazí se následující zpráva potvrzení:

The field was updated.

Je-li požadavek na změnu nezdaří, zobrazí se chybová zpráva.Mezi nejběžnější chyby, které mohou být provedeny jsou pokusu o změnu systému referenční pole nebo jste se pokoušeli změnit pole datového typu než řetězec.Tyto operace nejsou podporovány.

Odstranění pole

Před odstraněním pole ověřte, zda se právě nepoužívá pole.Je-li pole se používá, je třeba nejprve odebrat pole z položky typy práce, které používají před odstraněním z kolekce týmového projektu.Následující příkaz odstraní z Collection1 pole AdventureWorks.Field:

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

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

Zadejte následující příkaz, zadání názvu odkazu pro pracovní položky pole, například MyCompany.MyProcess.MyField.

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

Informace zobrazené pole, ověřte, zda je hodnota parametru 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, že pole se používá, pak je nutné odstranit z každého typu pracovní položky pro každý projekt týmu, který je uveden v seznamu.Například pole Microsoft.VSTS.TCM.SystemInfo označuje, že ji používá typy chyb a kód pracovní položky pro čtyři projekty: Arroyo, poušť, Palm a pružin.
```
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
```
Před odstraněním tohoto pole je nutné jej odebrat ze všech typů položek práce uvedených pro každý projekt týmu, u kterého je definován.Chcete-li odebrat pole, upravte definici pro položky typu práce odstraněním FIELD a Control prvky, které obsahují odkaz na název pole.See Přizpůsobení a správa typů pracovních položek [witadmin], Prvek pole (definice), and Odkaz Element jazyk XML řízení.

Odstranění pole z kolekce týmového projektu

Zadejte následující příkaz pro odstranění pole MyCompany.MyProcess.MyField a potom zvolte Enter.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Zadejte y na výzvu k potvrzení a dokončení tohoto kroku.

Viz také

Koncepty

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

Přidání a úpravy polí pracovních položek jako podpora tvorby sestav

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

Hodné pole odkazu sady Visual Studio ALM

Další zdroje

witAdmin: Přizpůsobení a správa objektů pro sledování pracovních položek

Sdílet prostřednictvím