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

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

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

В этой статье описано, как выполнить следующие задачи:

В этой статье описано, как выполнить следующие задачи:

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

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

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

Тип ссылки Столбец2
Гиперссылка Подключение рабочий элемент в любой URL-адрес или сетевую папку
Тип внешней ссылки Подключение рабочий элемент во внешний объект, например объект кода, сборка или вики-страница
Тип канала удаленной работы Подключение рабочие элементы, определенные в разных организациях
Тип ссылки GitHub Подключение рабочий элемент в фиксацию, ошибку или запрос на вытягивание репозитория GitHub
Тип рабочей ссылки Ссылки на рабочие элементы, включая выбор рабочих элементов управления тестом

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

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

  1. На веб-портале откройте рабочий элемент, из которого вы хотите связаться, или создайте новый.
  2. Перейдите на вкладку "Ссылки" и выберите ссылку.
  3. В раскрывающемся списке "Тип ссылки" выберите тип ссылки, которую вы хотите создать.
  4. В поле "Ссылка на ссылку" введите или выберите объект, к которому требуется связаться. В зависимости от типа ссылки можно ввести или выбрать следующие объекты. Выберите каждый объект для получения дополнительных сведений.
  5. (Необязательно) Введите комментарий, чтобы описать ссылку.
  6. Выберите ОК для создания ссылки.

Совет

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

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

  1. Откройте рабочий элемент, который требуется связать с другим рабочим элементом.
  2. В форме рабочего элемента выберите раздел "Связанная работа ".
  3. Выберите " Добавить ссылку" и " Существующий элемент".
  4. В раскрывающемся списке типов ссылок выберите тип создаваемой ссылки (например, Parent, Child, Related и т. д.).
  5. В поле "Рабочий элемент" введите идентификатор рабочего элемента, к которому нужно связаться, а затем нажмите кнопку "ОК". В следующем примере используется тип связанной ссылки для связывания трех элементов с идентификатором 400.

Screenshot of Add link dialog, web portal, to an existing work item.

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

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

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

Screenshot of Query results page, save bulk modified items.

Screenshot of Query results page, multi-select items, bulk save modified work items, TFS-2018 and earlier versions.

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

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

    В следующем примере мы с несколькими выборами из невыполненной работы продукта и выберите существующий элемент.... Screenshot of backlog context menu, Multi-select items in backlog, open context menu, choose Add link to an existing work item.

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

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

    Screenshot of Links tab, open More actions, choose Edit link option.

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

    Screenshot of Edit link dialog.

  4. Сохраните рабочий элемент.

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

  1. Укажите тип ссылки, тип рабочего элемента и заголовок нового рабочего элемента. Нажмите ОК. Рабочий элемент выбранного типа.

    Screenshot of Add link dialog, Link to new work item.

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

    Screenshot of new work item Issue added.

  3. (Необязательно) Если вы работаете на странице результатов запроса, массово сохраните измененные рабочие элементы.

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

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

Screenshot of the User Story form, Link tab, showing two external links.

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

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

    • Используется from/Produces For: Если требуется отслеживать зависимости рабочих элементов, определенных в разных организациях и управляемых различными командами.
    • Удаленные связи: когда рабочие элементы, связанные, определяются в разных организациях и управляются разными командами, но не имеют сильных межзависимостей.
  2. В диалоговом окне "Добавить ссылку" выберите тип ссылки, введите URL-адрес удаленного рабочего элемента и нажмите кнопку "ОК".

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

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

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

Screenshot of User Story form, Link tab, showing two external links. ::: moniker-end

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

    Screenshot of work item list produced when entering # in PR description.

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

    Screenshot of entering keyword after # and resulting work item in search.

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

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

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

Важно!

Рабочие элементы можно связать только с объектами GitHub с репозиториями, подключенными к Azure Boards. Дополнительные сведения см. в разделе Подключение Azure Boards to GitHub и Link to work items from pull requests, commits and comments.

Дополнительные сведения см. в статье Link GitHub commits, pull requests, and issues to work items and Auto complete work items with pull requests.

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

Screenshot of backlog, context menu, choose Link multiple backlog items to a git branch.

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

Примечание.

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

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

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

    Если вы не знаете номер сборки ( сочетание имени конвейера и сборки), его можно найти, выбрав значок.

    Screenshot of Add link dialog with Build link type selected.

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

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

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

    Screenshot of Find builds dialog with project selected and builds listed.

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

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

    Screenshot of Add link dialog with Build number entered.

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

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

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

    Если вы не знаете номер сборки ( сочетание имени конвейера и сборки), его можно найти, выбрав значок.

    Screenshot of Add link dialog with Build link type selected.

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

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

    Screenshot of Find builds dialog, link to a build within your project.

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

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

    Screenshot of Add link dialog with Build number entered.

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

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

Conceptual image of devops link types.

Типы ссылок, используемые для создания этих ссылок , как показано на следующем рисунке: Branch, Build, Changeset, Commit, Pull Request и Versioned Item.

Screenshot of Artifact-to-artifact link types.

Дополнительные сведения см. в разделе "Элементы LinksControlOptions", элемент управления "Ссылки разработки".

Совет

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

  • Добавьте идентификаторы рабочих элементов в Visual Studio Team Обозреватель перед фиксацией изменений.
    Screenshot of Add work item ID or drag items before you commit your changes.
  • Используйте команду git-commit и добавьте идентификатор рабочего элемента в комментарий. Например, примените этот комментарий #35 Catch null exception к фиксации. При отправке фиксации система создает связь фиксации между фиксацией и рабочим элементом #35.
  • Используйте элемент управления "Разработка", чтобы управлять разработкой Git из рабочего элемента.

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

Screenshot of multiple environments that the release is targeting.

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

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

Элемент управления развертыванием по умолчанию отображается в формах рабочих элементов для пользовательских историй (Agile), элемента невыполненной работы продукта (scrum), проблемы (базовый), требования (CMMI), компонента, epic, Bug, Task и Test Case рабочих элементов. Он также включен автоматически для пользовательских типов рабочих элементов, использующих унаследованный процесс. Элемент управления "Развертывание" отображает сведения о выпуске на двух этапах конвейера выпуска, интегрированного с Azure Boards. В этом элементе управления отображаются только рабочие элементы, связанные с запросом фиксации или извлечения Git для этого конвейера. Вы также можете получить визуальное представление о состоянии рабочего элемента, так как оно развертывается в разных средах выпуска и быстро переходите к каждому этапу выпуска и запуску.

Screenshot of Work item form, Deployment control.

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

Screenshot showing multiple environments that the release is targeting.

Этапы можно увидеть в режиме реального времени при открытии рабочего элемента.

Screenshot of Release Settings Stages.

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

Примечание.

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

  1. Определите классический конвейер выпуска и настройте этапы выпуска, как описано в разделе "Определение конвейера непрерывного развертывания (CD).
  2. Настройте конвейер, как описано в разделе "Настройка конвейеров для поддержки отслеживания работы", состояния развертывания отчета в Boards.
  3. Связывание рабочих элементов с запросом фиксации или извлечения в репозитории Azure Repos Git. Для получения дополнительной информации см.
  4. Запуск конвейера.

Управление версиями Team Foundation (TFVC) позволяет связывать рабочие элементы с наборами изменений в версиях или версиями файлов исходного кода с помощью типов ссылок "Изменения " и "Версияя элемента ". При проверка в ожидающих изменениях или использовании my Work для проверка изменений рабочие элементы автоматически связываются с изменениями.

Screenshot of Team Explorer, My Work, Pending Changes, check in.

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

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

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

Screenshot of Link types used to link test objects.

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

Screenshot of test work item form showing steps.

Screenshot of Insert Shared Steps dialog.

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

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

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

Screenshot of Hyperlink or Storyboard link type to link a work item to a URL.

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

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

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

Screenshot of Links tab with count of linked objects.

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

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

Screenshot of Links tab with many linked objects.

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

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

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

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

Примеры запросов см. в разделе "Ссылки" и "Запросы вложений".

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

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

  1. В диалоговом окне "Добавить ссылку" выберите ... контекстное меню или выберите "Обзор " (Visual Studio), чтобы открыть следующее диалоговое окно.

Screenshot of linked work items.

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

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

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

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

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

    • На веб-портале: удерживайте клавишу SHIFT, чтобы выбрать несколько элементов в последовательности. Используйте клавиши CTRL, чтобы выбрать несколько неквалентных элементов.

    • В Visual Studio выберите каждый рабочий элемент, который должен связаться с текущим рабочим элементом. При нажатии клавиши SHIFT можно также выбрать диапазон рабочих элементов или нажать клавиши CTRL, щелкнув несколько рабочих элементов.

Вы можете добавлять, удалять и отображать сведения о ссылках на рабочий элемент с помощью команды 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 , а идентификатор проекта соответствует cebd7ef5-4282-448b-9701-88c8637581b7. Формат таблицы используется для отображения выходных данных. Другие форматы см. в разделе "Выходные форматы" для команд 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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/847568d2-6541-4a99-a240-228510ccbff7/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

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

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

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

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

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

Следующие шаги

Визуализация связанных работ и других объектов. Скачайте расширение визуализации рабочих элементов, доступное на вкладке Visual Studio Marketplace, Azure DevOps.