witAdmin: Přizpůsobení a správa objektů pro sledování práce
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.
Způsob sledování průběhu týmu můžete změnit vytvořením a přizpůsobením objektů, které sledují pracovní položky. Pomocí nástroje příkazového řádku witadmin můžete vytvářet, odstraňovat, importovat a exportovat objekty, jako jsou kategorie, globální seznamy, globální pracovní postup, typy odkazů a typy pracovních položek. Můžete také odstranit, vypsat nebo změnit atributy polí pracovních položek.
Kromě toho můžete u místních serverů Azure DevOps spravovat typy řešení, chyby a typy selhání používané se správou testovacích případů pomocí příkazu tcm fieldmapping.
Jak je znázorněno na následujícím obrázku, spravujete kategorie a typy a pracovní položky pro každý projekt. Spravujete globální seznamy, typy odkazů a polí v pracovní položce pro každou kolekci projektů. Globální pracovní postup můžete přizpůsobit pro projekt nebo kolekci.
U většiny příkazů musíte být členem skupin Správci projektů nebo Správci kolekcí projektů. Další informace najdete v tématu Změna oprávnění skupiny na úrovni kolekce projektů.
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.
Globální parametry
Pomocí následujících parametrů můžete zobrazit text nápovědy pro witadmin.
| Parametr | Popis |
|---|---|
/? nebo help |
Zobrazí syntaxi a parametry pro nástroj příkazového witadmin řádku. |
command /helpnebo command /? |
Zobrazí syntaxi a parametry pro witadmin zadaný příkaz. |
Definiční soubory XML
Všechny objekty sledování práce ( například typy pracovních položek, konfigurace procesů, globální seznamy) si přizpůsobíte tak, že aktualizujete jejich definice XML. Pokud s přizpůsobením sledování práce začínáte, přečtěte si téma Přizpůsobení prostředí sledování práce.
Příkazy witadmin spouštíte pro Azure DevOps Services nebo místní Azure DevOps Server. Jak je znázorněno v následujících seznamech příkazů, podporují se pro Azure DevOps Services jenom příkazy witadmin , které vypisují nebo exportují soubory.
Typy pracovních položek
Pracovní položky slouží ke sledování všeho, co potřebujete ke sledování. Každá pracovní položka je založená na typu pracovní položky. Každý typ pracovní položky definuje pole, ve kterých se mají ukládat informace. Dostupné typy pracovních položek závisí na procesu, který jste použili při vytváření projektu (Agile, Scrum, Basic nebo CMMI). Další informace najdete v tématu Sledování pracovních položek v uživatelských příběhy, problémech, chybách, funkcích a námětech ve službě Azure Boards.
Pro model zděděného procesu můžete přidat a odstranit typy pracovních položek z webového portálu. Další informace najdete v tématu Přidání a správa typů pracovních položek (proces dědičnosti).
Příkaz
Služby Azure DevOps
Azure DevOps Server
destroywitd: Odstranění typu pracovní položky
✔️
exportwitd: Export souboru typu pracovní položky
✔️
✔️
importwitd: Import souboru typu pracovní položky
✔️
listwitd: Výpis typů pracovních položek
✔️
✔️
renamewitd: Změna zobrazovaného názvu pro typ pracovní položky
✔️
Pole
Pole slouží ke sledování stavu a informací přidružených k pracovním položkám. Pole jsou definována pro organizaci nebo kolekci. Další informace naleznete v tématu Pole a atributy pracovní položky. Pokud chcete vyhledat popis konkrétního pole, přečtěte si popisy polí pro výchozí pole a pole pracovních položek použitá v šablonách procesů.
U modelu zděděného procesu můžete zobrazit a odstranit pole z webového portálu. Další informace naleznete v tématu Přidání a správa polí (proces dědičnosti).
Příkaz
Služby Azure DevOps
Azure DevOps Server
deletefield: Odstranění pole
✔️
listfields: Atributy polí seznamu
✔️
✔️
changefield: Změna atributu pole
✔️
renamewitd: Změna zobrazovaného názvu WIT
✔️
Kategorie
Kategorie přidružují jeden nebo více typů pracovních položek, které patří do stejné kategorie. Azure Boards spoléhá na výchozí definice kategorií, z nichž mnohé určují jeden typ pracovní položky pro každou kategorii. Další informace naleznete v tématu Použití kategorií k seskupení typů pracovních položek.
Příkaz
Služby Azure DevOps
Azure DevOps Server
exportcategories: Export souboru Kategorie
✔️
✔️
importcategories: Import souboru Kategorie
✔️
Typy propojení
Ke správě různých vztahů mezi pracovními položkami použijte různé typy propojení. U místních modelů procesů XML a hostovaných procesů XML můžete definovat vlastní typy propojení. Další informace najdete v tématu Propojení pracovních položek s dalšími objekty a referenční příručkou pro typy odkazů.
Příkaz
Služby Azure DevOps
Azure DevOps Server
deletelinktype: Odstranění typu odkazu
✔️
exportlinktype: Export souboru typu odkazu
✔️
✔️
listlinktypes: Výpis definovaných typů propojení
✔️
✔️
reactivatelinktype: Opětovná aktivace nebo přejmenování typu odkazu
✔️
Globální seznamy
Globální seznamy jsou seznamy výběru, které můžete zahrnout do jednoho nebo více polí a definic typů pracovních položek. Položky seznamu můžete sdílet mezi několika typy pracovních položek pro kolekci projektů zahrnutím položek seznamu do jednoho nebo více elementů GLOBALLIST . Další informace naleznete v tématu GLOBALLIST XML element reference.
Příkaz
Služby Azure DevOps
Azure DevOps Server
destroygloballist: Odstranění globálního seznamu
✔️
exportgloballist: Export globálního seznamu
✔️
✔️
importgloballist: Import globálního seznamu
✔️
listgloballist: Výpis všech globálních názvů seznamů
✔️
✔️
Globální pracovní postup
Pomocí globálního pracovního postupu můžete definovat a aktualizovat pole a globální seznamy, které platí pro všechny typy pracovních položek v projektu nebo kolekci. Další informace naleznete v tématu Globální pracovní postup XML element referenční dokumentace.
Příkaz
Služby Azure DevOps
Azure DevOps Server
exportglobalworkflow: Export globálního souboru pracovního postupu
✔️
importglobalworkflow: Import globálního souboru pracovního postupu
✔️
Konfigurace procesu
Konfigurace procesu definuje výchozí možnosti konfigurace a funkčnosti, ke kterým mají vaše týmy přístup pomocí Azure Boards. Konfigurace určuje typy pracovních položek, které se zobrazují v backlogu produktu, backlogech sprintů, panelech a panelech Úloh. Další informace o konfiguraci procesu a o tom, co můžete přizpůsobit, naleznete v tématu Konfigurace procesu.
U modelu zděděného procesu můžete přizpůsobit backlogy z webového portálu. Další informace najdete v tématu Přizpůsobení backlogů nebo panelů (proces dědičnosti).
Příkaz
Služby Azure DevOps
Azure DevOps Server
exportprocessconfig: Export souboru ProcessConfiguration
✔️
✔️
importprocessconfig: Import souboru ProcessConfiguration
✔️
Mezipaměť klienta
Po určitých operacích údržby vyžadují klientské počítače aktualizaci mezipaměti. Po přesunutí, obnovení, přejmenování nebo převzetí služeb při selhání serveru datové vrstvy nebo aplikační vrstvy je nutné aktualizovat mezipaměť pro sledování pracovních položek a uživatelé musí aktualizovat mezipaměť správy verzí na klientských počítačích.
Následující witadmin příkaz je k dispozici pouze pro místní Azure DevOps Server.
rebuildcache: Opětovné sestavení mezipaměti klienta
Mapování polí správy testovacích případů
Pokud chcete přizpůsobit typy řešení, typ pracovní položky chyby a typy selhání používané při práci s plány Azure Test, můžete použít následující příkaz tcm . Tento příkaz je k dispozici pouze pro místní verze Azure DevOps Serveru.
tcm fieldmapping: Importujte nebo exportujte soubor, který definuje typy řešení, chyby nebo typy selhání, které se mají použít se správou testovacích případů.