Compartir a través de


Quitar, eliminar o restaurar elementos de trabajo en Azure Boards

Servicios Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Los elementos de trabajo pueden permanecer para siempre en el almacén de datos de seguimiento del trabajo. Nunca tendrá que eliminarlos. Sin embargo, es posible que desee configurar un proceso de administración de un elemento de trabajo para una de las siguientes acciones:

Sugerencia

Puede usar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Enable AI assistance with Azure DevOps MCP Server para empezar.

Action Description
Cambiar estado Quite los elementos de trabajo para que no aparezcan en trabajos pendientes y paneles cambiando el estado del elemento de trabajo a Quitar o Cortar. El estado disponible se basa en el flujo de trabajo asignado al tipo de elemento de trabajo.
Delete Quite elementos de trabajo de trabajos pendientes, paneles y consultas. Los elementos de trabajo eliminados se mueven a una papelera de reciclaje.
Restore Recupere los elementos de trabajo eliminados mediante su restauración desde la papelera de reciclaje.
Destroy Elimine permanentemente los elementos de trabajo, incluidos todos los datos del almacén de datos de seguimiento de trabajo.

Note

  • No se pueden archivar elementos de trabajo ni proyectos en este momento.
  • Para obtener información sobre la papelera de reciclaje de Azure Artifacts, consulte Eliminar y recuperar paquetes.

Para mover un elemento de trabajo de un proyecto a otro o cambiar el tipo de elemento de trabajo, consulte Mover elementos de trabajo y cambiar el tipo de elemento de trabajo.

Prerequisites

Category Requirements
Acceso general - Para quitar, eliminar y restaurar elementos de trabajo: miembro del grupo Colaboradores
- Para eliminar permanentemente elementos de trabajo: miembro del Administradores del Proyecto o haya recibido el permiso necesario.
- Los usuarios con acceso a partes interesadas pueden ver el contenido de la papelera de reciclaje, pero no pueden restaurar o eliminar permanentemente elementos independientemente de los permisos concedidos.
Cambiar el estado a Quitar o Cortar - Permiso de ruta de área establecido en Permitir: Editar elementos de trabajo en este nodo
- De forma predeterminada, los miembros del grupo Colaboradores tienen este permiso.
Eliminación y restauración de elementos de trabajo - Permiso a nivel de proyecto establecido en Permitir: Eliminar y restaurar elementos de trabajo
- Al menos acceso básico
- De forma predeterminada, los miembros del grupo Colaboradores tienen este permiso.
Eliminar o destruir elementos de trabajo permanentemente - Permiso a nivel de proyecto configurado en Allow: Eliminar permanentemente elementos de trabajo
- De forma predeterminada, los miembros del grupo Project Administradores tienen este permiso.
Eliminar o destruir elementos de trabajo de la línea de comandos - Permiso a nivel de proyecto establecido en Allow: Eliminar permanentemente elementos de trabajo
- De forma predeterminada, los miembros del grupo Project Administradores tienen este permiso.

Para obtener una vista simplificada de los permisos asignados a grupos integrados, consulte Permisos y acceso.

Note

Los usuarios con acceso de parte interesada para un proyecto público tienen acceso completo a las características de seguimiento de trabajos, al igual que los usuarios con acceso Básico. Para obtener más información, consulte Referencia rápida sobre el acceso de parte interesada.

Quitar o eliminar varios elementos de trabajo

Puede actuar en elementos de trabajo individuales o modificar en bloque varios elementos de trabajo.

En el portal web, puede seleccionar varios elementos de trabajo desde una página de resultados de consultas o trabajos pendientes. También puede realizar una actualización en bloque mediante la característica asociada. Para eliminar o restaurar varios elementos de trabajo al mismo tiempo, consulte Modificar elementos de trabajo de forma masiva.

También puede eliminar o destruir elementos de trabajo por lotes con una API REST. Para más información, consulte Elementos de trabajo: eliminación.

Note

Esta característica está disponible a partir de Azure DevOps Server 2022.1.

Quitar elementos de trabajo

Al cambiar el estado de un elemento de trabajo a Removido, se quita eficazmente de una vista de cartera o tablero: productos, carteras, trabajos pendientes de sprint, tableros y paneles de tareas. El estado Quitado corresponde al estado de categoría Quitado del flujo de trabajo. Si define estados de flujo de trabajo personalizados, cualquier estado que asigne al estado de categoría de flujo de trabajo quitado actúa de forma similar. Para más información, consulte Personalización del flujo de trabajo.

Captura de pantalla del formulario de elemento de trabajo, Cambiar estado a Quitado.

Para evitar que los elementos quitados aparezcan en las consultas, agregue una cláusula que filtre en el campo Estado .

Note

El estado Quitado no se admite con el proceso Básico. Solo se admite con los tipos de elementos de trabajo de proceso Agile, Scrum y CMMI. El proceso Básico está disponible con Azure DevOps Services y Azure DevOps Server 2020 y versiones posteriores.

Eliminar elementos de trabajo

Los elementos de trabajo eliminados no aparecerán en los trabajos pendientes, paneles ni consultas. Al eliminar un elemento, se dirige a la Papelera de reciclaje. Los elementos permanecen en la Papelera de reciclaje hasta que los restauras o los eliminas permanentemente. Para eliminar un caso de prueba, un plan de pruebas u otros tipos de elementos de trabajo relacionados con pruebas, consulte Eliminación de artefactos de prueba.

Puede eliminar los elementos de trabajo de una de las siguientes maneras:

  • El formulario del elemento de trabajo
  • Desde la página Elementos de trabajo menú Más acciones
  • Desde la tarjeta del panel menú contextual
  • Desde una página de trabajos pendientes o resultados de consultas
  • REST API
  1. Inicie la operación de eliminación:

    • En el formulario de elemento de trabajo, abra el elemento de trabajo, elija Acciones y seleccione Eliminar.

      Captura de pantalla del formulario de elemento de trabajo, menú Acciones, selección de la opción Eliminar.

    • Para eliminar varios elementos de trabajo, selecciónelos en un trabajo pendiente o en una lista de resultados de consulta, elija el menú contextual y, a continuación, seleccione Eliminar.

      Captura de pantalla del menú Acciones de selección múltiple de trabajos pendientes, selección de la opción Eliminar.

    • Para eliminar un elemento de trabajo del tablero o del panel de tareas, elija el menú contextual de la tarjeta y seleccione Eliminar.

      Captura de pantalla del menú contextual de la tarjeta del tablero, seleccione la opción Eliminar.

  2. Confirme que desea eliminar los elementos.

    Captura de pantalla del cuadro de diálogo Confirmar eliminación.

Restauración o destrucción de elementos de trabajo

No se pueden abrir elementos de trabajo en la Papelera de reciclaje. La papelera de reciclaje nunca elimina automáticamente los elementos. Permanecen en la papelera de reciclaje hasta que se restauran o se eliminan permanentemente. La opción Eliminar permanentemente solo está disponible si el permiso de nivel de proyecto Eliminar permanentemente los elementos de trabajo está establecido en Permitir.

Los elementos de trabajo eliminados se restauran o se eliminan definitivamente de la papelera de reciclaje del portal web.

  1. Seleccione Paneles>Papelera de reciclaje de >elementos de trabajo.

    Captura de pantalla de Paneles, página Elementos de trabajo, Abrir papelera de reciclaje.

    Si no ve la opción Papelera de reciclaje, elija Más comandos ... y selecciónela en el menú de opciones.

    Se abre una nueva pestaña del explorador con la consulta que muestra los elementos de trabajo agregados a la papelera de reciclaje.

  2. Seleccione los elementos que desea restaurar y, a continuación, elija Restaurar.

    Captura de pantalla de Restaurar elementos seleccionados.

    Opcionalmente, puede optar por eliminar definitivamente los elementos.

  3. Confirme la selección.

Note

Los artefactos de prueba, como los planes de prueba, los conjuntos de pruebas y los casos de prueba, se consideran elementos de trabajo en Azure DevOps. Sin embargo, el método usado para Delete artefactos de prueba en Azure Boards difiere del método para eliminar elementos de trabajo no probados. Azure DevOps Services admite un modelo de eliminación temporal, donde los planes de prueba y los conjuntos de pruebas se encuentran en un estado de eliminación temporal durante 14 días después de que se eliminen. Mientras están en estado de eliminación temporal, puede restaurarlos.

Eliminar o destruir elementos de trabajo de la línea de comandos

Use el comando az boards work-item delete para eliminar o destruir un elemento de trabajo. Para empezar, consulte Introducción a Azure DevOps CLI.

Note

Puede restaurar los elementos de trabajo eliminados, pero no puede restaurar elementos de trabajo destruidos.

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 
  • id: obligatorio. El identificador del elemento de trabajo.
  • destroy: opcional. Elimina definitivamente este elemento de trabajo.
  • org: URL de la Organización de Azure DevOps. Configure la organización predeterminada mediante az devops configure -d organization=ORG_URL. Si no configura la organización predeterminada o si git config no recoge una organización, debe especificar este parámetro. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.
  • project: nombre o identificador del proyecto. Configure el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Si no configura el proyecto predeterminado o si git config no selecciona un proyecto, debe especificar este parámetro.
  • yes: opcional. No solicita confirmación.

El siguiente comando elimina definitivamente el error con el identificador 864 y no le pide confirmación.

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

Procesos de eliminación y restauración

Cuando eliminas un elemento de trabajo, Azure DevOps realiza las siguientes acciones:

  • Genera una nueva revisión del elemento de trabajo.
  • Actualiza los campos Cambiado por/Fecha de cambio para admitir la rastreabilidad.
  • Conserva completamente el elemento de trabajo, incluidas todas las asignaciones de campos, los datos adjuntos, las etiquetas y los vínculos.
  • Hace que el elemento de trabajo no se pueda consultar, por lo que no aparece en ninguna experiencia de seguimiento del trabajo, resultado de la consulta o informe.
  • Se actualizan los gráficos correctamente. Los gráficos CFD, velocidad, agotamiento y ligeros se actualizan para quitar elementos de trabajo eliminados.
  • Quita las extensiones de seguimiento del trabajo.
  • Conserva los datos de tendencia, excepto el valor más reciente.
  • Quita el elemento de trabajo del almacén de datos o cubo de datos como si se hubiera eliminado permanentemente.

Con la restauración de un elemento de trabajo, Azure DevOps realiza las siguientes acciones:

  • Crea una nueva revisión del elemento de trabajo.
  • Actualiza los campos Cambiado por/Fecha de cambio para admitir la rastreabilidad.
  • Hace que el elemento de trabajo sea consultable.
  • Mantiene todos los campos sin cambios.
  • Agrega dos nuevas revisiones al historial, una para su eliminación y otra para la restauración.
  • Vuelve a unir extensiones para el seguimiento de trabajo.
  • Se actualizan los gráficos correctamente. Los gráficos CFD, velocidad, agotamiento y ligeros se actualizan para incluir los elementos de trabajo restaurados.
  • Restaura los datos de tendencia.
  • Agrega nuevamente el elemento de trabajo al almacén de datos o cubo.
  • Establece los campos de ruta de área o iteración en el nodo raíz si se eliminaron la ruta de área o las rutas de iteración anteriores.

Uso de una API REST para eliminar, restaurar y destruir elementos de trabajo

Para eliminar, restaurar y destruir elementos de trabajo mediante programación, consulte uno de los siguientes recursos de la API REST:

Utilizar IA para buscar elementos de trabajo para eliminar

Si conecta el Servidor MCP de Azure Boards a su agente de IA en modo de agente, puede usar indicaciones de lenguaje natural para buscar y actualizar elementos de trabajo antes de eliminarlos.

Tarea Ejemplo de sugerencia
Cambiar el estado a Quitado Change the state of work items #101, #102, and #103 to Removed
Buscar elementos en estado de eliminado List all work items in the Removed state in area path <Contoso>\\OldFeature
Buscar elementos obsoletos para limpiar Show me all work items in the 'New' state that haven't been updated in the last 90 days
Identifica elementos cerrados List all work items closed more than a year ago in the <Contoso> project
Búsqueda de trabajos abandonados List active work items in <Contoso> assigned to people who are no longer on the team
Identificación de candidatos duplicados Show bugs in <Contoso> with the same title or very similar titles
Buscar elementos sin actividad List work items in <Contoso> that never had a state change and were created more than 60 days ago
Impacto de la eliminación de vista previa Show all child work items linked to user story <1234> so I can review before removing it
Cambio de estado masivo Set all user stories in area path <Contoso\\DeprecatedModule> to the Removed state
Auditar elementos eliminados List all work items in <Contoso> that were moved to the Removed state in the last 30 days and show who changed them

Note

El modo de agente y el servidor MCP usan lenguaje natural, por lo que puede ajustar estas indicaciones o formular preguntas de seguimiento para refinar los resultados. El servidor MCP puede actualizar los estados del elemento de trabajo, pero no puede eliminar, restaurar ni destruir elementos de trabajo.