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

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

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

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

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

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

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

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

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

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

Эти средства обеспечивают гибкость управления ссылками "Родитель-ребенок" на основе рабочего процесса и настроек.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. Чтобы добавить ссылку, нажмите кнопку с несколькими выборами (выделением) рабочих элементов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Снимок экрана нового рабочего элемента: добавлена задача.

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

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

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

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

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

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

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

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

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

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

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

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

Внимание

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Совет

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

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

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

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

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

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

Снимок экрана среды, на которые нацелен выпуск.

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

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

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

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

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

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

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

    Снимок экрана: форма элемента работы, контроль развертывания.

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

Снимок экрана: Проводник команды, Моя работа, Ожидающие изменения, регистрация.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Связанный контент