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

Seleccione una versión en el selector de versiones del contenido de Azure DevOps.

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.

Cambiar el estado a Quitado

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.

  1. 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.

    formulario de elemento de trabajo, menú acciones, 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.

    Lista de elementos de trabajo, menú de acciones, Eliminar

    Para eliminar un elemento de trabajo de kanban o panel de tareas, elija el icono de acciones de la tarjeta y seleccione Eliminar.

    Eliminación de un elemento de trabajo del panel Kanban

  2. Confirme que desea eliminar realmente los elementos.

    Cuadro de diálogo Confirmar eliminación

Nota

Las características Eliminar y papelera de reciclaje están disponibles en TFS 2015.2 y versiones posteriores.

  1. 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.

    formulario de elemento de trabajo, menú acciones, 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.

    Lista de elementos de trabajo, menú de acciones, Eliminar

    También puede eliminar elementos de trabajo de kanban o panel de tareas.

    Eliminación de un elemento de trabajo del panel Kanban

    O bien, puede arrastrarlos a la papelera de reciclaje (papelera de reciclaje). Solo puede acceder a la (papelera de reciclaje) desde el centro de trabajo.

  2. Confirme que desea eliminar realmente los elementos.

    Cuadro de diálogo Confirmar eliminación

    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.

  1. Elija Boards de trabajo y, a continuación, elija papelera de reciclaje.

    Boards  de elementos de trabajo, Abrir 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.

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

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

    Opcionalmente, puede optar por eliminar permanentemente los elementos.

    Nota

    No se pueden abrir los elementos de trabajo que se han movido al papelera de reciclaje. Además, solo verá la opción Eliminar permanentemente si el permiso de nivel de proyecto Eliminar elementos de trabajo permanentemente está establecido en Permitir.

  4. 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.

  1. Elija Trabajos pendientes detrabajo o Consultas de trabajo y, a continuación, elijapapelera de reciclaje .

    Abrir papelera de reciclaje

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

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

    Restauración de los elementos seleccionados

    Opcionalmente, puede optar por eliminar permanentemente los elementos.

    Nota

    No se pueden abrir los elementos de trabajo que se han movido al papelera de reciclaje. Además, solo verá la opción Eliminar permanentemente si el permiso de nivel de proyecto Eliminar elementos de trabajo permanentemente está establecido en Permitir.

  3. 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 mediante git 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 mediante git 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,23
    
  • Para 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: