Compartir vía

Quitar, eliminar o restaurar elementos de trabajo en Azure Boards

  • Artículo

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

Los elementos de trabajo pueden residir 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:

Acción Descripción
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.
Eliminar Quite elementos de trabajo de trabajos pendientes, paneles y consultas. Los elementos de trabajo eliminados se mueven a una papelera de reciclaje.
Restaurar 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.

Nota:

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 y cambiar el tipo de elemento de trabajo.

Requisitos previos

  • Permisos:
    • Para quitar, eliminar y restaurar elementos de trabajo, sea miembro del grupo Colaboradores .
    • Para eliminar permanentemente los elementos de trabajo, sea miembro del grupo Administradores de proyectos o conceda el permiso necesario.
    • Los usuarios con acceso de parte interesada pueden ver el contenido de la Papelera de reciclaje, pero no pueden restaurar ni eliminar definitivamente los elementos de la papelera, independientemente de los permisos que se les concedan.

Task

Permisos necesarios

Cambiar el estado a Quitar o Cortar

  • Establezca el permiso Ruta de acceso al área en Permitir: Editar elementos de trabajo en este nodo.
  • De manera predeterminada, los miembros del grupo Colaboradores no tienen este permiso.

Eliminar elementos de trabajo y
Restaurar elementos de trabajo

  • Establezca el permiso de nivel de proyecto en Permitir: Eliminar y restaurar elementos de trabajo
  • Disponga de acceso básico o superior.
  • De manera predeterminada, los miembros del grupo Colaboradores no tienen este permiso.

Eliminar o destruir definitivamente elementos de trabajo

  • Establezca el permiso de nivel de proyecto en Permitir: Eliminar definitivamente elementos de trabajo
  • De forma predeterminada, los miembros del grupo de Administradores de proyectos disponen de este permiso.

::: moniker-end

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

  • Establezca el permiso de nivel de proyecto en Permitir: Eliminar definitivamente elementos de trabajo
  • De forma predeterminada, los miembros del grupo de Administradores de proyectos disponen de este permiso.

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

Nota:

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.

Nota:

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 Quitado, se quita eficazmente de una vista de trabajo pendiente o placa: producto, cartera y trabajos pendientes de sprint, paneles 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 que los elementos quitados no aparezcan en las consultas, debe agregar una cláusula que filtre por 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 de Agile, Scrum y CMMI. El proceso Básico está disponible al agregar 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 ni consultas. Al eliminar un elemento, se dirige a la Papelera de reciclaje. Puede restaurarlo desde allí si cambia de opinión. 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
  • Menú contextual de la tarjeta de placa
  • 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 panel o del Panel de tareas, elija el menú contextual de la tarjeta y seleccione Eliminar.

      Captura de pantalla del menú contextual de la tarjeta de placa, elija 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. Además, solo verá la opción Eliminar definitivamente si el permiso de nivel de proyecto Eliminar definitivamente 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.

Nota:

Los artefactos de prueba eliminados no aparecerán en la papelera de reciclaje y no se pueden restaurar. Al eliminar un artefacto de prueba, todos sus elementos secundarios asociados, como conjuntos de pruebas secundarios, puntos de prueba en todas las configuraciones, evaluadores, historial de resultados de pruebas y otro historial asociado también se eliminan. El elemento de trabajo del caso de prueba subyacente no se elimina.

Eliminar o destruir elementos de trabajo de 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 de Azure DevOps.

Nota:

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: la URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado 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. Es obligatorio si no está configurado como predeterminado o seleccionado mediante git config.
  • 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

Al eliminar un elemento de trabajo, Azure DevOps realiza las siguientes acciones:

  • Se genera una nueva revisión del elemento de trabajo.
  • Se actualizan los campos Autor de la modificación y Fecha del cambio para admitir la rastreabilidad.
  • Se 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 se convierta en no consultable y, como tal, no aparece en ninguna experiencia de seguimiento del trabajo, resultado de la consulta o informe
  • Se actualizan los gráficos correctamente. Los gráficos de CFD, velocidad, evolución y ligeros se actualizan para eliminar los elementos de trabajo eliminados.
  • Se eliminan las extensiones de seguimiento del trabajo.
  • Se conservan los datos de tendencia, excepto el valor más reciente.
  • Quita el elemento de trabajo del almacén de datos o cubo similar al de si se quitara permanentemente.

Al restaurar un elemento de trabajo, Azure DevOps realiza las siguientes acciones:

  • Se realiza una nueva revisión del elemento de trabajo
  • Se actualizan los campos Autor de la modificación y Fecha del cambio para admitir la rastreabilidad.
  • Se convierte en consultable.
  • Todos los campos permanecen sin cambios.
  • El historial contiene dos revisiones nuevas, una para su eliminación y otra para la restauración.
  • Se reasocian las extensiones de seguimiento del trabajo.
  • Se actualizan los gráficos correctamente. Los gráficos de CFD, velocidad, evolución y ligeros se actualizan para incluir los elementos de trabajo restaurados.
  • Se restauran los datos de tendencia.
  • Se vuelve a agregar el elemento de trabajo al almacén de datos o cubo.
  • Establece los campos de ruta de acceso de área o iteración en el nodo raíz si se eliminaron la ruta de acceso del área anterior o las rutas de acceso de iteración.

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: