Справочник по типам ссылок

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

• Тип рабочей ссылки: ссылки на рабочие элементы, включая элементы управления тест-кейсами
• Гиперссылка: подключение рабочего элемента к любому URL-адресу или сетевому ресурсу
• Тип внешней ссылки: подключает рабочий элемент к внешнему объекту, например объекту кода, сборке или вики-странице
• Тип канала удаленной работы: подключает рабочие элементы, определенные в разных организациях
• Тип ссылки GitHub: подключает рабочий элемент к коммиту, проблеме или pull request репозитория GitHub.

Определенное поле поддерживает количество ссылок для первых четырех типов ссылок, таких как число связанных ссылок, количество гиперссылок, числовнешних ссылок и число удаленных ссылок.

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

Тип рабочей ссылки

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

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

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

Имя

Имя ссылки

Использование

---

Affects-Affected by (только для CMMI)

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Тип топологии: зависимость
Категория ссылок: определяемая процессом

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

Ограничения и рекомендации:

• Свяжите запрос на изменение только с одним требованием с помощью "Влияет". Свяжите требования с таким количеством запросов на изменение дочерних элементов, сколько необходимо, используя Affected by.
• Используйте Affects-Affected только по ссылкам для связывания рабочих элементов в одном проекте. Мы рекомендуем использовать Excel для изменения или обновления данных рабочего элемента.

Дочерний родитель

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Тип топологии: дерево
Категория ссылок: определяемая системой

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

Типичные варианты использования включают:

• Поддерживайте отношения между резюме задач. Родительско-дочерние связи представляют собой суммарные задачи и их подзадачи.
• Связывание задач с PBIs, историями пользователей или требованиями. Поддерживает отчеты "Обзор невыполненных работ", "Обзор историй" и "Обзор требований".

Ограничения и рекомендации:

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

Duplicate-Duplicate

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Тип топологии: дерево
Категория ссылок: определяемая системой

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

Ограничения и рекомендации:

• Рабочий элемент может иметь только один дубликат.
• Для связывания рабочих элементов внутри одного проекта используйте только ссылки «Дубликат» или «Дубликат для». Мы рекомендуем использовать Excel для изменения или обновления данных рабочего элемента.

Ссылки на ссылки

Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Тип топологии: зависимость
Категория ссылок: определяемая процессом

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

Родственный

System.LinkTypes.Related
Тип топологии: сеть
Категория ссылок: определяемая системой

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

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

Преемник-предшественник

System.LinkTypes.Dependency
Тип топологии: зависимость
Категория ссылок: определяемая системой
Выберите предшественник при связывании с рабочим элементом, который должен завершиться до текущего элемента. Выберите преемник при связывании с рабочим элементом, который должен завершиться после текущего элемента.

Используйте эту направленную связь для отслеживания задач, которые должны завершиться до запуска других задач. Связанные задачи отображаются в виде ссылок на предшественников в Azure Boards.

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

Ограничения и рекомендации:

• Ошибка появляется при попытке создать циклические связи.
• Создайте ссылки предшественника-преемника только для рабочих элементов в одном проекте при планировании экспорта в Excel. Вы можете создавать ссылки на предшественников в проектах, но экспорт и импорт Excel будет включать только элементы для проекта, который определяет запрос.

Проверено тестами

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Тип топологии: зависимость
Категория ссылок: определяемая процессом

Связывание тестовых вариантов с рабочими элементами, такими как ошибки, истории пользователей, требования и PBIS. Используйте это для отслеживания тестовых случаев, которые проверяют истории пользователей (Agile), PBIs (Scrum) или требования (CMMI). Для локальной среды Azure DevOps несколько отчетов SQL зависят от этих ссылок. Ознакомьтесь с действиями группы для поддержки полезных отчетов.

Этапы тестирования Case-Shared

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Тип топологии: зависимость
Категория ссылок: определяемая процессом

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

Гиперссылка

Гиперссылка связывает рабочий элемент с любым URL-адресом. Счетчик гиперссылок отслеживает количество гиперссылок для рабочего элемента.

Имя ссылки

Поддерживаемый инструмент

Тип артефакта

Использование

---

Гиперссылка

Отслеживание рабочих элементов

Гиперссылка

Используйте это для связывания рабочего элемента с URL-адресом. Гиперссылка рабочего элемента — это имя этого типа ссылки в API типов ссылок артефактов.

Тип внешней ссылки

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

Замечание

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

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

Имя ссылки

Поддерживаемый инструмент

Тип артефакта

Использование

---

Оповещение системы безопасности

Передовая безопасность

Передовая безопасность

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

Отрасль

Git

Отрасль

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

Конвейеры и сборка

Строить

Строить

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

Набор изменений (или исправлен в наборе изменений)

Система управления версиями

Набор изменений

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

Коммит (или исправлено в коммите)

Git

Зафиксировать

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

Найдено в сборке

Конвейеры и сборка

Строить

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

Интегрирован в сборку

Строить

Создание конвейера

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

Интегрировано в среду выпуска

Релиз

Конвейер релизов

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

Запрос на вытягивание

Git

ИдентификаторЗапросаНаСлияние

Используйте для связывания рабочего элемента с pull request.

Вложение результатов

Управление тестированием

TcmResultAttachment

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

Файл исходного кода

Система управления версиями

ПоследняяВерсияЭлемента

Используется для связывания рабочего элемента с файлом в элементе управления версиями Team Foundation (TFVC).

Раскадровка

Требования

Раскадровка

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

Тег

Git

Тег

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

Результат теста

Управление тестированием

TcmResult

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

Элемент с версиями

Система управления версиями

ПоследняяВерсияЭлемента

Используется для связывания рабочего элемента с файлом или набором изменений, определенным в репозитории TFVC. Файл исходного кода — это имя этого типа ссылки в API типов ссылок артефактов.

Вики

Вики

Вики

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

Тип ссылки GitHub

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

Это важно

Вы можете ссылаться только на артефакты GitHub для репозиториев, подключенных к Azure Boards.

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

Имя ссылки

Тип артефакта

Использование

---

Коммит GitHub

Коммит репозитория GitHub

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

Проблема с GitHub

Проблема с репозиторием GitHub

Используется для связи рабочего элемента с задачей в GitHub.

Запрос на пулл-реквест GitHub

Запрос на pull request в репозитории GitHub

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

Тип канала удаленной работы

Типы ссылок удаленной работы поддерживают связывание рабочих элементов, определенных в разных организациях, если один и тот же идентификатор Microsoft Entra управляет этими организациями (см. раздел "Подключение организации к идентификатору Microsoft Entra").

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

Имя

Имя ссылки

Использование

---

Использует From-Produced for
(топология зависимостей)

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Тип топологии: зависимость
Категория ссылок: определяемая системой

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

Удаленные связи

System.LinkTypes.Remote.Related
Тип топологии: сеть
Категория ссылок: определяемая системой

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

Перечислить типы ссылок

Вы можете перечислить типы ссылок с помощью поддерживаемых средств командной строки.

az boards work-item relation list-type (просмотр типа списка связей рабочего элемента)

Перечислите типы ссылок, поддерживаемых вашей организацией, с помощью команды az boards work-item relation list-type или REST API Work Item Relation Types - List. Дополнительные сведения см. в статье "Начало работы с Azure DevOps CLI".

az boards work-item relation list-type [--org]

Необязательные параметры

• org: URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не конфигурировано как значение по умолчанию или выбрано с помощью git config. Пример: --org https://dev.azure.com/MyOrganizationName/.

Пример

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

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

Формат JSON по умолчанию предоставляет дополнительные сведения об атрибутах, определенных для типов ссылок. Например, сведения о типах ссылок “Производит для” и “Потребляет из” перечислены следующим образом.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

witadmin listlinktypes

Вы можете перечислить типы ссылок, поддерживаемые для коллекции проектов, с помощью witadmin listlinktypes инструмента командной строки или команды REST API Work Item Relation Types - List.

Ниже приведен список типов ссылок для коллекции fabrikam-sever по умолчанию:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

Атрибуты типа ссылки

В следующей таблице приведены описания для каждого атрибута типа ссылки, возвращаемого интерфейсом командной строки Azure Boards или REST API.

Атрибут

Описание

---

Имена name

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

Имя ссылки, referenceName

Указывает имя, назначенное паре типов ссылок или типа ссылок.

acyclic

Определяет, разрешает (true) или ограничивает (false) ли тип связи циклические отношения. Например, ссылки типа дерева ограничивают циклические связи. Дополнительные сведения см. в справочнике по элементам LinkTypes.

directional

Указывает, является ли тип ссылки направленным (true) или нет (false). Типы направленных связей определяются в парах с прямым и обратным компонентами. Дополнительные сведения см. в справочнике по элементам LinkTypes.

editable

Указывает, является ли тип ссылки редактируемым (true) или нет (false). Вы можете добавлять и изменять пользовательские типы ссылок для локальных развертываний с помощью средства командной строки "Управление типом ссылки".witadmin Типы системных ссылок всегда имеют editable=false.

Активен, enabled

Указывает, является ли тип ссылки активным (true) или нет (false). Пользовательские типы ссылок можно использовать только для локальных развертываний с помощью средства командной строки "Управление типомwitadmin ссылки".

isForward

Указывает, указывает ли тип ссылки переадресацию (true) или нет (False) в паре типов ссылок.

oppositeEndReferenceName

Указывает эталонное имя типа связи, который определяет связь в противоположном направлении пары типов связей.

remote

Указывает, поддерживает ли тип ссылки связь с удаленным рабочим элементом (true) или нет (False). Типы ссылок с remote=false требуют, чтобы целевой рабочий элемент находился в той же организации или коллекции, что и исходный рабочий элемент.

singleTarget

Указывает, разрешен ли тип ссылки для нескольких целевых (false) или ограничен одним целевым объектом (true).

topology

Указывает тип топологии: dependency, networkи tree. Описание см. в разделе "Топологии типов ссылок" и "Ограничения".

usage

Указывает тип использования: resourceLink or значение workItemLink. The workItemLink указывает тип ссылки, который связывает два рабочих элемента. Значение resourceLink указывает тип ссылки, используемый для связывания рабочего элемента с ресурсом, например URL-адресом или вложением.

url

Перечисляет атрибуты типа ссылки в формате JSON.

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

• Связывание рабочих элементов с другими объектами
• Отслеживание зависимостей с помощью планов доставки
• Использование сопоставления для связывания элементов невыполненной работы с функциями и эпическими возможностями
• Массовое изменение ссылок с помощью Excel
• API типов ссылок Artifact