Správa polí pracovních položek

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Důležité

Pro místní model procesu XML můžete použít witadmin k výpisu, importu, exportu a úpravě procesu projektu. Pro modely zděděných a hostovaných procesů XML můžete k výpisu a exportu informací o procesu použít pouze witadmin . Přehled modelů procesů a podporovaných možností najdete v tématu Přizpůsobení prostředí pro sledování práce.

Pole definovaná pro typy pracovních položek, které jsou definovány pro kolekci projektů (místní XML), můžete spravovat pomocí následujících příkazů witadmin . Pokud chcete přidat globální pole (platné pro místní XML), můžete to udělat tak , že upravíte globální soubor pracovního postupu a importujete ho do kolekce.

  • changefield: Změní jeden nebo více atributů pole. Když změníte jeden z následujících atributů, změníte ho pro všechny typy pracovních položek a projekty v kolekci projektů:

    • Datový typ pro PlainText pole nebo HTML pole

      Důležité

      Při upgradu Team Foundation Serveru ze starší verze na aktuální verzi se přiřazení typu pro pole Popis (System.Description) automaticky převede na PlainTextHTML. Příkazem changefield můžete obnovit obsah tohoto pole a zobrazit prostý text.

    • Popisný název , který se zobrazí v dotazu na pracovní položku Tento název se může lišit od názvu zobrazeného ve formuláři pracovní položky.

    • Atributy vytváření sestav, které zahrnují název pole, které se zobrazí v sestavě, název referenční sestavy a typ sestavy.

    • Synchronizace se službou Active Directory – synchronizaci polí jmen osob můžete povolit nebo zakázat.

  • deletefield: Odstraní zadané pole.
  • listfields: Zobrazí seznam atributů pro všechna pole nebo zadané pole.

Poznámka:

Příkaz witadmin indexfield je zastaralý s Azure DevOps Serverem 2019 a novějšími verzemi. Pole indexování se už nevyžadují.

Spuštění nástroje příkazového witadmin řádku

Pokud chcete spustit nástroj příkazového witadmin řádku, otevřete okno příkazového řádku, ve kterém je nainstalovaná sada Visual Studio. Nástroj witadmin příkazového řádku se nainstaluje s libovolnou verzí sady Visual Studio. K tomuto nástroji se dostanete instalací bezplatné verze Visual Studio Community nebo Visual Studio Team Exploreru.

Poznámka:

Pokud se chcete připojit ke službě Azure DevOps Services, doporučujeme použít nejnovější verzi sady Visual Studio nebo Visual Studio Community.

Poznámka:

Pokud se chcete připojit k místnímu serveru, doporučujeme použít stejnou nebo novější verzi sady Visual Studio jako Azure DevOps Server. Pokud se například připojíte k Azure DevOps Serveru 2019, připojte se k projektu z verze sady Visual Studio 2019.

Pro Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

nebo ProfessionalEnterprise místo Community, v závislosti na verzi, kterou jste nainstalovali.

Pro Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

nebo ProfessionalEnterprise místo Community, v závislosti na verzi, kterou jste nainstalovali.

Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

nebo TeamExplorerProfessional místo Enterprise, v závislosti na verzi, kterou jste nainstalovali.

V 32bitové edici systému Windows nahraďte %programfiles(x86)%%programfiles%. Sadu Visual Studio Community (která poskytuje přístup k Team Exploreru) nebo Visual Studio Team Exploreru 2017 si můžete nainstalovat zdarma.

Přehled polí definovaných v rámci výchozí šablony procesu najdete v tématu Index polí pracovní položky.

Tip

Pomocí witadminu můžete importovat a exportovat definiční soubory. Mezi další nástroje, které můžete použít, patří Editor procesů (vyžaduje, abyste nainstalovali verzi sady Visual Studio). Nainstalujte editor šablon procesů ze sady Visual Studio Marketplace.

Požadavky

  • Pokud chcete zobrazit pole seznamu, musíte mít oprávnění k zobrazení informací na úrovni projektu pro projekt v kolekci nastavenou na Povolit.
  • Pokud chcete odstranit nebo přejmenovat pole nebo změnit atribut pole, musíte být členem skupiny zabezpečení Team Foundation Správa istrators nebo skupiny zabezpečení Kolekce projektů Správa istrators.

Další informace naleznete v tématu Změna oprávnění na úrovni kolekce projektů.

Poznámka:

I když se přihlásíte pomocí oprávnění správce, musíte otevřít okno příkazového řádku se zvýšenými oprávněními, abyste mohli tuto funkci provést na serveru se systémem Windows Server 2008. Pokud chcete otevřít okno příkazového řádku se zvýšenými oprávněními, zvolte Start, otevřete místní nabídku příkazového řádku a pak zvolte Spustit jako Správa istrator. Další informace naleznete na webu společnosti Microsoft: Řízení přístupu uživatele.

Syntaxe

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 listfields /collection:CollectionURL /n:RefName [/unused]

Parametry

Parametr Popis
/collection:CollectionURL Určuje identifikátor URI kolekce projektů. Příklad:

Místní formát:http://ServerName:Port/VirtualDirectoryName/CollectionName
Pokud se nepoužívá žádný virtuální adresář, použijte následující formát: http://ServerName:Port/CollectionName.
/n:RefName
/n:Name		 Název odkazu pole typu pracovní položky.
/index Určuje povolení nebo zakázání indexování pro zadané pole. Pokud chcete povolit indexování a vypnout, zakažte indexování.
/name:NewName Určuje nový název pole.
/syncnamechanges Určuje použití pole pracovní položky k ukládání názvů a aktualizaci při změnách ve službě Active Directory nebo pracovní skupině. Tato možnost je platná pouze v případě, že je pro danou možnost zadáno pole s datovým typem typenameString .

Zadejte, chcete-li povolit synchronizaci pro datové pole, určete truefalse , že chcete zakázat synchronizaci pro datové pole.
/reportingname:ReportingName Určuje název pole v datovém skladu, které se má použít k vytváření sestav.
/reportingrefname:ReportingRefName Určuje název odkazu pole v datovém skladu, které se má použít k vytváření sestav.
/reportingtype:Type Určuje způsob použití pole ve skladu pro generování sestav. Platné jsou následující hodnoty:

- dimension: Používá se pro pole Integer, String nebo DateTime.
- detail: Používá se pro pole Integer, Double, String nebo DateTime.
- measure: Používá se pro celočíselná a dvojitá pole. Výchozí typ agregace je součet. Pomocí parametru vzorce můžete zadat jiný typ agregace.
- none: Slouží k zakázání možnosti sestavy v poli.

Další informace naleznete v tématu O polích a atributech pracovních položek.
/reportingformula:Formula Určuje agregační vzorec, který se má použít, když je pole hlášeno measurejako . Jediným podporovaným vzorcem je sum.
/type:HTML | PlainText Určuje převod obsahu pole z PlainText do HTML nebo z HTML do PlainText. Tuto možnost můžete zadat pouze pro pole, jejichž typ přiřazení je PlainText nebo HTML. Viz odkaz na element FIELD (Definition).
/unused Zobrazí seznam všech polí, která nejsou používána žádným projektem definovaným v kolekci projektů.
/noprompt Zakáže výzvu k potvrzení.
/? nebo help Zobrazí nápovědu k příkazu v okně příkazového řádku.

Synchronizace jmen osob se službou Active Directory

Je nutné ručně povolit synchronizaci všech polí vlastních pracovních položek, která slouží k přiřazení jmen osob, které odkazují na službu Active Directory. Synchronizaci musíte povolit pro každé pole pro každou kolekci projektů, která obsahuje vlastní pole.

Všechna systémová referenční pole, která zobrazují jména osob, mají atribut syncnamechanges nastavený na true. Tato pole zahrnují System.AuthorizedAs, System.AssignedTo, System.ChangedBy a System.CreatedBy. Synchronizace je povolena pro každé pole jména osoby, které je definováno v jedné z výchozích šablon procesů. Další informace naleznete v tématu Přiřazení a pole pracovního postupu.

Po povolení synchronizace se v poli už nezobrazuje statický řetězec. Místo toho se v poli zobrazí název přidružený k uživatelskému účtu. Když změníte uživatelské jméno ve službě Active Directory nebo pracovní skupině, zobrazí se true v poli s nastaveným syncnamechanges nastavením automaticky nový název.

Když přiřadíte syncnamechanges atribut poli String, pole vždy přijímá platná uživatelská jména. Toto pole ale neumožňuje názvy skupin, které jsou uložené na Team Foundation Serveru nebo ve službě Active Directory, pokud je trueněkterá z následujících podmínek:

  • Pravidlo VALIDUSER je určeno pro všechny typy pracovních položek.

  • Pravidlo VALIDUSER je určeno pro typ pracovní položky.

  • Pravidlo ALLOWEDVALUES je určeno pro typ pracovní položky a toto pravidlo má kritéria filtru, která vylučuje skupiny.

    Další informace naleznete v tématu Všechny prvky POLE.

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

Změnou definice typu pracovní položky, ve které se toto pole zobrazí, změníte následující atributy nebo hodnoty definované pro pole:

Příklady

Pokud není uvedeno jinak, platí v každém příkladu následující hodnoty:

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

Pole seznamu

Umožňuje witadmin listfields zobrazit sadu polí, která se používají, a vybrat pole, která chcete přidat k typu pracovní položky. Můžete také zobrazit seznam přiřazení atributů definovaných pro konkrétní pole a určit, která pole se používají pro které projekty.

Zobrazení atributů pole pracovní položky

  • Zadáním následujícího příkazu zobrazíte seznam atributů definovaných pro zadané pole, například Microsoft.VSTS.Common.Issue.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue

    Informace o poli a atributu se zobrazí pro pojmenované pole, 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

    Parametr Use označuje název každého projektu a typ pracovní položky, kde se pole používá. Další informace o atributech polí naleznete v tématu Index polí pracovní položky.

Výpis všech polí v kolekci projektů

  • Zadáním následujícího příkazu zobrazíte seznam všech polí definovaných pro kolekci projektů.

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

    Zobrazí se informace o poli pro všechna pole pro pojmenovanou kolekci projektů. Viz Index polí pracovních položek.

Seznam polí, která se nepoužívají

  • Zadáním následujícího příkazu zobrazíte seznam polí, která se už v kolekci projektů nepoužívají žádným typem pracovní položky.

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

    Informace o poli a atributu se zobrazí pro každé pole, které se nepoužívá, 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 pole pracovní položky tak, aby splňoval zásady vytváření názvů, které váš tým používá. Všimněte si, že nový název se použije u všech typů pracovních položek, které odkazují na změněné pole ve všech projektech v kolekci projektů. Popisný název se zobrazí, když v dotazu na pracovní položku definujete kritéria filtru. Název, který se zobrazí ve formuláři pracovní položky, se může lišit od popisného názvu definovaného pro dané pole.

Přejmenování pole pracovní položky

  1. Zadáním následujícího příkazu přejmenujte popisný název přiřazený k důležitému Microsoft.VSTS.Common.Rankpořadí.

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

  2. V potvrzovací výzvě zadejte y a stiskněte enter. Počkejte, až se zobrazí následující zpráva:

    Pole bylo přejmenováno.

Ověření změn importovaných do jednoho projektu

  1. V Team Exploreru zvolte AktualizovatAktualizovat.

    Nejnovější aktualizace se stáhnou ze serveru, které zahrnují změny, které jste právě provedli v názvu pole. Počkejte několik sekund, než se aktualizace dokončí.

  2. Zvolte Nový dotaz a vytvořte dotaz.

  3. V Editor Power Query zvolte kliknutím sem odkaz na klauzuli pro přidání řádku, vyberte prázdnou buňku Pole a do buňky zadejte Pořadí. Následující zpráva, která se zobrazí nad seznamem výsledků. Tato zpráva označuje, že pořadí nelze najít.

    Spuštěním dotazu zobrazíte výsledky dotazu. TF51005: Dotaz odkazuje na pole, které neexistuje. Příčinou chyby je <<pořadí>>.

  4. Odstraňte hodnotu Pořadí z buňky Pole a do buňky zadejte Důležité pořadí .

  5. Vyberte <> v buňce Operátor a do buňky Hodnota zadejte 1.

  6. Na panelu nástrojů Dotaz zvolte Spustit dotazSpustit.

  7. Otevřete místní nabídku pro libovolný řádek ve výsledcích a vyberte Možnosti sloupce. Posuňte se dolů v seznamu Dostupné sloupce . Všimněte si, že pole Pořadí již neexistuje, ale pole Důležité pořadí je k dispozici.

  8. V poli Dostupné sloupce vyberte Důležité pořadí a pak zvolte > tlačítko (přidat vybrané sloupce). Vyberte 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 rámci tvůrce dotazů a seznamu výsledků.

  9. Zavřete dotaz. Po zobrazení výzvy k uložení dotazu zvolte Ne .

  10. Vytvořte novou pracovní položku úkolu. Zvolte odkaz Nové pracovní položky a pak zvolte Úkol.

    Tato pracovní položka se vytvoří z typu pracovní položky, kterou jste změnili a naimportovali.

  11. Všimněte si, že v poli Stav se popisek pro přejmenované pole Pořadí nezměnil. Důvodem je to, že popisky polí ve formulářích pracovních položek jsou vymezeny na nadřazený projekt a jsou nezávislé na názvu pole pro celý server, který je právě zadán.

    Poznámka:

    Další informace o tom, jak změnit popisky polí ve formulářích pracovních položek, naleznete v tématu Referenční informace o ovládacím prvku XML.

  12. Zavřete nový úkol a po zobrazení výzvy k uložení pracovní položky zvolte Ne .

Změna sestavy jako hodnoty pole

Následující příkaz určuje možnost hlásit typ pole DateTime AdventureWorks.CreatedOn dimenze. Data tohoto pole zadávají databáze skladu a služby Analysis Services, aby je bylo možné 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 možnost hlásit typ pole AdventureWorks.Field k měření. Všechny míry jsou agregovány podle součtu.

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

Povolení synchronizace vlastního pole s názvem osoby

Následující příkaz povolí synchronizaci pro pole pracovní položky AW. CustomerName definované pro Kolekci1 na AdventureWorksServer.

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

  1. Ověřte datový typ přiřazený k poli, 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

Povolení synchronizace

  1. Pokud chcete povolit synchronizaci pro pole pojmenované osobou, zadejte následující příkaz a nahraďte data argumenty, které jsou zde uvedené:

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true

  2. Zobrazí se následující potvrzovací výzva:

    Tím se změní vlastnosti pole {0} na Team Foundation Serveru. Chcete pokračovat?

  3. Zadáním 0 potvrďte, že chcete změnit pole, nebo 1 pro zrušení žádosti.

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

    Pole bylo aktualizováno.

    Pokud žádost o změnu selže, zobrazí se chybová zpráva. Nejběžnější chyby, které je možné provést, se snaží změnit systémové referenční pole nebo se snaží změnit pole jiného datového typu než String. Tyto operace nejsou podporovány.

Odstranění pole

Před odstraněním pole ověřte, že se toto pole nepoužívá. Pokud se pole používá, musíte nejprve odebrat pole z typů pracovních položek, které ho používají před odstraněním z kolekce projektů. Následující příkaz odstraní pole AdventureWorks.Field z kolekce1:

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

Ověření, že se pole nepoužívá

  1. Zadejte následující příkaz a zadejte název odkazu pro pole pracovní položky, například MyCompany.MyProcess.MyField.

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

    V informacích zobrazených pro pole ověřte, že hodnota use je "Není používána", jak je uvedeno v tomto příkladu.

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

  2. Pokud pole Použít označuje, že se pole používá, musíte ho odstranit z každého typu pracovní položky pro každý uvedený projekt. Pole například označuje, Microsoft.VSTS.TCM.SystemInfo že ho používají typy pracovních položek Bug and Code Defect pro čtyři projekty: Arroyo, Desert, Palm a Springs.

    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

    Než budete moct toto pole odstranit, musíte ho odebrat z každého z typů pracovních položek uvedených pro každý projekt, pro který je definován. Chcete-li pole odebrat, upravíte definici typu pracovní položky odstraněním FIELD prvků, Control které obsahují název odkazu na pole. Viz Import, export a správa typů pracovních položek, FIELD (Definition) odkaz na element a Control.

Odstranění pole z kolekce projektů

Zadejte následující příkaz, který pole odstraní MyCompany.MyProcess.MyField , a pak zvolte Enter.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName

Zadáním y na potvrzovací výzvu dokončete tento krok.