wit Beheer: Objecten aanpassen en beheren voor het bijhouden van werk

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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.

Conceptual image of Work Item Tracking Objects.

Voor de meeste opdrachten moet u lid zijn van de groepen Project Beheer istrators of Project Collection Beheer istrators. 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 ProfessionalEnterprise 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 ProfessionalEnterprise 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 TeamExplorerProfessional 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 /help
of
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

✔️

✔️

indexfield: Veldindexering in-/uitschakelen

✔️

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

✔️


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

✔️

✔️

importlinktype: Een koppelingstypebestand importeren

✔️

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, Kanbanbord en taakbord. 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

✔️


Werkitems

De volgende witadmin-opdracht is alleen beschikbaar voor TFS 2018.1 en eerdere versies. Het is afgeschaft voor TFS 2018.2 en nieuwere versies. Zie Werkitems verwijderen, verwijderen of herstellen voor meer informatie over het permanent verwijderen van werkitems voor latere versies.

  • destroywi: Werkitems permanent verwijderen

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.