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

Связывание рабочих элементов с объектами

  • Статья

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

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

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

Необходимые условия Description
администратор проекта или участник участник проекта и член группы безопасности участников или администраторов проекта .
доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, нужно иметь доступ на уровне не менее заинтересованного лица. Пользователи с доступом заинтересованных лиц для общедоступных проектов имеют полный доступ к функциям невыполненной работы и доски, например пользователям с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
участник или разрешить доступ — Для просмотра или изменения рабочих элементов ваши разрешения на просмотр рабочих элементов в этом узле и изменение рабочих элементов в этом узле должны быть установлены в значение Разрешить. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе Настройка разрешений и доступа для отслеживания работы.
. Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска.
. Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, ваши разрешения "Изменить рабочие элементы в этом узле" должны быть установлены на "Разрешить" для пути области, назначенного рабочему элементу. По умолчанию группа участников имеет этот набор разрешений.
. Чтобы просмотреть рабочие элементы, укажите просмотр рабочих элементов в этом узле разрешения Разрешить для пути к области, назначенному рабочему элементу.
определённые итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.
Необходимые условия Description
администратор проекта или участник участник проекта и член группы безопасности участников или администраторов проекта .
доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, необходимо иметь как минимум #стейкхолдер доступ.
участник или разрешить доступ — Чтобы просматривать или изменять рабочие элементы, убедитесь, что у вас есть разрешения на просмотр рабочих элементов в этом узле и на изменение рабочих элементов в этом узле, установленные в Разрешить. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
— Чтобы настроить параметры интеграции для классического конвейера выпуска, у вас есть разрешения на изменение выпуска.
— Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, установите разрешение на изменение рабочих элементов в этом узле на разрешено для пути области, назначенного рабочему элементу. По умолчанию группа участников имеет этот набор разрешений.
— Чтобы иметь возможность просматривать рабочие элементы, ваши разрешения Просмотр рабочих элементов в этом узле должны быть установлены как Разрешить для пути области, назначенного рабочему элементу.
определённые итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.
Необходимые условия Description
администратор проекта или участник участник проекта и член группы безопасности участников или администраторов проекта .
доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, у вас должен быть по крайней мере доступ для заинтересованных сторон.
участник или разрешить доступ Чтобы просмотреть или изменить рабочие элементы, установите просмотр рабочих элементов в этом узле и изменение рабочих элементов в этом узле права на Разрешить. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
определённые итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.

Следующие типы ссылок помогают управлять различными связями между рабочими элементами и другими объектами.

Категория типа ссылки Description
сборка Подключает рабочий элемент к номеру сборки, найденной в сборке или интегрированной в сборке.
кода Подключает рабочую задачу к ветви, изменениям, коммиту, pull-реквесту, тегу или версии элемента.
GitHub Подключает рабочий элемент к ветке репозитория GitHub, коммиту, проблеме или пулл-реквесту.
удаленная работа Подключает рабочий элемент, определенный в другой организации, которая получает данные из, создает данные для или удаленно связана с помощью URL-адреса.
требование Подключает рабочий элемент к раскадровке по URL-адресу.
тест Подключает рабочий элемент к тестовому вложению или результату.
вики Подключает рабочий элемент к вики-странице.
работа Подключает рабочий элемент к различным аспектам работы, включая:
- Затронутые
-Влияет
-Ребёнок
- Дублировать
— дубликаты
-Гиперссылка
Интегрировано на стадии выпуска
-Родитель
-Предшественник
Указано в
-Ссылки
- Связанный
— Общие шаги
-Преемник
— тестовый случай
Проверено:
-Тесты

Дополнительные сведения о типах рабочих ссылок, включая такие, как родитель/дочерний, связанные и предшественник-преемник, см. в разделе Типы рабочих ссылок.

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

  1. Войдите в организацию (https://dev.azure.com/{Your_Organization}).

  2. Откройте существующий рабочий элемент, из которого нужно связаться, или создайте новый.

  3. Выберите Ссылки>Добавить ссылку, а затем выберите Существующий элемент или Новый элемент.

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

  4. В раскрывающемся списке типа ссылки выберите тип ссылки , который вы хотите создать.

  5. В следующем поле введите или выберите объект, к которому требуется связаться.

  6. (Необязательно) Введите комментарий, чтобы описать ссылку.

  7. Выберите Добавить ссылку, чтобы создать ссылку.

Дополнительные инструкции по связыванию различных типов рабочих элементов см. в следующих разделах.

Совет

Вы можете использовать другие функции для ссылки или изменения ссылок, использующих тип ссылки Parent/Child. Некоторые функции зависят от версий. Дополнительные сведения см. в следующих статьях:

Чтобы добавить ссылку на другой рабочий элемент на веб-портале, сделайте следующее:

  1. Откройте рабочий элемент, из которого нужно связаться.

  2. В форме рабочего элемента можно выбрать один из двух способов выполнения этой задачи:

    • Перейдите в раздел связанная работа и выберите Добавить ссылку>Существующий элемент.
    • Выберите Ссылки>Добавить ссылку>Существующий элемент.

    снимок экрана: выделенная последовательность кнопок для добавления ссылки на существующий рабочий элемент на вкладке

  3. В раскрывающемся списке тип ссылки выберите тип ссылки , который вы хотите создать, например, дочерние, родительскиеили связанные.

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

    В следующем примере используется тип ссылки Related для обращения к тестовому случаю с идентификатором 280.

    Снимок экрана: диалоговое окно добавления ссылки, веб-портал в существующий рабочий элемент.

    Ссылки можно добавлять только в один раз. Нельзя вводить идентификаторы, разделенные запятыми или пробелами.

    Чтобы связаться с несколькими рабочими элементами, введите идентификаторы, разделенные запятыми или пробелами. Если вы не знаете идентификаторы или как связать элемент в другом проекте, выберите Дополнительные действия.

  1. На веб-портале откройте страницу результатов запросов невыполненной работы илизапроса.

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

  3. Выберите Дополнительные действия для выбранных рабочих элементов, выберите Добавить ссылку, а затем выберите Ссылку на существующий элемент... или Ссылку на новый рабочий элемент....

    В следующем примере мы выбираем несколько вариантов из бэклога продукта и выбираем Ссылку на существующий элемент....

    Снимок экрана: контекстное меню невыполненной работы, пункты с несколькими выборами в невыполненной работе, откройте контекстное меню, выберите

  4. Выберите в раскрывающемся меню тип ссылки, например Родительский, Дочернийили Связанные.

  5. В поле Рабочий элемент введите идентификатор рабочего элемента, к которому хотите присоединить, а затем выберите Добавить ссылку.

  1. На веб-портале откройте рабочий элемент и выберите "Ссылки".

  2. Выберите ссылку "Изменить дополнительные действия".>

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

  3. Выберите тип ссылки, на который нужно изменить, и нажмите кнопку "Сохранить".

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

Выполните следующие действия, чтобы связать рабочий элемент с новым рабочим элементом.

  1. В вашем рабочем элементе выберите Ссылки>Добавить ссылку>Новый элемент.

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

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

    Снимок экрана: диалоговое окно добавления ссылки, ссылка на новый рабочий элемент.

    Новый рабочий элемент открывается.

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

    Снимок экрана: добавлена проблема с новым рабочим элементом.

Выполните следующие действия, чтобы связать рабочие элементы с объектами, определенными в других организациях Azure DevOps. Это можно сделать только в том случае, если обе организации используют один и тот же идентификатор Microsoft Entra для управления пользователями.

  1. Из вашего рабочего элемента выберите Ссылки>Добавить ссылку>существующий элемент.

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

  2. Выберите один из следующих типов удаленных ссылок в раскрывающемся меню типа ссылок:

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

  3. Введите URL-адрес удаленного рабочего элемента, а затем выберите Добавить ссылку.

    В следующем примере используется тип ссылки "Удаленный связанный" для ссылки на рабочий элемент с идентификатором 350 , который существует в организации remotelinkingtest2 , проекте RemoteLinking .

    Снимок экрана: удаление ссылки на рабочий элемент.

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

    В следующем примере показаны две удаленные ссылки, указанные значком облака, добавленными в историю пользователя.

    Снимок экрана: форма

  1. В описании запроса на вытягивание введите # , чтобы активировать #ID средство выбора рабочих элементов. В списке отображаются 50 рабочих элементов, которые вы недавно изменили или назначили вам.

    Снимок экрана: список рабочих элементов, созданный при вводе символа # в описании PR.

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

    Снимок экрана: ввод ключевого слова после символа # и результирующего рабочего элемента в поиске.

Дополнительные сведения см. в разделе "Ссылка на рабочие элементы" из запросов на вытягивание, фиксации и комментарии.

При подключении Azure Boards к репозиториям GitHub можно связать рабочие элементы с веткой GitHub, коммитом GitHub, задачей GitHubи pull request GitHub. Вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы.

При подключении Azure Boards к репозиториям GitHub можно связать рабочие элементы с GitHub Commit и запросом на вытягивание GitHub. Вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы.

Внимание

Рабочие элементы можно связать только с объектами GitHub с репозиториями, подключенными к Azure Boards. Дополнительные сведения см. в разделе "Подключение azure Boards к GitHub" и "Ссылка на рабочие элементы" из запросов на вытягивание, фиксации и комментарии.

Дополнительные сведения см. в статье "Связывание фиксаций GitHub", запросы на вытягивание, ветви и проблемы с рабочими элементами и автоматически завершенные рабочие элементы с запросами на вытягивание.

  1. На странице невыполненных задач или результатов запроса выберите несколько рабочих элементов, которые вы хотите связать с новой ветвью Git.

  2. Щелкните значок действий , а затем Создать ветвь.... Дополнительные сведения см. в статье Связывание рабочих элементов с объектами разработки Git.

    Снимок экрана: невыполненная работа, контекстное меню, выберите

Выполните следующие действия, чтобы связать рабочие элементы с существующими сборками. Эти сборки могут находиться в проекте или в других проектах в вашей организации или коллекции.

Примечание.

Для этой функции требуется установить обновление Azure DevOps Server 2020.1. Дополнительные сведения см. в заметках о выпуске Azure DevOps Server 2020 с обновлением 1 RC1, досках.

  1. Из вашего рабочего элемента выберите Ссылки>Добавить ссылку>существующий элемент.

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

    Номер сборки — это сочетание имени конвейера и сборки. Если номер сборки не известен, выберите Найти сборки.

    скриншот, на котором выделена кнопка

  3. Выберите параметры для фильтрации поиска сборок.

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

    Например, можно указать номер сборки, выбрать конвейер сборки или результат сборки, например "Все", "Все", "Частично выполнено", "Неудачно" или "Отменено". Кроме того, успешно выбраны для результатов, выберите Найти сборки, чтобы получить список доступных сборок, к которым можно связаться.

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

  4. Выберите сборку из списка, с которым вы хотите связаться, а затем выберите Подтвердить.

  5. Выберите Добавить ссылку, чтобы завершить операцию.

    Снимок экрана: диалоговое окно добавления ссылки с введенным номером сборки.

Рабочие элементы можно связать с существующими сборками из диалогового окна добавления ссылки .

  1. На вкладке "Ссылки" рабочего элемента нажмите кнопку "Добавить ссылку>" "Существующий элемент".

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

    Номер сборки — это сочетание имени конвейера и сборки. Если номер сборки не известен, найдите его, выбрав значок.

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

  3. В диалоговом окне "Компоновка сборки" выберите параметры для фильтрации поиска сборок.

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

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

  4. Выберите сборку из списка, к которому нужно связаться, и нажмите кнопку "ОК".

  5. В диалоговом окне "Добавить ссылку" нажмите кнопку "ОК", чтобы завершить операцию.

    Снимок экрана: диалоговое окно добавления ссылки с введенным номером сборки.

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

Типы ссылок, используемые для создания этих ссылок: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item и Integrated in release environment. Эти типы отображаются на следующем рисунке.

Концептуальное изображение типов ссылок devops.

Совет

Начинайте разработку с рабочего элемента в момент его создания. Можно также добавить идентификатор рабочего элемента при создании веток, изменений и запросов на вытягивание. Git позволяет связать рабочие элементы с коммитами с помощью типа ссылки коммита. Вот как это сделать:

  • Перед фиксацией изменений добавьте идентификаторы рабочих элементов в изменения Git для Visual Studio 2022 или Team Explorer для предыдущих версий Visual Studio:

    снимок экрана: добавление идентификатора рабочего элемента или перетаскивания элементов перед фиксацией изменений.

  • Используйте команду git-commit и добавьте идентификатор рабочего элемента в комментарий. Например, примените этот комментарий #35 Catch null exception к фиксации. При отправке фиксации система создает связь фиксации между фиксацией и рабочим элементом #35.

  • Используйте элемент управления разработки для разработки Git из рабочего элемента. Дополнительные сведения см. в статье о разработке Drive Git из рабочего элемента в Azure Boards.

Как показано на следующем рисунке, элемент управления развертыванием отображает сведения о выпуске на двух этапах выпуска. Он включает рабочие элементы, связанные с фиксацией Git или запросом на вытягивание для конвейера выпуска, настроенного для интеграции с Azure Boards.

Снимок экрана: несколько сред, предназначенных для выпуска.

Контроль развертывания

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

  • внешний вид по умолчанию: элемент управления развертыванием отображается на формах рабочих элементов следующих типов: пользовательская история (Agile), элемент невыполненной работы продукта (Scrum), проблема (Basic), требование (CMMI), Компонент, Эпик, Баг, Задача и Тест-кейс по умолчанию.

  • Типы пользовательских рабочих элементов: Пользовательские типы рабочих элементов, использующие Унаследованный процесс, автоматически включены.

  • Сведения о выпуске: Управление развертыванием отображает информацию о выпуске для этапов конвейера выпуска, интегрированного с Azure Boards.

  • Связанные рабочие элементы: этот элемент управления отображает только те рабочие элементы, которые связаны с коммитом или запросом на слияние Git для этого конвейера.

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

    Снимок экрана: форма рабочего элемента, элемент управления

  • Ассоциации коммитов: Рабочие элементы, связанные с коммитами в сборке, представляют состояние выпуска.

  • объем проекта: только рабочие задачи в одном проекте связываются с определенным местом, где находится конвейер выпуска.

    Снимок экрана: несколько сред, предназначенных для выпуска.

  • видимость этапа: При открытии рабочего элемента можно просмотреть этапы в режиме реального времени.

    Снимок экрана: этапы параметров выпуска, включая тестирование, промежуточное размещение, рабочую среду и разработку.

Чтобы заполнить элемент управления развертыванием, сделайте следующее:

Примечание.

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

  1. Определите классическую конвейерную модель выпуска и настройте стадии выпуска, как описано в разделе Определение вашего многосоставного конвейера непрерывного развертывания (CD).

  2. Настройте конвейер.

  3. Связывание рабочих элементов с запросом фиксации или извлечения в репозитории Azure Repos Git. Дополнительные сведения см. в разделе:

  4. Запуск конвейера.

Team Foundation Version Control (TFVC) позволяет связывать рабочие элементы с изменениями в системах управления версиями или версиями файлов исходного кода, используя типы ссылок Changeset и Versioned Item. При регистрации ожидающих изменений или использовании "Моя работа" для фиксации изменений, рабочие элементы автоматически привязываются к вашим изменениям. Дополнительные сведения см. в статье "Проверка работы".

Снимок экрана: Team Explorer, My Work, Pending Changes, Check in.

Типы ссылок, связанные с тестом, связывают рабочие элементы управления тестами друг с другом или с другими рабочими элементами. На веб-портале или в Microsoft Test Manager можно посмотреть, какие тестовые случаи определены для набора тестов и какие наборы тестов определены для плана тестирования. Эти объекты не связаны друг с другом с помощью типов ссылок.

Рабочие элементы можно связать с тестируемыми вариантами с помощью типов ссылок Tested/Tested By . Используйте те же элементы управления ссылками, которые используются для связывания рабочих элементов с другими рабочими элементами. См. статью " Ссылки рабочих элементов".

На следующем рисунке показан полный набор типов ссылок, которые можно использовать с типами рабочих элементов управления тестами. Большинство связей между объектами управления тестами выполняются путем выполнения задачи на страницах тестирования или Microsoft Test Manager.

Снимок экрана: типы ссылок, используемые для связывания тестовых объектов.

Например, при добавлении общих шагов в тестовый случай они автоматически связываются с помощью типов ссылок "Тестовый случай" или "Общие шаги ". Дополнительные сведения см. в разделе "Общий доступ между тестовых вариантов".

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

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

В разделе Test можно добавить планы тестирования, наборы тестов и тестовые случаи, которые будут автоматически связаны. Эти элементы нельзя добавить с помощью определенного типа ссылки. Тестовая система создает ассоциации результатов теста и управляет ими с тестовых вариантами и планами тестирования.

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

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

Снимок экрана: тип ссылки

Azure DevOps предоставляет несколько способов просмотра зависимостей и отслеживания связанных работ:

  • редактор запросов. С помощью редактора запросов можно создать настраиваемые запросы, отображающие все рабочие элементы, связанные с определенным рабочим элементом.
  • Невыполненные работы и доски: В представлениях невыполненных работ и досок отображаются связи между родительскими и дочерними рабочими элементами, что позволяет мгновенно увидеть зависимости.
  • средство отслеживания зависимостей. Средство отслеживания зависимостей — это отчет Power BI, предоставляющий визуальное представление зависимостей между рабочими элементами.

Чтобы просмотреть список всех объектов, связанных с рабочим элементом, сделайте следующее:

  1. Откройте рабочий элемент и выберите "Ссылки". Вкладка ссылок указывает количество всех связанных объектов. Связанные объекты группируются в соответствии с типом ссылки с подсчетом в каждой группе.

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

  2. (Необязательно) Разверните или свернуть каждую группу и сортируйте в каждой группе по состоянию, последнему обновлению или примечания , выбрав соответствующий заголовок столбца.

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

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

    Ссылки, предусловленные восклицательным знаком, указывают на удаление сборки, выпуска или другого объекта. Из-за политик хранения эти объекты автоматически удаляются после определенного периода времени.

Запрос связанных рабочих элементов

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

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

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

Вы не можете запрашивать рабочие элементы в релизах, но вы можете запрашивать рабочие элементы с внешними ссылками. Добавьте дополнительные фильтры запросов для уточнения поиска.

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

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

Вы можете добавлять, удалять и отображать сведения о ссылках на рабочий элемент с помощью команды az boards work-item relation . Дополнительные сведения см. в статье "Начало работы с Azure DevOps CLI".

Типы ссылок включают типы рабочих ссылок, типы удаленных ссылок, гиперссылки и вложенные файлы. Для списка всех типов ссылок, которые можно указать, выполните команду az boards work-item relation list-type .

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

В следующих примерах организация является fabrikam, а идентификатор проекта соответствует aaaa-0000-1111-2222-bbbb. Формат таблицы используется для отображения выходных данных. Другие форматы см. в разделе "Выходные форматы" для команд Azure CLI.

Чтобы связать один или несколько рабочих элементов с одним рабочим элементом, введите команду az boards work-item relation add .

Обязательные параметры включают идентификатор рабочего элемента для ссылки и типа ссылки. Поддерживаемые типы ссылок включают родительский, дочерний, связанный и удаленный. Для списка всех типов ссылок выполните команду az boards work-item relation list-type .

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

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

Следующая команда связывает идентификатор рабочего элемента=2807 с идентификатором рабочего элемента=2794 с типом дочерней ссылки. Команда возвращает список всех ссылок, определенных для рабочего элемента.

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

Чтобы просмотреть сведения для связанных рабочих элементов, введите один из URL-адресов, перечисленных в браузере.

Чтобы удалить один или несколько связанных рабочих элементов из одного рабочего элемента, введите команду az boards work-item relation remove .

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

Необходимо указать идентификатор целевого рабочего элемента. Можно указать несколько значений, разделив идентификаторы или URL-адреса с запятой.

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

Следующая команда удаляет ссылку на рабочий элемент ID=2794 из рабочего элемента ID=2856 для работы элемента с типом дочернейссылки. Команда возвращает список всех ссылок, определенных для рабочего элемента.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805

Чтобы просмотреть сведения для связанных рабочих элементов, введите один из URL-адресов, перечисленных в браузере.

Чтобы просмотреть рабочие элементы, связанные с одним рабочим элементом, введите команду az boards work-item relation show . Чтобы получить список всех типов ссылок, которые можно вернуть, выполните команду az boards work-item relation list-type .

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

Следующая команда содержит сведения о ссылках, определенных для рабочего элемента ID=2931 в организации fabrikam в формате таблицы.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

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

Выполните следующие действия, чтобы удалить ссылку на рабочий элемент.

  1. Откройте рабочий элемент.
  2. Выберите вкладку "Ссылки", чтобы просмотреть список ссылок.
  3. Выберите ссылку, которую нужно удалить, и нажмите кнопку "Удалить".
  4. Убедитесь, что вы хотите удалить ссылку.

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

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