Správa polí pracovních položek
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
PlainTextpole neboHTMLpoleDů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říkazemchangefieldmůž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 Professional Enterprise 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 Professional Enterprise 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 TeamExplorer Professional 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.
- Chcete-li odstranit nebo přejmenovat pole nebo změnit atribut pole, musíte být členem skupiny zabezpečení Team Foundation Administrators nebo skupiny zabezpečení Správci kolekce projektů.
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ávce. 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/CollectionNamePokud 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 true false , ž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
VALIDUSERje určeno pro všechny typy pracovních položek.Pravidlo
VALIDUSERje určeno pro typ pracovní položky.Pravidlo
ALLOWEDVALUESje 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:
- Název , který se zobrazí ve formuláři pracovní položky Viz WebLayout a Control elementy nebo Control XML element reference.
- Text nápovědy Viz Pravidla a vyhodnocení pravidel.
- Povolené hodnoty nebo položky v rozevíracím seznamu nebo rozevírací nabídce. Viz PRVKY ALLOWEDVALUES, SUGGESTEDVALUES a ALLOWEDVALUES XML.
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.IssueInformace 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: FalseParametr 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/DefaultCollectionZobrazí 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 /unusedInformace 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
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"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
V Team Exploreru zvolte
Aktualizovat.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čí.
Zvolte Nový dotaz a vytvořte dotaz.
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í>>.
Odstraňte hodnotu Pořadí z buňky Pole a do buňky zadejte Důležité pořadí .
Vyberte <> v buňce Operátor a do buňky Hodnota zadejte 1.
Na panelu nástrojů Dotaz zvolte
Spustit.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.
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ů.
Zavřete dotaz. Po zobrazení výzvy k uložení dotazu zvolte Ne .
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.
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.
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.
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
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:trueZobrazí se následující potvrzovací výzva:
Tím se změní vlastnosti pole {0} na Team Foundation Serveru. Chcete pokračovat?
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á
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.MyFieldV 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: FalsePokud 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: FalseNež 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
FIELDprvků,Controlkteré 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.