Удаление, удаление или восстановление рабочих элементов в Azure Boards

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

Рабочие элементы могут жить навсегда в хранилище данных отслеживания работы. Их никогда не нужно удалять. Однако может потребоваться настроить процесс управления рабочими элементами для одного из следующих действий:

Действие Description
Изменение состояния Удалите рабочие элементы из невыполненной работы и доски, изменив состояние рабочего элемента на "Удалить" или "Вырезать". Состояние, доступное для вас, основано на рабочем процессе, назначенном типу рабочего элемента.
Удаление Удалите рабочие элементы из невыполненных работ, доски и запросы. Удаленные рабочие элементы перемещаются в корзину.
Восстановить Восстановление удаленных рабочих элементов путем их восстановления из корзины.
Уничтожить Окончательное удаление рабочих элементов, включая все данные из хранилища данных отслеживания работы.

Примечание.

Чтобы переместить рабочий элемент из одного проекта в другой или изменить тип рабочего элемента, см. статью "Перемещение рабочих элементов", изменение типа рабочего элемента.

Необходимые компоненты

  • Члены группы участников могут удалять, удалять и восстанавливать рабочие элементы.
  • Чтобы окончательно удалить рабочие элементы, необходимо быть членом группы project Администратор istrators или предоставить требуемое разрешение.
  • Пользователи с доступом заинтересованных лиц могут просматривать содержимое корзины, но не могут восстановить или окончательно удалить элементы в корзине независимо от разрешений, которые они предоставляют.

Задача

Обязательные разрешения


  • Укажите разрешение "Путь к области", чтобы разрешить: изменить рабочие элементы на этом узле
  • По умолчанию члены группы участников имеют это разрешение.
  • Укажите для параметра "Разрешить" разрешение на уровень проекта: удаление и восстановление рабочих элементов
  • У вас есть базовый доступ или более высокий уровень.
  • По умолчанию члены группы участников имеют это разрешение.
  • Укажите для параметра "Разрешить" разрешение на уровне проекта: окончательное удаление рабочих элементов
  • По умолчанию члены группы project Администратор istrator имеют это разрешение.
  • Укажите для параметра "Разрешить" разрешение на уровне проекта: окончательное удаление рабочих элементов
  • По умолчанию члены группы project Администратор istrator имеют это разрешение.

Упрощенное представление разрешений, назначенных встроенным группам, см. в разделе "Разрешения и доступ".

Примечание.

Пользователи с доступом заинтересованных лиц для общедоступного проекта имеют полный доступ ко всем функциям отслеживания работы, как и пользователям с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.

Удаление или удаление нескольких рабочих элементов

Вы можете действовать на отдельных рабочих элементах или массово изменять несколько рабочих элементов.

На веб-портале можно выбрать несколько рабочих элементов на странице результатов невыполненной работы или запроса. Вы также можете выполнить массовое обновление с помощью связанной функции. Чтобы удалить или восстановить несколько рабочих элементов одновременно, см. статью "Массовое изменение рабочих элементов".

Вы также можете удалить и /или уничтожить рабочие элементы в пакете с помощью REST API. Дополнительные сведения см. в разделе " Рабочие элементы — удаление".

Примечание.

Эта функция доступна начиная с Azure DevOps Server 2022.1.

Удаление рабочих элементов

Изменив состояние рабочего элемента на удаленный, вы эффективно удалите его из невыполненной работы или представления доски (продукт, портфель и спринт невыполненные записи, доска Канбан и доски задач). Состояние "Удалено" соответствует состоянию категории удаленного рабочего процесса. При определении пользовательских состояний рабочего процесса любое состояние, сопоставленное с состоянием "Удаленная категория рабочего процесса", действует аналогично.

Снимок экрана: форма рабочего элемента, изменение состояния на удалено.

Чтобы привести к тому, что удаленные элементы не отображаются в запросах, необходимо добавить предложение, которое фильтрует поле "Состояние ".

Примечание.

Состояние "Удалено " не поддерживается в базовом процессе. Она поддерживается только в типах рабочих элементов процесса Agile, Scrum и CMMI. Базовый процесс доступен при добавлении проекта в Azure DevOps Services или Azure DevOps Server 2019 с обновлением 1.

Удаление рабочих элементов

Удаленные рабочие элементы не отображаются в невыполненных работах, досках или запросах. При удалении элемента он переходит в корзину. Вы можете восстановить его оттуда, если вы измените свое мнение. Чтобы удалить тестовый случай, план тестирования или другие типы рабочих элементов, связанных с тестом, см. статью "Удаление артефактов теста".

Рабочие элементы можно удалить одним из следующих способов:

  • Форма рабочего элемента
  • Меню "Дополнительные действия" на странице "Рабочие элементы"
  • Меню контекстного меню карта доски Kanban
  • Страница невыполненной работы или запроса
  • REST API
  1. Инициируйте операцию удаления:

    • В форме рабочего элемента откройте рабочий элемент, выберите "Действия" и нажмите кнопку "Удалить".

    Снимок экрана: форма рабочего элемента, меню

    Снимок экрана: меню

    • Чтобы удалить рабочий элемент из Kanban или Taskboard, выберите контекстное меню для карта и нажмите кнопку "Удалить".

    Снимок экрана: доска Kanban карта контекстное меню, выберите

  2. Подтвердите удаление элементов.

    Экранная часть диалогового окна

Восстановление или уничтожение рабочих элементов

Не удается открыть рабочие элементы из корзины. Параметр окончательного удаления отображается только в том случае, если разрешение на постоянное удаление рабочих элементов на уровне проекта имеет значение Allow.

Восстановите удаленные рабочие элементы или окончательно удалите их из корзины веб-портала.

  1. Выберите корзину рабочих элементов>Boards.>

    Снимок экрана: страница

    Если вы не видите параметр корзины , выберите другие команды ... и выберите в меню параметров.

    Откроется новая вкладка браузера с запросом, в который перечислены рабочие элементы, добавленные в корзину.

  2. Выберите элементы, которые требуется восстановить, а затем нажмите кнопку "Восстановить".

    Снимок экрана: восстановление выбранных элементов.

    При необходимости можно удалить элементы безвозвратно.

  3. Подтвердите выбор.

Примечание.

Удаленные артефакты теста не отображаются в корзине и не могут быть восстановлены. При удалении артефакта теста все связанные с ним дочерние элементы, такие как дочерние наборы тестов, точки тестирования во всех конфигурациях, тестировщики (базовый рабочий элемент теста не удаляется), журнал результатов теста и другая связанная история также удаляются.

Удаление или уничтожение рабочих элементов из командной строки

Вы можете удалить или уничтожить рабочий элемент с помощью команды az boards work-item delete . Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

Примечание.

Вы можете восстановить удаленные рабочие элементы, но восстановить разрушенные рабочие элементы невозможно.

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 

Параметры

  • идентификатор: обязательный. Идентификатор рабочего элемента.
  • destroy: Необязательный. Окончательно удалите этот рабочий элемент.
  • org: URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью git config. Пример: --org https://dev.azure.com/MyOrganizationName/.
  • проект: имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью git config.
  • Да: Необязательно. Не запрашивайте подтверждение.

Пример

Следующая команда окончательно удаляет ошибку с идентификатором 864 и не запрашивает подтверждение.

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

Удаление и восстановление процессов

При удалении рабочего элемента Azure DevOps выполняет следующие действия:

  • Создает новую редакцию рабочего элемента
  • ОбновленияИзмененные поля даты и изменены для поддержки трассировки
  • Сохраняет рабочий элемент полностью, включая все назначения полей, вложения, теги и ссылки
  • Приводит к тому, что рабочий элемент становится неисключимым и, как это, не отображается в любом интерфейсе отслеживания работы, результатах запроса или отчете.
  • Обновления диаграммы правильно. CF, скорость, сгорание и упрощенные диаграммы обновляются для удаления удаленных рабочих элементов.
  • Удаление расширений отслеживания работы
  • Сохраняет данные тренда за исключением последнего значения
  • Удаляет рабочий элемент из хранилища данных или куба, как если бы он был окончательно удален.

При восстановлении рабочего элемента Azure DevOps выполняет следующие действия:

  • Вызывает создание новой редакции рабочего элемента
  • ОбновленияИзмененные поля даты и изменены для поддержки трассировки
  • Становится запрашиваемым
  • Все поля остаются неизменными
  • Журнал содержит две новые редакции, один для удаления и один для восстановления
  • Повторное кэширование расширений отслеживания работы
  • Обновления диаграммы правильно. CF, скорость, сгорание и упрощенные диаграммы обновляются, чтобы включить восстановленные рабочие элементы
  • Восстанавливает данные тренда
  • Добавляет рабочий элемент обратно в хранилище данных или куб
  • Задает поля пути к области или итерации корневому узлу, если предыдущий путь к области или пути итерации были удалены.

Использование REST API для удаления, восстановления и уничтожения рабочих элементов

Сведения о программном удалении, восстановлении и уничтожении рабочих элементов см. в одном из следующих ресурсов REST API: