Удаление, исключение или восстановление рабочих элементов в Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Рабочие элементы могут храниться в вашей системе отслеживания работы навсегда. Их никогда не нужно удалять. Однако может потребоваться настроить процесс управления рабочими элементами для одного из следующих действий:
| Действие | Описание |
|---|---|
| Изменение состояния | Удалите рабочие элементы из бэклогов и досок, изменив состояние рабочего элемента на Удалить или Вырезать. Состояние, доступное для вас, основано на рабочем процессе, назначенном типу рабочего элемента. |
| Удаление | Удалите рабочие элементы из бэклогов, досок и запросов. Удаленные рабочие элементы перемещаются в корзину. |
| Восстановить | Восстановите удаленные рабочие элементы, вернув их из Корзины. |
| Разрушать | Окончательное удаление рабочих элементов, включая все данные из хранилища данных отслеживания работы. |
Примечание.
- В настоящее время нельзя архивировать рабочие элементы или проекты.
- Сведения о корзине артефактов Azure см. в разделе "Удаление и восстановление пакетов".
Чтобы переместить рабочий элемент из одного проекта в другой или изменить тип рабочего элемента, см. статью "Перемещение рабочих элементов" и изменение типа рабочего элемента.
Предварительные условия
| Категория | Требования |
|---|---|
| разрешения | — Для удаления и восстановления рабочих элементов: член группы участников . — Для окончательного удаления рабочих элементов: член группы администраторов проекта или тот, кому предоставлены необходимые разрешения. — Пользователи с доступом Участника могут просматривать содержимое корзины, но не могут восстановить или окончательно удалить элементы, независимо от предоставленных разрешений. |
Задача
Необходимые разрешения
- Путь к области с разрешением Разрешить: Изменение элементов работы в этом узле
- По умолчанию члены группы участников имеют это разрешение.
- Набор разрешений на уровне проекта Разрешить: Удалить и восстановить рабочие элементы
- По крайней мере базовый доступ.
- По умолчанию члены группы участников имеют это разрешение.
- Набор разрешений на уровне проекта Разрешить: окончательное удаление рабочих элементов
- По умолчанию члены группы "Администраторы проектов " имеют это разрешение.
- Набор разрешений на уровне проекта Разрешить: окончательное удаление рабочих элементов
- По умолчанию члены группы "Администраторы проектов " имеют это разрешение.
Упрощенное представление разрешений, назначенных встроенным группам, см. в разделе "Разрешения и доступ".
Примечание.
Пользователи с доступом заинтересованных лиц для общедоступного проекта имеют полный доступ ко всем функциям отслеживания работы, как и пользователям с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
Удалить или удалить несколько рабочих элементов
Вы можете действовать на отдельных рабочих элементах или массово изменять несколько рабочих элементов.
На веб-портале можно выбрать несколько рабочих элементов на странице результатов невыполненной работы или запроса. Вы также можете выполнить массовое обновление с помощью связанной функции. Чтобы удалить или восстановить несколько рабочих элементов одновременно, см. статью "Изменение рабочих элементов в массовом режиме".
Вы также можете удалить или уничтожить рабочие элементы в пакете с помощью REST API. Дополнительные сведения см. в разделе " Рабочие элементы — удаление".
Примечание.
Эта функция доступна начиная с Azure DevOps Server 2022.1.
Удаление рабочих элементов
Изменив состояние рабочего элемента на Удалено, вы эффективно удалите его из представления бэклога или доски: продуктового, портфельного и спринт бэклогов, досок и панелей задач. Состояние "Удалено" соответствует состоянию категории удаленного рабочего процесса. При определении пользовательских состояний рабочего процесса любое состояние, сопоставленное с состоянием "Удаленная категория рабочего процесса", действует аналогично. Дополнительные сведения см. в разделе "Настройка рабочего процесса".
Чтобы привести к тому, что удаленные элементы не отображаются в запросах, необходимо добавить предложение, которое фильтрует поле "Состояние ".
Примечание.
Состояние "Удалено " не поддерживается в базовом процессе. Она поддерживается только в типах рабочих элементов процесса Agile, Scrum и CMMI. Базовый процесс доступен при добавлении проекта в Azure DevOps Services или Azure DevOps Server 2019 с обновлением 1.
Удалите рабочие элементы
Удаленные рабочие элементы не отображаются в невыполненных работах, досках или запросах. При удалении элемента он переходит в корзину. Вы можете восстановить его оттуда, если измените свое мнение. Чтобы удалить тестовый случай, план тестирования или другие типы рабочих элементов, связанных с тестом, см. статью "Удаление артефактов теста".
Рабочие элементы можно удалить одним из следующих способов:
- Форма рабочего элемента
- Меню "Дополнительные действия
" на странице "Рабочие элементы" - Контекстное меню карточки доски
- Страница невыполненных задач или результатов запроса
- REST API
Инициируйте операцию удаления:
В форме рабочего элемента откройте рабочий элемент, выберите
"Действия" и нажмите кнопку "Удалить".
Чтобы удалить несколько рабочих элементов, выберите их из невыполненной работы или списка результатов запроса, выберите
контекстное меню и нажмите кнопку "Удалить".
Чтобы удалить рабочий элемент из доски или панели задач, выберите
контекстное меню для карточки и нажмите кнопку "Удалить".
Подтвердите удаление элементов.
Восстановление или уничтожение рабочих элементов
Невозможно открыть рабочие элементы из Корзины. Параметр окончательного удаления отображается только в том случае, если разрешение на постоянное удаление рабочих элементов на уровне проекта имеет значение Allow.
Восстановите удаленные рабочие элементы или окончательно удалите их из корзины веб-портала.
Выберите Доски>Рабочие элементы>Корзину.
Если вы не видите Корзина, выберите Дополнительные команды... и выберите команду из меню параметров.
Откроется новая вкладка браузера с запросом, который перечисляет рабочие элементы, добавленные в корзину.
Выберите элементы, которые требуется восстановить, а затем нажмите кнопку "Восстановить".
При необходимости можно удалить элементы безвозвратно.
Подтвердите выбор.
Примечание.
Удаленные артефакты теста не отображаются в корзине и не могут быть восстановлены. При удалении артефакта теста все связанные с ним дочерние элементы, такие как дочерние наборы тестов, точки тестирования во всех конфигурациях, тестировщиках, журнале результатов теста и другой связанной истории также удаляются. Основной рабочий элемент, связанный с тестовым случаем, не удаляется.
Удаление или уничтожение рабочих элементов из командной строки
Вы можете удалить или уничтожить рабочий элемент с помощью команды 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: