Связывание рабочих элементов с объектами
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Ссылки на рабочие элементы — это связи между двумя рабочими элементами или рабочим элементом и другим объектом, описывающим их отношения. Ссылки на рабочий элемент можно использовать для отслеживания зависимостей и связанных работ для трассировки, совместного использования информации, управления сложными проектами, включающих несколько команд или продуктов, отслеживать изменения кода, тесты и многое другое.
- Связывание рабочих элементов с различными объектами
- Связывание рабочих элементов с другими рабочими элементами
- Связывание нескольких рабочих элементов
- Изменение типа ссылки существующей ссылки
- Связывание рабочих элементов с новыми рабочими элементами
- Связывание рабочих элементов с рабочими элементами в разных проектах (между организациями)
- Связывание рабочих элементов с запросами на вытягивание
- Связывание рабочих элементов с объектами GitHub
- Связывание нескольких элементов с новыми ветвями Git
- Связывание рабочих элементов со сборками
- Связывание рабочих элементов с развертываниями
- Связывание рабочих элементов с разработкой кода TFVC
- Связывание рабочих элементов с тестами
- Связывание рабочих элементов с веб-сайтом, сетевым ресурсом, раскадровкой или документом
- Просмотр зависимостей и отслеживание связанных работ
- Запрос связанных рабочих элементов
- Добавление, удаление или отображение ссылок с помощью Azure CLI
- Удаление ссылок рабочего элемента
В этой статье описано, как выполнить следующие задачи:
- Связывание рабочих элементов с различными объектами
- Связывание рабочих элементов с другими рабочими элементами
- Связывание нескольких рабочих элементов
- Изменение типа ссылки существующей ссылки
- Связывание рабочих элементов с новыми рабочими элементами
- Связывание рабочих элементов с запросами на вытягивание
- Связывание рабочих элементов с объектами GitHub
- Связывание нескольких элементов с новыми ветвями Git
- Связывание рабочих элементов со сборками
- Связывание рабочих элементов с развертываниями
- Связывание рабочих элементов с разработкой кода TFVC
- Связывание рабочих элементов с тестами
- Связывание рабочих элементов с веб-сайтом, сетевым ресурсом, раскадровкой или документом
- Просмотр зависимостей и отслеживание связанных работ
- Запрос связанных рабочих элементов
- Добавление, удаление или отображение ссылок с помощью Azure CLI
- Удаление ссылок рабочего элемента
Необходимые компоненты
Необходимые условия | Description |
---|---|
Администратор проекта или участник | Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов. |
Доступ заинтересованных лиц | Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше. Пользователи с доступом заинтересованных лиц для общедоступных проектов имеют полный доступ к функциям невыполненной работы и доски, например пользователям с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц. |
Участник или разрешить пермы | — Для просмотра или изменения рабочих элементов необходимо иметь рабочие элементы view в этом узле и изменить рабочие элементы в этом узле, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы". — Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска. — Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, необходимо задать разрешения "Изменить рабочие элементы" в этом узле , чтобы разрешить путь к области, назначенный рабочему элементу. По умолчанию группа участников имеет этот набор разрешений. — Для просмотра рабочих элементов необходимо иметь рабочие элементы представления в этом узле, заданные для разрешения пути к области, назначенному рабочему элементу. |
Определенные итерации | Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды. |
Предварительные требования | Description |
---|---|
Администратор проекта или участник | Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов. |
Доступ заинтересованных лиц | Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше. |
Участник или разрешить пермы | — Для просмотра или изменения рабочих элементов необходимо иметь рабочие элементы view в этом узле и изменить рабочие элементы в этом узле, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы". — Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска. — Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, необходимо задать разрешения "Изменить рабочие элементы" в этом узле , чтобы разрешить путь к области, назначенный рабочему элементу. По умолчанию группа участников имеет этот набор разрешений. — Для просмотра рабочих элементов необходимо иметь рабочие элементы представления в этом узле, заданные для разрешения пути к области, назначенному рабочему элементу. |
Определенные итерации | Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды. |
Предварительные требования | Description |
---|---|
Администратор проекта или участник | Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов. |
Доступ заинтересованных лиц | Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше. |
Участник или разрешить пермы | Чтобы просмотреть или изменить рабочие элементы, необходимо иметь рабочие элементы Представления в этом узле и изменить рабочие элементы в разрешениях этого узла, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы". |
Определенные итерации | Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды. |
Какие типы ссылок существуют?
Следующие типы ссылок помогают управлять различными связями между рабочими элементами и другими объектами.
Тип ссылки | Столбец2 |
---|---|
Гиперссылка | Подключает рабочий элемент к любому URL-адресу или сетевому ресурсу |
Тип внешней ссылки | Подключает рабочий элемент к внешнему объекту, например объекту кода, сборке или вики-странице |
Тип канала удаленной работы | Подключает рабочие элементы, определенные в разных организациях |
Тип ссылки GitHub | Подключает рабочий элемент к фиксации, проблеме или запросу на вытягивание репозитория GitHub |
Тип рабочей ссылки | Ссылки на рабочие элементы, включая выбор рабочих элементов управления тестом |
Дополнительные сведения о типах ссылок, включая родительский или дочерний, связанные, предшественник-преемник и т. д., см. в разделе Ссылочные типы ссылок/Типы ссылок Work.
Связывание рабочих элементов с различными объектами
Чтобы связать рабочие элементы с различными объектами, выполните следующие действия.
- На веб-портале откройте рабочий элемент, из которого вы хотите связаться, или создайте новый.
- Перейдите на вкладку "Ссылки" и выберите ссылку.
- В раскрывающемся списке "Тип ссылки" выберите тип ссылки, которую вы хотите создать.
- В поле "Ссылка на ссылку" введите или выберите объект, к которому требуется связаться. В зависимости от типа ссылки можно ввести или выбрать следующие объекты. Выберите каждый объект для получения дополнительных сведений.
- (Необязательно) Введите комментарий, чтобы описать ссылку.
- Выберите ОК для создания ссылки.
Совет
Существуют другие функции, которые можно использовать для быстрого связывания или изменения ссылок, использующих тип ссылки "Родительский или дочерний " (некоторые функции зависят от версий, см. дополнительные сведения о связанных статьях).
- Чтобы связать элементы невыполненной работы с элементами невыполненной работы или изменить структуру ссылок между этими элементами, используйте область сопоставления для организации невыполненной работы. Кроме того, можно выбрать отображение элементов "Родители " и "Перетаскивание" в иерархии деревьев.
- Чтобы создать и связать задачи с элементами невыполненной работы, используйте страницу невыполненной работы с спринта. На веб-портале можно также перетащить элементы, чтобы изменить структуру ссылок.
- Для отступа (), отступа (), изменения структуры ссылок иерархии дерева, повторного и переупорядочения элементов из невыполненной работы на веб-портале или использования запроса дерева в Team Explorer.
- Чтобы добавить или удалить рабочие элементы или изменить структуру ссылок, можно использовать Excel. См. статью "Массовое добавление или изменение рабочих элементов" в Excel.
Связывание рабочих элементов с другими рабочими элементами
Выполните следующие действия, чтобы добавить ссылку на другую историю пользователя, эпическую, функцию, ошибку, проблему или задачу на веб-портале.
- Откройте рабочий элемент, который требуется связать с другим рабочим элементом.
- В форме рабочего элемента выберите раздел "Связанная работа ".
- Выберите " Добавить ссылку" и " Существующий элемент".
- В раскрывающемся списке типов ссылок выберите тип создаваемой ссылки (например, Parent, Child, Related и т. д.).
- В поле "Рабочий элемент" введите идентификатор рабочего элемента, к которому нужно связаться, а затем нажмите кнопку "ОК". В следующем примере используется тип связанной ссылки для связывания трех элементов с идентификатором 400.
Ссылки можно добавлять только в один раз. Нельзя вводить идентификаторы, разделенные запятыми или пробелами.
Чтобы связаться с несколькими рабочими элементами, введите идентификаторы, разделенные запятыми или пробелами. Если вы не знаете идентификаторы или хотите связаться с элементом в другом проекте, выберите "Дополнительные действия".
- (Необязательно) Если вы работаете на странице результатов запроса, массово сохраните измененные рабочие элементы. При работе из невыполненной работы рабочие элементы автоматически сохраняются.
Связывание нескольких рабочих элементов
На веб-портале откройте страницу результатов невыполненной работы или запроса и выберите рабочие элементы, к которым нужно добавить ссылку.
Откройте контекстное меню одного из выбранных рабочих элементов, выберите "Добавить ссылку", а затем выберите "Существующий элемент" или "Создать".
В следующем примере мы с несколькими выборами из невыполненной работы продукта и выберите существующий элемент....
Изменение типа ссылки существующей ссылки
На веб-портале откройте рабочий элемент и выберите "Ссылки".
Выберите ссылку "Изменить дополнительные действия".>
Выберите тип ссылки, на который нужно изменить, и нажмите кнопку "Сохранить".
Сохраните рабочий элемент.
Связывание рабочих элементов с новыми рабочими элементами
Выполните следующие действия, чтобы связать рабочий элемент с новым рабочим элементом.
Укажите тип ссылки, тип рабочего элемента и заголовок нового рабочего элемента. Нажмите ОК. Рабочий элемент выбранного типа.
Введите дополнительные сведения и сохраните рабочий элемент.
(Необязательно) Если вы работаете на странице результатов запроса, массово сохраните измененные рабочие элементы.
Связывание рабочих элементов с удаленными рабочими элементами (между организациями)
Организации, использующие идентификатор Microsoft Entra, могут связываться с рабочими элементами, существующими в разных проектах в разных организациях. Используйте следующие типы ссылок, как указано ниже.
- Используйте типы ссылок", которые используются из и создания ссылок для отслеживания зависимостей рабочих элементов, определенных в разных организациях и управляемых различными командами.
- Используйте тип ссылки удаленного связи, если связанные рабочие элементы определяются в разных организациях и управляются разными командами, но не имеют сильных межзависимостей.
Выполните следующие действия, чтобы связать рабочие элементы с объектами, определенными в других организациях Azure DevOps. Это можно сделать только в том случае, если обе организации используют один и тот же идентификатор Microsoft Entra для управления пользователями.
Выберите один из следующих типов удаленных ссылок:
- Используется from/Produces For: Если требуется отслеживать зависимости рабочих элементов, определенных в разных организациях и управляемых различными командами.
- Удаленные связи: когда рабочие элементы, связанные, определяются в разных организациях и управляются разными командами, но не имеют сильных межзависимостей.
В диалоговом окне "Добавить ссылку" выберите тип ссылки, введите URL-адрес удаленного рабочего элемента и нажмите кнопку "ОК".
В следующем примере мы используем тип ссылки "Удаленные связанные " для ссылки на рабочий элемент с идентификатором 350 , который существует в организации remotelinkingtest2 , проекте RemoteLinking .
Вкладка ссылок поддерживает количество всех ссылок на рабочий элемент. Поле "Число удаленных ссылок" поддерживает количество ссылок, добавленных в рабочий элемент, который связывается с рабочим элементом, определенным в другом проекте или организации.
В следующем примере показаны две удаленные ссылки, указанные значком облака, добавленными в историю пользователя.
Связывание рабочих элементов с запросами на вытягивание
В описании запроса на вытягивание введите
#
, чтобы активировать#ID
средство выбора рабочих элементов. Список отображает 50 рабочих элементов, которые вы недавно изменили или назначены вам.Введите до пяти ключевых слов, которые соответствуют типу рабочего элемента, идентификатору или заголовку, чтобы сузить список предлагаемых рабочих элементов.
Дополнительные сведения см. в разделе "Ссылка на рабочие элементы" из запросов на вытягивание, фиксации и комментарии.
При подключении Azure Boards к репозиториям GitHub можно связать рабочие элементы с GitHub Commit, GitHub Pull Request, GitHub Branch и GitHub Issue. Таким образом, вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы.
При подключении Azure Boards к репозиториям GitHub можно связать рабочие элементы с GitHub Commit и запросом на вытягивание GitHub. Таким образом, вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы.
Внимание
Рабочие элементы можно связать только с объектами GitHub с репозиториями, подключенными к Azure Boards. Дополнительные сведения см. в разделе "Подключение azure Boards к GitHub" и "Ссылка на рабочие элементы" из запросов на вытягивание, фиксации и комментарии.
Дополнительные сведения см. в статье "Связывание фиксаций GitHub", запросы на вытягивание, ветви и проблемы с рабочими элементами и автоматически завершенные рабочие элементы с запросами на вытягивание.
Связывание нескольких рабочих элементов с новыми ветвями Git
На странице результатов невыполненной работы или запроса выберите рабочие элементы, которые требуется связать с новой ветвью Git, щелкните значок действий, а затем создать ветвь.... Дополнительные сведения см. в статье "Связывание рабочих элементов с объектами разработки Git".
Связывание рабочих элементов со сборками
Выполните следующие действия, чтобы связать рабочие элементы с существующими сборками. Эти сборки могут находиться в проекте или в других проектах в вашей организации или коллекции.
Примечание.
Для этой функции требуется установить обновление Azure DevOps Server 2020.1. Дополнительные сведения см. в заметках о выпуске Azure DevOps Server 2020 с обновлением 1 RC1, досках.
На вкладке "Ссылки" рабочего элемента выберите "Добавить ссылку>" "Существующий элемент".
В диалоговом окне "Добавить ссылку" выберите один из типов ссылок на сборку — сборка, найденная в сборке, интегрированная в сборку, и укажите номер сборки.
Если вы не знаете номер сборки ( сочетание имени конвейера и сборки), его можно найти, выбрав значок.
В диалоговом окне "Компоновка сборки" выберите параметры для фильтрации поиска сборок.
Чтобы связаться со сборкой в другом проекте, сначала выберите проект , сборка которого требуется связать.
Например, можно указать номер сборки, выбрать конвейер сборки, результат сборки, например "Все", "Все", "Частично выполнено", "Неудачно" или "Отменено". Или, выбрав "Все " для результата, выберите "Найти ", чтобы получить список доступных сборок для ссылки.
Выберите сборку из списка, к которому нужно связаться, и нажмите кнопку "ОК".
В диалоговом окне "Добавить ссылку" нажмите кнопку "ОК", чтобы завершить операцию.
Рабочие элементы можно связать с существующими сборками из диалогового окна добавления ссылки .
На вкладке "Ссылки" рабочего элемента нажмите кнопку "Добавить ссылку>" "Существующий элемент".
В диалоговом окне "Добавить ссылку" выберите один из типов ссылок на сборку — сборка, найденная в сборке, интегрированная в сборку, и укажите номер сборки.
Если вы не знаете номер сборки ( сочетание имени конвейера и сборки), его можно найти, выбрав значок.
В диалоговом окне "Компоновка сборки" выберите параметры для фильтрации поиска сборок.
Например, можно указать номер сборки, выбрать конвейер сборки, результат сборки, например "Все", "Все", "Частично выполнено", "Неудачно" или "Отменено". Или, выбрав "Все " для результата, выберите "Найти ", чтобы получить список доступных сборок для ссылки.
Выберите сборку из списка, к которому нужно связаться, и нажмите кнопку "ОК".
В диалоговом окне "Добавить ссылку" нажмите кнопку "ОК", чтобы завершить операцию.
Связывание рабочих элементов с развертываниями
При разработке программного обеспечения можно записать изменения кода и сборки, поддерживающие завершение рабочего элемента. Таким образом, ваша команда может понять, что было сделано или как исправлена ошибка с помощью следа аудита изменений в базе кода.
Типы ссылок, используемые для создания этих ссылок , как показано на следующем рисунке: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item и Integrated in release environment.
Совет
Мы рекомендуем выполнить разработку из рабочего элемента во время его создания. Вы также можете добавить идентификатор рабочего элемента при создании ветвей, фиксаций и запросов на вытягивание. Git позволяет связать рабочие элементы с фиксацией с помощью типа ссылки Commit . Это можно сделать следующими способами.
- Добавьте идентификаторы рабочих элементов в Visual Studio Team Explorer перед фиксацией изменений.
- Используйте команду git-commit и добавьте идентификатор рабочего элемента в комментарий. Например, примените этот комментарий
#35 Catch null exception
к фиксации. При отправке фиксации система создает связь фиксации между фиксацией и рабочим элементом #35. - Используйте элемент управления "Разработка", чтобы управлять разработкой Git из рабочего элемента.
Как показано на следующем рисунке, элемент управления развертыванием отображает сведения о выпуске на двух этапах выпуска. Он включает рабочие элементы, связанные с фиксацией Git или запросом на вытягивание для конвейера выпуска, настроенного для интеграции с Azure Boards.
Контроль развертывания
Формы рабочих элементов предоставляют два элемента управления для отображения и быстрого перехода к объектам разработки. Элемент управления "Развертывание" описан в этой статье, а элемент управления "Разработка" описан в разделе "Разработка диска Git" из рабочего элемента.
По умолчанию элемент управления развертыванием отображается в формах рабочих элементов для пользовательской истории (Agile), элемента невыполненной работы продукта (scrum), проблемы (базовый), требования (CMMI), компонента, epic, Bug, Task и Test Case рабочих элементов.
Пользовательские типы рабочих элементов, использующие унаследованный процесс, автоматически включены. Элемент управления "Развертывание" отображает сведения о выпуске на двух этапах конвейера выпуска, интегрированного с Azure Boards.
В этом элементе управления отображаются только рабочие элементы, связанные с запросом фиксации или извлечения Git для этого конвейера. Вы также можете получить визуальное представление о состоянии рабочего элемента, так как оно развертывается в разных средах выпуска и быстро переходите к каждому этапу выпуска и запуску.
Рабочие элементы, связанные с фиксациями в сборке, показывают состояние выпуска. Но только рабочие элементы в одном проекте будут связаны с тем, где определен конвейер выпуска.
Этапы можно увидеть в режиме реального времени при открытии рабочего элемента.
Чтобы заполнить элемент управления развертыванием, сделайте следующее:
Примечание.
Элемент управления развертывания требует настройки классического конвейера выпуска. Он не поддерживает связывание с этапами выпуска, определенными для конвейера YAML.
- Определите классический конвейер выпуска и настройте этапы выпуска, как описано в разделе "Определение конвейера непрерывного развертывания (CD).
- Настройте конвейер, как описано в разделе "Настройка конвейеров для поддержки отслеживания работы", состояния развертывания отчета в Boards.
- Связывание рабочих элементов с запросом фиксации или извлечения в репозитории Azure Repos Git. Для получения дополнительной информации см.
- Запуск конвейера.
Связывание рабочих элементов с разработкой кода TFVC
Управление версиями Team Foundation (TFVC) позволяет связывать рабочие элементы с наборами изменений в версиях или версиями файлов исходного кода с помощью типов ссылок "Изменения " и "Версияя элемента ". При возврате ожидающих изменений или использовании my Work для проверки изменений рабочие элементы автоматически связываются с изменениями.
Связывание рабочих элементов с тестами
Типы ссылок, связанные с тестом, связывают рабочие элементы управления тестом друг с другом или с другими рабочими элементами. На веб-портале или Microsoft Test Manager можно просмотреть тестовые случаи, определенные для набора тестов, и какие наборы тестов определены для плана тестирования. Но эти объекты не связаны друг с другом через типы ссылок.
Рабочие элементы можно связать с тестируемыми вариантами с помощью типов ссылок Tested/Tested By . Используйте те же элементы управления ссылками, которые используются для связывания рабочих элементов с другими рабочими элементами, как описано ранее.
На следующем рисунке показан полный набор типов ссылок, которые можно использовать с типами рабочих элементов управления тестами. Большинство связей между объектами управления тестами выполняются путем выполнения задачи на страницах тестирования или Microsoft Test Manager.
Например, при добавлении общих шагов в тестовый случай они автоматически связываются с помощью типов ссылок "Тестовый случай" или "Общие шаги ". Дополнительные сведения см. в разделе "Общий доступ между тестовых вариантов".
Из теста можно добавить планы тестирования, наборы тестов и тестовые случаи, связанные, но не через определенный тип ссылки. Кроме того, система тестирования создает ассоциации результатов тестирования и управляет ими для тестовых вариантов и планов тестирования.
Связывание рабочих элементов с веб-сайтом, сетевым ресурсом, раскадровкой или документом
С помощью гиперссылки или раскадровки можно связать рабочий элемент с веб-сайтом, сетевым ресурсом или документом, расположенным в сетевой папке. Оба этих типа ссылок являются односторонними ссылками. Чтобы добавить эти типы ссылок, используйте те же элементы управления , которые описаны ранее для связывания рабочих элементов.
При использовании типа канала раскадровки вы различаете ссылку, чтобы указать раскадровку или документ, предоставляющий спецификации рабочих элементов. Используйте этот тип ссылки, чтобы предоставить команде доступ к общему файлу, где они могут добавить свои комментарии.
Просмотр зависимостей и отслеживание связанных работ
Azure DevOps предоставляет несколько способов просмотра зависимостей и отслеживания связанных работ: • Редактор запросов. Вы можете использовать Редактор запросов для создания пользовательских запросов, отображающих все рабочие элементы, связанные с определенным рабочим элементом. • Невыполненные работы и доски: в представлениях невыполненных работ и досок отображаются связи между рабочими элементами, что позволяет просматривать зависимости на первый взгляд. • Средство отслеживания зависимостей: средство отслеживания зависимостей — это отчет Power BI, предоставляющий визуальное представление зависимостей между рабочими элементами.
Чтобы просмотреть список всех объектов, связанных с рабочим элементом, выполните следующие действия.
- Откройте рабочий элемент и выберите "Ссылки". Вкладка ссылок указывает количество всех связанных объектов. Связанные объекты группируются в соответствии с типом ссылки с подсчетом в каждой группе.
- (Необязательно) Разверните или свернуть каждую группу и сортируйте в каждой группе по состоянию, последнему обновлению или примечания , выбрав соответствующий заголовок столбца.
Например, на следующей вкладке "Ссылки" показана часть 64 связанных объектов для рабочего элемента.
Ссылки, предусловленные восклицательным знаком, указывают на удаление сборки, выпуска или другого объекта. Из-за политик хранения эти объекты автоматически удаляются после определенного периода времени.
Запрос связанных рабочих элементов
Чтобы отфильтровать элементы на основе иерархических ссылок, используйте тип запроса "Дерево рабочих элементов ". Чтобы отфильтровать элементы на основе всех типов ссылок, используйте рабочие элементы и прямые ссылки.
Чтобы найти рабочие элементы, связанные с другими рабочими элементами с определенными типами ссылок, используйте запрос, показывающий первичный и дополнительный набор рабочих элементов. Основной набор соответствует условиям поля, а вторичный набор связан с основным набором. Вы не можете запрашивать рабочие элементы в выпусках, но можно запрашивать рабочие элементы с внешними ссылками. Чтобы уточнить поиск, добавьте дополнительные фильтры запросов.
Примеры запросов см. в разделе "Ссылки" и "Запросы вложений".
Невозможно создать запрос, показывающий иерархическое представление планов тестирования, наборов тестов и тестовых вариантов. Эти элементы не связаны друг с другом с помощью родительского или дочернего или другого типа ссылки. Иерархию можно просмотреть только на странице "Тестовые>планы тестирования".
Добавление, удаление или отображение ссылок с помощью Azure CLI
Вы можете добавлять, удалять и отображать сведения о ссылках на рабочий элемент с помощью команды 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-адрес для присоединенного файла, чтобы скачать вложение.
Удаление ссылок рабочего элемента
Выполните следующие действия, чтобы удалить ссылку на рабочий элемент.
- Откройте рабочий элемент с ссылками или выберите его из результата запроса.
- Выберите вкладку "Ссылки", чтобы просмотреть список ссылок.
- Выберите ссылку, которую нужно удалить, и нажмите кнопку "Удалить".
- Убедитесь, что вы хотите удалить ссылку.
После того как рабочий элемент будет связан с запросом фиксации или извлечения, он продолжает отображаться в рамках этапов выпуска. Например, если у вас есть рабочий элемент, который не прошел критерии тестирования, может потребоваться удалить его из сборок и выпусков.
Чтобы удалить рабочий элемент из участия в будущих сборках и выпусках, удалите ссылку на последний запрос фиксации и извлечения.
Следующие шаги
Визуализация связанных работ и других объектов. Скачайте расширение визуализации рабочих элементов, доступное на вкладке Visual Studio Marketplace, Azure DevOps.
Связанные статьи
- Справочник по типам ссылок
- Общие сведения о нескольких службах
- Разработка Git на основе рабочего элемента
- Отслеживание зависимостей с помощью планов доставки
- Использование сопоставления для связывания элементов невыполненной работы с функциями и эпическими возможностями
- Массовое изменение ссылок с помощью Excel