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


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

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

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

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

Примечание.

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

Предварительные условия

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

Задача

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


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

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

Примечание.

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

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

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

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

Вы также можете удалить или уничтожить рабочие элементы в пакете с помощью 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: