Delen via


Werkitems verwijderen, verwijderen of herstellen in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Werkitems kunnen permanent in uw gegevensarchief voor werkbewaking blijven. U hoeft ze nooit te verwijderen. U kunt echter een beheerproces voor werkitems instellen voor een van de volgende acties:

Aanbeveling

U kunt AI gebruiken om u te helpen met deze taak later in dit artikel, of zie AI-hulp inschakelen met Azure DevOps MCP Server om aan de slag te gaan.

Action Description
Status wijzigen Verwijder werkitems uit weergave op achterstanden en borden door de status van het werkitem te wijzigen in Verwijderen of Knippen. De status die voor u beschikbaar is, is gebaseerd op de werkstroom die is toegewezen aan het type werkitem.
Verwijderen Werkitems verwijderen uit achterstanden, borden en query's. Verwijderde werkitems worden verplaatst naar een Prullenbak.
Herstellen Herstel de verwijderde werkitems door ze terug te halen uit de Prullenbak.
Destroy Werkitems definitief verwijderen, inclusief alle gegevens uit het gegevensarchief voor het bijhouden van werk.

Note

Zie Werkitems verplaatsen en werkitemtype wijzigen als u een werkitem van het ene project naar het andere project wilt verplaatsen of als u het type werkitem wilt wijzigen.

Prerequisites

Category Requirements
Algemene toegang - Werkitems verplaatsen, verwijderen en herstellen: Lid van de groep Inzenders
- Werkitems definitief verwijderen: Lid van de Project Administrators groep of de vereiste machtiging verleend
- Gebruikers met toegang tot belanghebbenden kunnen de inhoud van de Prullenbak bekijken, maar kunnen items niet herstellen of definitief verwijderen, ongeacht de machtigingen die zijn verleend
Status wijzigen in Verwijderen of Knippen - Areapad-permissie ingesteld op Toestaan: Bewerk werkitems in dit knooppunt
- Leden van de groep Inzenders hebben standaard deze machtiging
Werkitems verwijderen en herstellen - Project-machtiging ingesteld op Allow: Werkitems verwijderen en herstellen
- Ten minste basistoegang
- Leden van de groep Inzenders hebben standaard deze machtiging
Werkitems permanent verwijderen of vernietigen - Project machtigingsniveau ingesteld op Allow: Werkitems definitief verwijderen
- Leden van de groep Project Administrators hebben standaard deze machtiging
Werkitems verwijderen of vernietigen via de opdrachtregel - Project machtigingsniveau ingesteld op Allow: Werkitems definitief verwijderen
- Leden van de groep Project Administrators hebben standaard deze machtiging

Zie Machtigingen en toegang voor een vereenvoudigde weergave van machtigingen die zijn toegewezen aan ingebouwde groepen.

Note

Gebruikers met toegang tot belanghebbenden voor een openbaar project hebben volledige toegang tot alle functies voor het bijhouden van werk, net als gebruikers met basistoegang . Voor meer informatie, zie Snelle referentie voor toegang voor belanghebbenden.

Meerdere werkitems verwijderen of verwijderen

U kunt reageren op afzonderlijke werkitems of meerdere werkitems bulksgewijs wijzigen.

Vanuit de webportal kunt u meerdere werkitems selecteren op een backlog- of queryresultatenpagina. U kunt ook een bulkupdate uitvoeren met behulp van de bijbehorende functie. Zie Werkitems bulksgewijs wijzigen als u meerdere werkitems tegelijk wilt verwijderen of herstellen.

U kunt ook werkitems in batch verwijderen of vernietigen met een REST API. Zie Werkitems - Verwijderen voor meer informatie.

Note

Deze functie is beschikbaar vanaf Azure DevOps Server 2022.1.

Werkitems verwijderen

Wanneer u de status van een werkitem wijzigt in Verwijderd, verwijdert u het in feite uit een achterstands- of bordweergave: product-, portfolio- en sprintachterstanden, borden en Taskboards. De status Verwijderd komt overeen met de status van de categorie Verwijderde werkstroom. Als u aangepaste werkstroomstatussen definieert, fungeert elke status die u op een vergelijkbare manier toewijst aan de status van de verwijderde werkstroomcategorie. Zie De werkstroom aanpassen voor meer informatie.

Schermopname van het werkitemformulier, Status wijzigen in Verwijderd.

Als u wilt voorkomen dat verwijderde items worden weergegeven in query's, voegt u een component toe die filtert op het veld Status .

Note

De status Verwijderd wordt niet ondersteund met het Basic-proces. Het wordt alleen ondersteund met de werkitemstypen Agile, Scrum en CMMI.proces. Het Basic-proces is beschikbaar met Azure DevOps Services en Azure DevOps Server 2020 en nieuwere versies.

Werkitems verwijderen

Verwijderde werkitems worden niet weergegeven in uw achterstanden, borden of query's. Wanneer u een item verwijdert, gaat het naar de Prullenbak. Items blijven in de Prullenbak staan totdat u ze herstelt of definitief verwijdert. Zie Testartefacten verwijderen als u een testcase, testplan of andere typen werkitems met betrekking tot tests wilt verwijderen.

U kunt werkitems op een van de volgende manieren verwijderen:

  • Het werkitemformulier
  • De Werkitems-pagina Meer acties menu
  • Het contextmenu van de bordkaart
  • Een pagina met achterstanden of queryresultaten
  • REST API
  1. Start de verwijderbewerking:

    • Open in het werkitemformulier het werkitem, kies Acties en selecteer Verwijderen.

      Schermopname van het werkitemformulier, het menu Acties, kies Verwijderen.

    • Als u meerdere werkitems wilt verwijderen, selecteert u deze items in een backlog of een lijst met queryresultaten, kiest u het contextmenu en selecteert u Verwijderen.

      Schermopname van het Actiesmenu voor multi-select in de backlog, kies Verwijderen.

    • Als u een werkitem van uw bord of Taskboard wilt verwijderen, kiest u het contextmenu voor de kaart en selecteert u Verwijderen.

      Schermopname van het contextmenu van de bordkaart, kies Verwijderen.

  2. Bevestig dat u de items wilt verwijderen.

    Schermopname van het dialoogvenster Verwijderen bevestigen.

Werkitems herstellen of vernietigen

U kunt geen werkitems openen vanuit de Prullenbak. De Prullenbak verwijdert nooit automatisch items. Ze blijven in de Prullenbak staan totdat u ze herstelt of definitief verwijdert. De optie Permanent verwijderen is alleen beschikbaar als uw machtiging Werkitems permanent verwijderen op projectniveau is ingesteld op Toestaan.

Verwijderde werkitems herstellen of definitief verwijderen uit de Prullenbak van de webportal.

  1. Selecteer Boards>Werkitems>Prullenbak.

    Schermopname van de pagina Borden, pagina Werkitems, Prullenbak openen.

    Als u de optie Prullenbak niet ziet, kiest u Meer opdrachten... en selecteert u in het menu met opties.

    Er wordt een nieuw browsertabblad geopend met de query met werkitems die zijn toegevoegd aan de Prullenbak.

  2. Selecteer de items die u wilt herstellen en kies Herstellen.

    Schermopname van Geselecteerde items herstellen.

    Desgewenst kunt u ervoor kiezen om de items definitief te verwijderen.

  3. Bevestig uw selectie.

Note

Testartefacten zoals testplannen, testsuites en testcases worden allemaal beschouwd als werkitems in Azure DevOps. De methode die wordt gebruikt voor het Verwijderen van testartefacten in Azure Boards verschilt echter van de methode voor het verwijderen van niet-geteste werkitems. Azure DevOps Services ondersteunt een model voor voorlopig verwijderen, waarbij testplannen en testsuites 14 dagen nadat ze zijn verwijderd, de status voorlopig verwijderen hebben. Terwijl ze zich in de status 'Zacht verwijderd' bevinden, kun je ze herstellen.

Werkitems verwijderen of vernietigen via de opdrachtregel

Gebruik de opdracht az boards work-item delete om een werkitem te verwijderen of te vernietigen. Zie Get started with Azure DevOps CLI om aan de slag te gaan.

Note

U kunt verwijderde werkitems herstellen, maar u kunt vernietigde werkitems niet herstellen.

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 
  • id: vereist. De ID van het werk-item.
  • vernietigen: Optioneel. Dit werkitem definitief verwijderen.
  • org: Azure DevOps organisatie-URL. Configureer de standaardorganisatie met behulp van az devops configure -d organization=ORG_URL. Als u de standaardorganisatie niet configureert of als git config geen organisatie oppikt, moet u deze parameter opgeven. Voorbeeld: --org https://dev.azure.com/MyOrganizationName/.
  • project: naam of id van het project. Configureer het standaardproject met behulp van az devops configure -d project=NAME_OR_ID. Als u het standaardproject niet configureert of als git config geen project oppikt, moet u deze parameter opgeven.
  • Ja: Optioneel. Vraag niet om bevestiging.

Met de volgende opdracht wordt de fout definitief verwijderd met de id 864 en wordt u niet om bevestiging gevraagd.

az boards work-item delete --id 864 --destroy --yes

Processen verwijderen en herstellen

Wanneer u een werkitem verwijdert, voert Azure DevOps de volgende acties uit:

  • Hiermee wordt een nieuwe revisie van het werkitem gegenereerd.
  • Hiermee worden de velden Gewijzigd op/Gewijzigde datum bijgewerkt om traceerbaarheid te ondersteunen.
  • Hiermee blijft het werkitem volledig behouden, inclusief alle veldtoewijzingen, bijlagen, tags en koppelingen.
  • Het maakt het werkitem niet-raadpleegbaar, zodat het niet verschijnt in enige werkvolgerervaring, zoekopdrachtresultaat of rapport.
  • Werkt grafieken correct bij. De CFD-, snelheids-, burndown- en lichtgewicht grafieken worden bijgewerkt om verwijderde werkitems te verwijderen.
  • Hiermee verwijdert u extensies voor het bijhouden van werk.
  • Hiermee blijven trendgegevens behouden, met uitzondering van de meest recente waarde.
  • Hiermee verwijdert u het werkitem uit het datawarehouse/de kubus alsof het permanent is verwijderd.

Wanneer u een werkitem herstelt, voert Azure DevOps de volgende acties uit:

  • Hiermee maakt u een nieuwe revisie van het werkitem.
  • Hiermee worden de velden Gewijzigd op/Gewijzigde datum bijgewerkt om traceerbaarheid te ondersteunen.
  • Hiermee kunt u een query uitvoeren op het werkitem.
  • Houdt alle velden ongewijzigd.
  • Voegt twee nieuwe revisies toe aan de geschiedenis, één voor verwijdering en één voor herstel.
  • De extensies voor het bijhouden van werk worden opnieuw gekoppeld.
  • Werkt grafieken correct bij. De CFD-, snelheids-, burndown- en lichtgewicht grafieken worden bijgewerkt om de herstelde werkitems op te nemen.
  • Hiermee worden trendgegevens hersteld.
  • Hiermee wordt het werkitem weer toegevoegd aan het datawarehouse/de kubus.
  • Hiermee stelt u het gebied of de iteratiepadvelden in op het hoofdknooppunt als het vorige gebiedspad of de iteratiepaden zijn verwijderd.

Een REST API gebruiken om werkitems te verwijderen, te herstellen en te vernietigen

Als u werkitems programmatisch wilt verwijderen, herstellen en vernietigen, raadpleegt u een van de volgende REST API-resources:

AI gebruiken om werkitems te vinden om te verwijderen

Als u de Azure Boards MCP Server verbindt met uw AI-agent in de agentmodus, kunt u in natuurlijke taal prompts gebruiken om werkitems te zoeken en bij te werken voordat u ze verwijdert of verwijdert.

Opdracht Voorbeeldprompt
Status wijzigen in Verwijderd Change the state of work items #101, #102, and #103 to Removed
Items zoeken met de status Verwijderd List all work items in the Removed state in area path <Contoso>\\OldFeature
Oude items zoeken om op te ruimen Show me all work items in the 'New' state that haven't been updated in the last 90 days
Gesloten items identificeren List all work items closed more than a year ago in the <Contoso> project
Verlaten werk zoeken List active work items in <Contoso> assigned to people who are no longer on the team
Dubbele kandidaten identificeren Show bugs in <Contoso> with the same title or very similar titles
Items zoeken zonder activiteit List work items in <Contoso> that never had a state change and were created more than 60 days ago
Gevolgen voor het verwijderen van previews Show all child work items linked to user story <1234> so I can review before removing it
Bulkstatuswijziging Set all user stories in area path <Contoso\\DeprecatedModule> to the Removed state
Verwijderde items auditeren List all work items in <Contoso> that were moved to the Removed state in the last 30 days and show who changed them

Note

De agentmodus en de MCP-server gebruiken natuurlijke taal, zodat u deze prompts kunt aanpassen of vervolgvragen kunt stellen om de resultaten te verfijnen. De MCP-server kan werkitemstatussen bijwerken, maar kan werkitems niet verwijderen, herstellen of vernietigen.