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