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

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

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

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

Примечание.

• В настоящее время нельзя архивировать рабочие элементы или проекты.
• Сведения о корзине артефактов Azure см. в разделе "Удаление и восстановление пакетов".

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

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

• Члены группы участников могут удалять, удалять и восстанавливать рабочие элементы.
• Чтобы окончательно удалить рабочие элементы, необходимо быть членом группы 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, выберите контекстное меню для карта и нажмите кнопку "Удалить".

   

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:

• Справочник по REST API корзины
• Рабочие элементы— справочник по REST API

Связанные статьи

• Просмотр и добавление рабочих элементов с помощью страницы "Рабочие элементы"
• Удаление артефактов теста
• Настройка разрешений и доступа для отслеживания работы
• Изменение разрешений на уровне проекта
• Краткий справочник по доступу заинтересованных лиц