Quitar, eliminar o restaurar elementos de trabajo en Azure Boards
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Los elementos de trabajo pueden estar indefinidamente en el almacén de datos de seguimiento de trabajo. Nunca tiene que eliminarlos. Sin embargo, es posible que desee configurar un proceso de administración de elementos de trabajo para una de las siguientes acciones:
- Cambiar estado:quite los elementos de trabajo de que no aparezcan en trabajos pendientes y paneles cambiando el estado del elemento de trabajo a Quitar o Cortar.
- Eliminar:quita elementos de trabajo de trabajos pendientes, paneles y consultas. Los elementos de trabajo eliminados se mueven a un papelera de reciclaje. Desde el papelera de reciclaje, puede restaurarlos o eliminarlos permanentemente.
- Destruir:elimine permanentemente los elementos de trabajo y elimine todos los datos del almacén de datos de seguimiento de trabajo.
- Restaurar:recupere los elementos de trabajo eliminados y restáurelos desde el papelera de reciclaje.
- Cambiar estado:quite los elementos de trabajo de que no aparezcan en trabajos pendientes y paneles cambiando el estado del elemento de trabajo a Quitar o Cortar.
- Destruir:elimine permanentemente los elementos de trabajo y elimine todos los datos del almacén de datos de seguimiento de trabajo.
La capacidad de archivar proyectos o elementos de trabajo no es una característica admitida en este momento.
Para mover un elemento de trabajo de un proyecto a otro, o para cambiar el tipo de elemento de trabajo, vea Mover elementos de trabajo, cambiar el tipo de elemento de trabajo.
Nota
Para obtener información sobre el Azure Artifacts papelera de reciclaje, consulte Eliminación y recuperación de paquetes.
Requisitos previos
- Para quitar, modificar o eliminar elementos de trabajo, debe ser miembro del grupo Colaboradores o tener los permisos siguientes establecidos en Permitir.
- Quitar elementos de trabajo:tenga los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo Ruta de acceso de área establecidos en Permitir.
- Eliminar elementos de trabajo y Restaurar elementos de trabajo:tenga el permiso de nivel de proyecto Eliminar y restaurar elementos de trabajo establecido en Permitir. Además, para restaurar elementos de trabajo, debe tener acceso Básico o superior. Los usuarios con acceso de las partes interesadas pueden ver el contenido de lapapelera de reciclaje , pero no pueden restaurar ni eliminar permanentemente los elementos de la ubicación.
- Para quitar, modificar o eliminar elementos de trabajo, debe ser miembro del grupo Colaboradores o tener los permisos siguientes establecidos en Permitir.
- Quitar elementos de trabajo:tenga los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo Ruta de acceso de área establecidos en Permitir.
- Para restaurar o destruir elementos de trabajo o eliminar o destruir elementos de trabajo (az boards CLI),debe ser miembro del grupo administradores de Project o tener el permiso Eliminar elementos de trabajo en este proyecto de nivel de proyecto establecido en Permitir.
- Para restaurar o destruirelementos de trabajo, debe ser miembro del grupo administradores de Project o tener el permiso Eliminar elementos de trabajo de este proyecto de nivel de proyecto establecido en Permitir.
- Para restaurar o destruir elementos de trabajo o destruir elementos de trabajo (CLI de witadmin), debe ser miembro del grupo administradores de Project o tener el permiso Eliminar elementos de trabajo en este proyecto de nivel de proyecto establecido en Permitir.
- Para destruir elementos de trabajo (CLI de witadmin),debe ser miembro del grupo administradores de Project o tener el permiso Eliminar elementos de trabajo en este proyecto de nivel de proyecto establecido en Permitir.
Nota
De forma predeterminada, para TFS 2015.1 y versiones anteriores, el grupo Colaboradores tiene eliminar elementos de trabajo de este proyecto establecido en No establecer. Esta configuración hace que el grupo Colaboradores herede el valor del elemento primario más cercano que lo tiene establecido explícitamente.
Para obtener una vista simplificada de los permisos asignados a grupos integrados,vea Permisos y acceso a .
Nota
Los usuarios con acceso de partes interesadas para un proyecto público tienen acceso total a todas las características de seguimiento de trabajo, al igual que los usuarios con acceso básico. Para más información, consulte Referencia rápida de acceso de las partes interesadas.
Importante
A fin de ver el contenido disponible para la plataforma, asegúrese de seleccionar la versión correcta de este artículo en el selector de versiones que se encuentra sobre la tabla de contenidos. La compatibilidad con las características difiere en función de si se trabaja desde Azure DevOps Services o una versión local de Azure DevOps Server.
Vea ¿Qué plataforma o versión estoy usando? para obtener información sobre la versión local que utiliza.
Quitar o eliminar varios elementos de trabajo
Puede actuar sobre elementos de trabajo individuales o modificar de forma masiva varios elementos de trabajo.
Desde el portal web, puede seleccionar varios elementos de trabajo en una página de resultados de trabajo pendiente o de consulta. También puede realizar una actualización masiva mediante la característica asociada. Para eliminar o restaurar varios elementos de trabajo al mismo tiempo, vea Modificación masiva de elementos de trabajo.
Quitar elementos de trabajo
Al cambiar el estado de un elemento de trabajo a Quitado,se quita de forma eficaz de una vista de trabajo pendiente o panel (trabajos pendientes de producto, cartera y sprint, panel Kanban y paneles de tareas). El estado Quitado corresponde al estado de categoría de flujo de trabajo Quitado. Si define estados de flujo de trabajo personalizados, cualquier estado que asigne al estado categoría flujo de trabajo Quitado actuará de forma similar.

Para que los elementos quitados no se muestren en las consultas, debe agregar una cláusula que filtra en el campo Estado.
Nota
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 cuando se agrega un proyecto a Azure DevOps Services o Azure DevOps Server 2019 Update 1.
Eliminar elementos de trabajo
Los elementos de trabajo eliminados no aparecerán en los trabajos pendientes, paneles o consultas. Los elementos eliminados se mueven a papelera de reciclaje desde el que puede recuperarlos si es necesario. Para eliminar un caso de prueba, un plan de prueba u otros tipos de elementos de trabajo relacionados con pruebas, consulte Eliminación de artefactos de prueba.
Puede eliminar un elemento de trabajo desde dentro del formulario de elemento de trabajo, seleccionando varios elementos de trabajo de una página de resultados de trabajo pendiente o de consulta, o desde un panel Kanban o panel de tareas.
Para eliminar un único elemento de trabajo, abra el elemento de trabajo, elija
Accionesy seleccione Eliminar.
Para eliminar varios elementos de trabajo, selecciónelos de forma múltiple de un trabajo pendiente o una lista de resultados de consulta y, a continuación, elija el icono de acciones
y seleccione Eliminar.
Para eliminar un elemento de trabajo de kanban o panel de tareas, elija el
icono de acciones de la tarjeta y seleccione Eliminar.
Confirme que desea eliminar realmente los elementos.

Nota
Las características Eliminar y papelera de reciclaje están disponibles en TFS 2015.2 y versiones posteriores.
Puede eliminar un elemento de trabajo desde dentro del formulario de elemento de trabajo o seleccionando varios elementos de trabajo de una página de resultados de trabajos pendientes o de consulta.
Para eliminar un único elemento de trabajo, abra el elemento de trabajo, elija
Accionesy seleccione Eliminar.
Para eliminar varios elementos de trabajo, selecciónelosde forma múltiple de un trabajo pendiente o una lista de resultados de consulta . A continuación, elija
el icono de acciones y seleccione Eliminar.
También puede eliminar elementos de trabajo de kanban o panel de tareas.

O bien, puede arrastrarlos a la papelera
(papelera de reciclaje). Solo puede acceder a la (papelera de reciclaje) desde el centro de trabajo.Confirme que desea eliminar realmente los elementos.

Nota
El cuadro de diálogo de confirmación Eliminar elementos de trabajo Azure DevOps local puede indicar que hay una configuración de eliminación automática (deshabilitada). No hay ninguna configuración que pueda habilitar o deshabilitar. Solo hay un proceso en segundo plano que elimina permanentemente los elementos de trabajo que se han establecido para eliminar.
Restauración o destrucción de elementos de trabajo
Los elementos de trabajo eliminados se restauran o se eliminan permanentemente del portal web papelera de reciclaje.
Elija Boards de trabajo y, a continuación, elija papelera de reciclaje.

Si no ve la opción de papelera de reciclaje, elija Más comandos ... y elicione en el menú de opciones.
Nota
Los artefactos de prueba eliminados no aparecerán en el papelera de reciclaje y no se pueden restaurar. La eliminación de artefactos de prueba elimina el artefacto de prueba seleccionado y todos sus elementos secundarios asociados, como conjuntos de pruebas secundarios, puntos de prueba en todas las configuraciones, evaluadores (el elemento de trabajo del caso de prueba subyacente no se elimina), historial de resultados de pruebas y otro historial asociado.
Se abre una nueva pestaña del explorador con la consulta que enumera los elementos de trabajo agregados al papelera de reciclaje.
Seleccione los elementos que desea restaurar y, a continuación, elija Restaurar.

Opcionalmente, puede optar por eliminar permanentemente los elementos.
Confirme la selección.
Los elementos de trabajo eliminados se restauran desde el portal web papelera de reciclaje.
Nota
Las características eliminar y papelera de reciclaje requieren TFS 2015.2 o una versión posterior.
Elija Trabajos pendientes detrabajo o Consultas de trabajo y, a continuación, elijapapelera de reciclaje .

Se abre una nueva pestaña del explorador con la consulta que enumera los elementos de trabajo agregados al papelera de reciclaje.
Seleccione los elementos que desea restaurar y, a continuación, elija Restaurar.

Opcionalmente, puede optar por eliminar permanentemente los elementos.
Confirme la selección.
Eliminación o destrucción de elementos de trabajo desde la línea de comandos
Puede eliminar o destruir un elemento de trabajo con el comando az boards work-item delete. Para empezar, consulte Introducción a la CLI Azure DevOps.
Nota
Puede restaurar los elementos de trabajo que elimine,pero no podrá restaurar los elementos de trabajo que decida destruir.
az boards work-item delete --id
[--destroy]
[--org]
[--project]
[--yes]
Parámetros
- id:requerido. Identificador del elemento de trabajo.
- destroy: opcional. Elimine permanentemente este elemento de trabajo.
- org: Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante
az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o se selecciona mediantegit config. Ejemplo:--org https://dev.azure.com/MyOrganizationName/. - project:nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante
az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o se selecciona mediantegit config. - sí:opcional. No solicite confirmación.
Ejemplo
El siguiente comando elimina permanentemente el error con el identificador 864 y no le pide confirmación.
az boards work-item delete --id 864 --destroy --yes
Destruir elementos de trabajo desde la línea de comandos
Use el comando witadmin destroywi para quitar permanentemente elementos de trabajo del almacén de datos. Una eliminación permanente significa que toda la información del almacén de datos de seguimiento de trabajo se elimina y no se puede restaurar ni reactivar.
Nota
La eliminación de elementos de trabajo de la línea de comandos witadmin está en desuso para TFS 2018.2 y versiones posteriores, y no se admite para Azure Boards servicio en la nube.
Abra una ventana del símbolo del sistema donde esté instalada la versión más reciente de Visual Studio y cambie el directorio a donde se ha instaladowitadmin.exela herramienta.
Por ejemplo, cambiaría al directorio siguiente para TFS 2018. (Para otras versiones, vea Quitar elementos de trabajo de forma permanente (witadmin destroywi).
%programfiles(x86)%\Microsoft Visual Studio\2018\Professional\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
Por ejemplo, cambiaría al directorio siguiente para TFS 2017. (Para otras versiones, vea Quitar elementos de trabajo de forma permanente (witadmin destroywi).
%programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
Por ejemplo, cambiaría al directorio siguiente para TFS 2015. (Para otras versiones, vea Quitar elementos de trabajo de forma permanente (witadmin destroywi).
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
Por ejemplo, cambiaría al directorio siguiente para TFS 2013. (Para otras versiones, vea Quitar elementos de trabajo de forma permanente (witadmin destroywi).
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%.
La herramienta de línea de comandos witadmin se instala con cualquier versión Visual Studio o Team Explorer. Puede acceder a esta herramienta instalando la versión gratuita de Visual Studio Community.
Para eliminar varios elementos de trabajo, escriba el nombre del servidor y la ruta de acceso del directorio a la colección. Por ejemplo:
witadmin destroywi /collection:http://TFSServerName:8080/tfs/DefaultCollection /id:12,15,23Para eliminar un solo elemento de trabajo, escriba el identificador como se muestra:
witadmin destroywi /collection:http://TFSServerName:8080/tfs/DefaultCollection /id:2003
Cómo eliminar y restaurar acciones funcionan
Al eliminar un elemento de trabajo, se producen las siguientes acciones:
- Genera una nueva revisión del elemento de trabajo.
- Actualiza los campos Fecha cambiada por/Fecha cambiada para admitir la rastreabilidad
- Conserva completamente el elemento de trabajo, incluidas todas las asignaciones de campos, datos adjuntos, etiquetas y vínculos.
- Hace que el elemento de trabajo se convierta en no consultable y, como tal, no aparecerá en ninguna experiencia de seguimiento de trabajo, resultado de consulta o informe
- Actualiza los gráficos correctamente. Los gráficos CFD, velocidad, grabación y ligero se actualizan para quitar los elementos de trabajo eliminados.
- Quita las extensiones de seguimiento de 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 forma similar a como si se quitara de forma permanente.
Al restaurar un elemento de trabajo, se producen las siguientes acciones:
- Hace que se realiza una nueva revisión del elemento de trabajo.
- Actualiza los campos Fecha cambiada por/Fecha cambiada para admitir la rastreabilidad
- Se vuelve consultable
- Todos los campos permanecen sin cambios
- El historial contiene dos nuevas revisiones, una para la eliminación y otra para la restauración.
- Reasontes extensiones de seguimiento de trabajo
- Actualiza los gráficos correctamente. Los gráficos CFD, velocidad, grabación y ligero se actualizan para incluir los elementos de trabajo restaurados.
- Restaura los datos de tendencia
- Vuelve a agregar el elemento de trabajo al cubo o almacenamiento de datos
- Establece los campos de ruta de acceso de área o iteración en el nodo raíz si se eliminaron las rutas de acceso de área o 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 api REST:
Artículos relacionados
- Mejor herramienta para agregar, actualizar y vincular elementos de trabajo
- Visualización y adición de elementos de trabajo mediante la página Elementos de trabajo
- Eliminar artefactos de prueba
- Establecer permisos y acceso para el seguimiento del trabajo
- Establecer permisos en el nivel de proyecto o en el nivel de colección de proyectos
- Referencia rápida de acceso de las partes interesadas
- Mejor herramienta para agregar, actualizar y vincular elementos de trabajo
- Visualización y adición de elementos de trabajo mediante la página Elementos de trabajo
- Quitar elementos de trabajo de forma permanente (witadmin destroywi)
- Eliminar artefactos de prueba
- Establecer permisos y acceso para el seguimiento del trabajo
- Establecer permisos en el nivel de proyecto o en el nivel de colección de proyectos
- Referencia rápida de acceso de las partes interesadas