Sdílet prostřednictvím

Správa polí pracovních položek

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

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.

Nástroj příkazového řádku witadmin poskytuje výkonné funkce pro správu polí pracovních položek v kolekci projektů. Bez ohledu na to, jestli potřebujete přejmenovat pole, upravit datové typy nebo nakonfigurovat synchronizaci se zprostředkovateli identity, vám tyto příkazy poskytují podrobnou kontrolu nad prostředím sledování práce.

Co můžete dělat s příkazy polí witadmin

Pomocí následujících příkazů witadmin můžete spravovat pole napříč všemi typy pracovních položek a projekty v kolekci:

  • changefield: Upravte atributy pole, které použijí kolekci, včetně:
    • Převod datového typu mezi PlainText formáty a HTML formáty

    Důležité

    Při upgradu Azure DevOps Serveru se pole Popis (System.Description) automaticky převede na PlainTextHTML. changefield Pokud je to potřeba, použijte tento příkaz.

    • Popisné názvy zobrazené v dotazech pracovních položek (můžou se lišit od popisků formulářů)
    • Atributy generování sestav pro integraci datového skladu
    • Synchronizace identit s Microsoft Entra ID nebo Active Directory
  • deletefield: Odebrání nepoužívaných polí z kolekce
  • listfields: Zobrazení atributů polí a využití napříč projekty

Tip

  • Pokud chcete přidat globální pole v místních prostředích XML, upravte globální soubor pracovního postupu a naimportujte ho do kolekce.
  • Příkaz witadmin indexfield je zastaralý. Indexování polí probíhá automaticky.

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

Úkol Požadovaná oprávnění
Seznamová pole Zobrazení oprávnění oprávnění na úrovni projektu pro povolení projektu v kolekci
Odstranění nebo přejmenování polí Člen skupiny zabezpečení Správci kolekcí projektů
Změna atributů pole Člen skupiny zabezpečení Správci kolekcí projektů

Další informace najdete v tématu Změna oprávnění skupiny 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. 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.

Syntaxe

Pomocí následujících vzorů syntaxe příkazů můžete spravovat pole pracovních položek pomocí nástroje witadmin:

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.
/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 v Microsoft Entra ID, 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 .

Určete true , že chcete povolit synchronizaci pro datové pole. Určete 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 s Microsoft Entra ID a Active Directory

Nakonfigurujte vlastní pole jmen osob tak, aby se automaticky aktualizovala, když se změní uživatelská jména ve zprostředkovateli identity.

Kdy povolit synchronizaci

Pouze vlastní pole: Synchronizaci musíte povolit ručně pro všechna vlastní pole pracovních položek, která se používají k přiřazení jmen osob.

Systémová pole: Všechna předdefinovaná pole jmen osob mají automaticky povolenou synchronizaci:

  • System.AssignedTo
  • System.ChangedBy
  • System.CreatedBy

Podpora zprostředkovatele identity

Životní prostředí Poskytovatel identity
Služby Azure DevOps Microsoft Entra ID
Azure DevOps Server Active Directory nebo pracovní skupina

Jak funguje synchronizace

Stát Chování
Před povolením Pole zobrazuje statické textové řetězce.
Po povolení Pole zobrazuje aktuální uživatelské jméno od zprostředkovatele identity.
Při změně názvů Pole s automatickou syncnamechanges=true aktualizací

Omezení názvů skupin

Když atribut povolíte syncnamechanges u pole String, přijme platná uživatelská jména, ale nepovolí názvy skupin , pokud platí některá z těchto podmínek:

  • VALIDUSER pravidlo zadané napříč všemi typy pracovních položek
  • VALIDUSER pravidlo určené pro konkrétní typ pracovní položky
  • ALLOWEDVALUES pravidlo zadané s kritérii filtru, které vylučuje skupiny

Obor konfigurace

Důležité

Synchronizaci musíte povolit pro každé pole v každé kolekci projektů, která obsahuje vlastní pole.

Další informace najdete tady:

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á. 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 pak vyberte 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 Editoru dotazů zvolte Kliknutím sem přidejte odkaz na klauzuli pro přidání řádku, vyberte prázdnou buňku Pole a do buňky zadejte Rank. 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 <\<Rank>>.

  4. Odstraňte hodnotu Pořadí z buňky Pole a zadejte Important Rank ji do buňky.

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

  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 sloupce). Vyberte OK.

    Všimněte si, že popisný název pro Microsoft.VSTS.Common. Pořadí se přejmenuje 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 přejmenovaného pole Pořadí nezměnil. Popisky polí ve formulářích pracovních položek jsou vymezeny na nadřazený projekt a jsou nezávislé na zadaném názvu pole pro celý server.

    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 agregují 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

  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 Azure DevOps Serveru. Chcete pokračovat?

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

    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 podporované.

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.

  • Last updated on