Поделиться через

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

  • Статья

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

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

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

Примечание.

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

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

Категория Требования
разрешения — Для удаления и восстановления рабочих элементов: член группы участников .
— Для окончательного удаления рабочих элементов: член группы администраторов проекта или тот, кому предоставлены необходимые разрешения.
— Пользователи с доступом Участника могут просматривать содержимое корзины, но не могут восстановить или окончательно удалить элементы, независимо от предоставленных разрешений.

Задача

Необходимые разрешения

Изменение состояния "Удалить" или "Вырезать"

  • Путь к области с разрешением Разрешить: Изменение элементов работы в этом узле
  • По умолчанию члены группы участников имеют это разрешение.

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

  • Набор разрешений на уровне проекта Разрешить: Удалить и восстановить рабочие элементы
  • По крайней мере базовый доступ.
  • По умолчанию члены группы участников имеют это разрешение.

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

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

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

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

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

Примечание.

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

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

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

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

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

Примечание.

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

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

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

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

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

Примечание.

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

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

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

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

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

  1. Инициируйте операцию удаления:

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

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

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

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

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

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

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

    Снимок экрана: диалоговое окно

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

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

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

  1. Выберите >

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

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

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

  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: