witAdmin: Anpassa och hantera objekt för spårningsarbete
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Viktigt!
För den lokala XML-processmodellen kan du använda witadmin för att lista, importera, exportera och ändra en process för ett projekt. För processmodellerna Ärvd och Värdbaserad XML kan du bara använda witadmin för att lista och exportera processinformation. En översikt över processmodeller och vad som stöds finns i Anpassa din arbetsspårningsupplevelse.
Du kan ändra hur du spårar teamets framsteg genom att skapa och anpassa objekt som spårar arbetsobjekt. Med hjälp av kommandoradsverktyget witadmin kan du skapa, ta bort, importera och exportera objekt som kategorier, globala listor, globalt arbetsflöde, typer av länkar och typer av arbetsobjekt. Du kan också ta bort, lista eller ändra attributen för arbetsobjektfält.
För lokala Azure DevOps-servrar kan du dessutom hantera de typer av lösningar, buggar och fel som används med hantering av testfall med kommandot tcm fieldmapping.
Som följande bild visar hanterar du kategorier och typer av och arbetsobjekt för varje projekt. Du hanterar globala listor, typer av länkar och fält i arbetsobjekt för varje projektsamling. Du kan anpassa det globala arbetsflödet för ett projekt eller en samling.
För de flesta kommandon måste du vara medlem i grupperna Projektadministratörer eller Projektsamlingsadministratörer. Mer information finns i Ändra behörigheter på projektsamlingsnivå.
witadmin
Kör kommandoradsverktyget
Om du vill köra witadmin
kommandoradsverktyget öppnar du ett kommandotolkfönster där Visual Studio är installerat. Kommandoradsverktyget witadmin
installeras med valfri version av Visual Studio. Du kan komma åt det här verktyget genom att installera den kostnadsfria versionen av Visual Studio Community eller Visual Studio Team Explorer.
Kommentar
För att ansluta till Azure DevOps Services rekommenderar vi att du använder den senaste versionen av Visual Studio eller Visual Studio Community.
Kommentar
För att ansluta till en lokal server rekommenderar vi att du använder samma eller senare version av Visual Studio som Din Azure DevOps Server. Om du till exempel ansluter till Azure DevOps Server 2019 ansluter du till projektet från en version av Visual Studio 2019.
För Visual Studio 2022
%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
eller Professional
Enterprise
i stället för Community
, beroende på vilken version du har installerat.
För Visual Studio 2019
%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
eller Professional
Enterprise
i stället för Community
, beroende på vilken version du har installerat.
För Visual Studio 2017
%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
eller TeamExplorer
Professional
i stället för Enterprise
, beroende på vilken version du har installerat.
I en 32-bitarsversion av Windows ersätter du %programfiles(x86)% med %programfiles%. Du kan installera Visual Studio Community (som ger åtkomst till Team Explorer) eller Visual Studio Team Explorer 2017 utan kostnad.
Globala parametrar
Du kan använda följande parametrar för att visa hjälptext för witadmin
.
Parameter | Description |
---|---|
/? eller help |
Visar syntaxen och parametrarna witadmin för kommandoradsverktyget. |
command /help eller command /? |
Visar syntaxen och parametrarna för det witadmin kommando som du anger. |
XML-definitionsfiler
Du anpassar alla arbetsspårningsobjekt, till exempel typer av arbetsobjekt, processkonfiguration, globala listor, genom att uppdatera deras XML-definitioner. Om du är nybörjare på anpassning av arbetsspårning kan du läsa Anpassa din arbetsspårningsupplevelse.
Du kör witadmin-kommandon mot Azure DevOps Services eller en lokal Azure DevOps Server. Som du ser i följande kommandolistor stöds endast witadmin-kommandon som listar eller exporterar filer för Azure DevOps Services.
Typer av arbetsobjekt
Arbetsobjekt används för att spåra allt du behöver spåra. Varje arbetsobjekt baseras på en typ av arbetsobjekt. Varje typ av arbetsobjekt definierar de fält som ska lagras i. Vilka typer av arbetsobjekt som är tillgängliga beror på vilken process du använde när projektet skapades (Agile, Scrum, Basic eller CMMI). Mer information finns i Spåra dina arbetsobjekt i Användarberättelser i Azure Boards, problem, buggar, funktioner och epos.
För den ärvda processmodellen kan du lägga till och ta bort typer av arbetsobjekt från webbportalen. Mer information finns i Lägga till och hantera arbetsobjekttyper (arvsprocess).
Kommando
Azure DevOps Services
Azure DevOps Server
destroywitd
: Ta bort en typ av arbetsobjekt
✔️
exportwitd
: Exportera en fil av typen arbetsobjekt
✔️
✔️
importwitd
: Importera en fil av typen arbetsobjekt
✔️
listwitd
: Lista typer av arbetsobjekt
✔️
✔️
renamewitd
: Ändra visningsnamnet för en arbetsobjektstyp
✔️
Fält
Fält används för att spåra status och information som är associerad med arbetsobjekt. Fält definieras för en organisation eller samling. Mer information finns i Fält och attribut för arbetsobjekt. Om du vill söka efter beskrivningen av ett visst fält kan du läsa Fältbeskrivningar för standard- och arbetsobjektfält som används i processmallar.
För den ärvda processmodellen kan du visa och ta bort fält från webbportalen. Mer information finns i Lägga till och hantera fält (arvsprocess).
Kommando
Azure DevOps Services
Azure DevOps Server
deletefield
: Ta bort ett fält
✔️
listfields
: Lista fältattribut
✔️
✔️
changefield
: Ändra ett fältattribut
✔️
renamewitd
: Ändra ett WIT-visningsnamn
✔️
Kategorier
Kategorier associerar en eller flera typer av arbetsobjekt som hör till samma kategori. Azure Boards förlitar sig på standardkategoridefinitioner, varav många anger en enskild typ av arbetsobjekt per kategori. Mer information finns i Använda kategorier för att gruppera arbetsobjektstyper.
Kommando
Azure DevOps Services
Azure DevOps Server
exportcategories
: Exportera filen Categories
✔️
✔️
importcategories
: Importera filen Categories
✔️
Länktyper
Använd olika länktyper för att hantera de olika relationerna mellan arbetsobjekt. För lokala XML- och värdbaserade XML-processmodeller kan du definiera anpassade länktyper. Mer information finns i Länka arbetsobjekt till andra objekt och Referensguide för länktyper.
Kommando
Azure DevOps Services
Azure DevOps Server
deletelinktype
: Ta bort en länktyp
✔️
exportlinktype
: Exportera en länktypsfil
✔️
✔️
listlinktypes
: Lista de definierade länktyperna
✔️
✔️
reactivatelinktype
: Återaktivera eller byta namn på en länktyp
✔️
Globala listor
Globala listor är listrutor som du kan inkludera i ett eller flera fält och definitioner av arbetsobjektstyp. Du kan dela listobjekt mellan flera typer av arbetsobjekt för en samling projekt genom att inkludera listobjekten i ett eller flera GLOBALLIST-element . Mer information finns i GLOBALLIST XML-elementreferens.
Kommando
Azure DevOps Services
Azure DevOps Server
destroygloballist
: Ta bort en global lista
✔️
exportgloballist
: Exportera den globala listan
✔️
✔️
importgloballist
: Importera den globala listan
✔️
listgloballist
: Lista alla globala listnamn
✔️
✔️
Globalt arbetsflöde
Med globalt arbetsflöde kan du definiera och uppdatera fält och globala listor som gäller för alla typer av arbetsobjekt i ett projekt eller en samling. Mer information finns i Referens för XML-element för globala arbetsflöden.
Kommando
Azure DevOps Services
Azure DevOps Server
exportglobalworkflow
: Exportera den globala arbetsflödesfilen
✔️
importglobalworkflow
: Importera den globala arbetsflödesfilen
✔️
Processkonfiguration
Processkonfiguration definierar standardkonfigurationen och funktionsfunktionerna som dina team kan komma åt med hjälp av Azure Boards. Konfigurationen avgör vilka typer av arbetsobjekt som visas i kvarvarande uppgifter för produkten, kvarvarande sprintloggar, Kanban-tavla och aktivitetstavla. Mer information om processkonfiguration och vad du kan anpassa finns i Processkonfiguration.
För den ärvda processmodellen kan du anpassa kvarvarande uppgifter från webbportalen. Mer information finns i Anpassa dina kvarvarande uppgifter eller tavlor (arvsprocess).
Kommando
Azure DevOps Services
Azure DevOps Server
exportprocessconfig
: Exportera Filen ProcessConfiguration
✔️
✔️
importprocessconfig
: Importera filen ProcessConfiguration
✔️
Klientcache
Efter vissa underhållsåtgärder kräver klientdatorer en cacheuppdatering. När du har flyttat, återställt, bytt namn på eller redundansväxlat en datanivå- eller programnivåserver måste du uppdatera cachen för att spåra arbetsobjekt och användarna måste uppdatera versionskontrollcacheminnet på klientdatorerna.
Följande witadmin
kommando är endast tillgängligt för Azure DevOps Server lokalt.
rebuildcache
: Återskapa klientcachen
Fältmappning för testfallshantering
Om du vill anpassa matchningstyper, typ av buggarbetsobjekt och feltyper som används när du arbetar med Azure Test Plans kan du använda följande tcm-kommando . Det här kommandot är endast tillgängligt för lokala Azure DevOps Server-versioner.
tcm fieldmapping
: Importera eller exportera en fil som definierar de lösningstyper, buggar eller feltyper som ska användas med hantering av testfall.