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.

Konceptbild av arbetsobjektspårningsobjekt.

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 ProfessionalEnterprise 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 ProfessionalEnterprise 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 TeamExplorerProfessional 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

✔️


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.