witAdmin: Objecten aanpassen en beheren voor het bijhouden van werk
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Belangrijk
Voor het on-premises XML-procesmodel kunt u witadmin gebruiken om een proces voor een project weer te geven, te importeren, te exporteren en te wijzigen. Voor de overgenomen en gehoste XML-procesmodellen kunt u alleen witadmin gebruiken om procesgegevens weer te geven en te exporteren. Zie Uw ervaring voor het bijhouden van werk aanpassen voor een overzicht van procesmodellen en wat wordt ondersteund.
U kunt wijzigen hoe u de voortgang van uw team bijhoudt door objecten te maken en aan te passen waarmee werkitems worden bijgehouden. Met behulp van het opdrachtregelprogramma witadmin kunt u objecten maken, verwijderen, importeren en exporteren, zoals categorieën, algemene lijsten, globale werkstroom, typen koppelingen en typen werkitems. U kunt ook de kenmerken van werkitemvelden verwijderen, weergeven of wijzigen.
Daarnaast kunt u voor on-premises Azure DevOps-servers de oplossingstypen, bug- en fouttypen beheren die worden gebruikt met testcasebeheer met de tcm-opdracht voor veldmapping.
Zoals in de volgende afbeelding wordt weergegeven, beheert u categorieën en typen en werkitems voor elk project. U beheert globale lijsten, typen koppelingen en velden in werkitem voor elke projectverzameling. U kunt de globale werkstroom voor een project of een verzameling aanpassen.
Voor de meeste opdrachten moet u lid zijn van de groepen Projectbeheerders of Projectverzamelingsbeheerders. Zie Machtigingen op projectverzamelingsniveau wijzigen voor meer informatie.
witadmin Het opdrachtregelprogramma uitvoeren
Als u het witadmin opdrachtregelprogramma wilt uitvoeren, opent u een opdrachtpromptvenster waarin Visual Studio is geïnstalleerd. Het witadmin opdrachtregelprogramma wordt geïnstalleerd met elke versie van Visual Studio. U kunt dit hulpprogramma openen door de gratis versie van Visual Studio Community of Visual Studio Team Explorer te installeren.
Notitie
Als u verbinding wilt maken met Azure DevOps Services, raden we u aan de nieuwste versie van Visual Studio of Visual Studio Community te gebruiken.
Notitie
Als u verbinding wilt maken met een on-premises server, raden we u aan om dezelfde of latere versie van Visual Studio te gebruiken als uw Azure DevOps-server. Als u bijvoorbeeld verbinding maakt met Azure DevOps Server 2019, maakt u vanuit een versie van Visual Studio 2019 verbinding met uw project.
Voor Visual Studio 2022
%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
of Professional Enterprise in plaats van , afhankelijk van Communityde versie die u hebt geïnstalleerd.
Voor Visual Studio 2019
%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
of Professional Enterprise in plaats van , afhankelijk van Communityde versie die u hebt geïnstalleerd.
Voor Visual Studio 2017
%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
of TeamExplorer Professional in plaats van , afhankelijk van Enterprisede versie die u hebt geïnstalleerd.
Vervang %programfiles(x86)% in een 32-bits versie van Windows door %programfiles%. U kunt Visual Studio Community (die gratis toegang biedt tot Team Explorer) of Visual Studio Team Explorer 2017 installeren.
Globale parameters
U kunt de volgende parameters gebruiken om Help-tekst weer te geven voor witadmin.
| Parameter | Description |
|---|---|
/? of help |
Geeft de syntaxis en parameters voor het witadmin opdrachtregelprogramma weer. |
command /helpor command /? |
Geeft de syntaxis en parameters weer voor de witadmin opdracht die u opgeeft. |
XML-definitiebestanden
U kunt alle werktraceringsobjecten, zoals werkitemstypen, procesconfiguratie, globale lijsten, aanpassen door hun XML-definities bij te werken. Zie Uw ervaring voor het bijhouden van werk aanpassen als u geen ervaring hebt met het bijhouden van werk.
U voert witadmin-opdrachten uit voor Azure DevOps Services of een on-premises Azure DevOps-server. Zoals wordt weergegeven in de volgende opdrachtlijsten, worden alleen witadmin-opdrachten die bestanden vermelden of exporteren, ondersteund voor Azure DevOps Services.
Typen werkitems
Werkitems worden gebruikt om alles bij te houden wat u nodig hebt om bij te houden. Elk werkitem is gebaseerd op een type werkitem. Elk type werkitem definieert de velden die beschikbaar zijn voor het opslaan van gegevens. De beschikbare typen werkitems zijn afhankelijk van het proces dat u hebt gebruikt toen uw project werd gemaakt (Agile, Scrum, Basic of CMMI). Zie Uw werkitems bijhouden in Azure Boards-gebruikersverhalen, problemen, bugs, functies en epics voor meer informatie.
Voor het overgenomen procesmodel kunt u werkitemtypen toevoegen en verwijderen uit de webportal. Zie Werkitemtypen toevoegen en beheren (overnameproces) voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
destroywitd: Een werkitemtype verwijderen
✔️
exportwitd: Een werkitemtypebestand exporteren
✔️
✔️
importwitd: Een werkitemtypebestand importeren
✔️
listwitd: Typen werkitems weergeven
✔️
✔️
renamewitd: De weergavenaam voor een werkitemtype wijzigen
✔️
Velden
Velden worden gebruikt om de status en informatie bij te houden die is gekoppeld aan werkitems. Velden worden gedefinieerd voor een organisatie of verzameling. Zie Werkitemvelden en -kenmerken voor meer informatie. Zie Veldbeschrijvingen voor standaard- en werkitemvelden die worden gebruikt in processjablonen om de beschrijving van een specifiek veld op te zoeken.
Voor het overgenomen procesmodel kunt u velden weergeven en verwijderen uit de webportal. Zie Velden toevoegen en beheren (overnameproces) voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
deletefield: Een veld verwijderen
✔️
listfields: Lijstveldkenmerken
✔️
✔️
changefield: Een veldkenmerk wijzigen
✔️
renamewitd: Een wit-weergavenaam wijzigen
✔️
Categorieën
Categorieën koppelen een of meer typen werkitems als behorend tot dezelfde categorie. Azure Boards is afhankelijk van standaardcategoriedefinities, waarvan velen één type werkitem per categorie opgeven. Zie Categorieën gebruiken om werkitemtypen te groeperen voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
exportcategories: Het categorieënbestand exporteren
✔️
✔️
importcategories: Het categorieënbestand importeren
✔️
Koppelingstypen
Gebruik verschillende koppelingstypen om de verschillende relaties tussen werkitems te beheren. Voor on-premises XML- en gehoste XML-procesmodellen kunt u aangepaste koppelingstypen definiëren. Zie Werkitems koppelen aan andere objecten en naslaggids voor koppelingstypen voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
deletelinktype: Een koppelingstype verwijderen
✔️
exportlinktype: Een koppelingstypebestand exporteren
✔️
✔️
listlinktypes: De gedefinieerde koppelingstypen weergeven
✔️
✔️
reactivatelinktype: Een koppelingstype opnieuw activeren of de naam ervan wijzigen
✔️
Algemene lijsten
Algemene lijsten zijn lijsten die u kunt opnemen in een of meer velden en definities van werkitems. U kunt lijstitems delen tussen verschillende typen werkitems voor een verzameling projecten door de lijstitems op te halen in een of meer GLOBALLIST-elementen . Zie GLOBALLIST XML-elementreferentie voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
destroygloballist: Een algemene lijst verwijderen
✔️
exportgloballist: De algemene lijst exporteren
✔️
✔️
importgloballist: De algemene lijst importeren
✔️
listgloballist: Alle algemene lijstnamen weergeven
✔️
✔️
Globale werkstroom
Met een globale werkstroom kunt u velden en algemene lijsten definiëren en bijwerken die van toepassing zijn op alle typen werkitems in een project of verzameling. Zie de naslaginformatie over het XML-element van de algemene werkstroom voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
exportglobalworkflow: Het algemene werkstroombestand exporteren
✔️
importglobalworkflow: Het algemene werkstroombestand importeren
✔️
Procesconfiguratie
Procesconfiguratie definieert de standaardconfiguratie en functionele mogelijkheden waartoe uw teams toegang hebben met behulp van Azure Boards. De configuratie bepaalt de typen werkitems die worden weergegeven op de productachterstand, sprintachterstanden, borden en taskboards. Zie Procesconfiguratie voor meer informatie over procesconfiguratie en wat u kunt aanpassen.
Voor het overgenomen procesmodel kunt u achterstanden aanpassen vanuit de webportal. Zie Uw achterstanden of borden aanpassen (overnameproces) voor meer informatie.
Command
Azure DevOps Services
Azure DevOps Server
exportprocessconfig: Het ProcessConfiguration-bestand exporteren
✔️
✔️
importprocessconfig: Het ProcessConfiguration-bestand importeren
✔️
Clientcache
Na bepaalde onderhoudsbewerkingen vereisen clientcomputers een cachevernieuwing. Nadat u een gegevenslaag- of toepassingslaagserver hebt verplaatst, hersteld, hersteld, hernoemd of een failover hebt uitgevoerd, moet u de cache vernieuwen voor het bijhouden van werkitems en moeten gebruikers de cache voor versiebeheer op clientcomputers vernieuwen.
De volgende witadmin opdracht is alleen on-premises beschikbaar voor Azure DevOps Server.
rebuildcache: De clientcache opnieuw bouwen
Veldtoewijzing voor testcasebeheer
Als u de oplossingstypen, het type werkitem en fouttypen wilt aanpassen die worden gebruikt bij het werken met Azure Test Plans, kunt u de volgende tcm-opdracht gebruiken. Deze opdracht is alleen beschikbaar voor on-premises versies van Azure DevOps Server.
tcm fieldmapping: Importeer of exporteer een bestand dat de oplossingstypen, bug- of fouttypen definieert die moeten worden gebruikt met testcasebeheer.