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

Справочник по элементам типов связей

  • Статья

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

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

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

Структура синтаксиса

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

<LinkTypes>
   <LinkType ReferenceName="LinkTypeName" ForwardName="ForwardName" ReverseName="ReverseName" Topology="TopologyType" />
</LinkTypes>

Описания в данной таблице относятся к предыдущему синтаксису:

Атрибут

Описание

ReferenceName

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

ForwardName

Имя ссылки на исходный рабочий элемент. Данное имя появляется при добавлении ссылки на исходный рабочий элемент.

ReverseName

Имя ссылки на целевой рабочий элемент. Данное имя появляется при выводе списка ссылок на исходный рабочий элемент.

TopologyType

Определяет топологию DirectedNetwork, Network, Tree или Dependency. Первые три топологии являются направленными, их можно использовать для задания отношений подчиненности или последовательности. Топологию Network можно использовать для задания отношений между одноранговыми элементами, либо при отсутствии отношений подчиненности.

Направленность ссылки определяется назначениями атрибутов ForwardName и ReverseName. Если создать пользовательскую ссылку и назначить одинаковые прямое и обратное имя, то обязательно нужно установить тип связи Network, потому что это единственная ненаправленная топология.

Требования

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

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

  • Имена могут содержать до 254 символов юникода.

  • Имена не могут быть пустыми.

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

  • Имена не должны содержать символы обратной косой черты (\).

  • Имена не должны содержать два последовательных пробела.

Системные типы ссылок

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

Прямое имя

Обратное имя

Ссылочное имя

Топология

Потомок

Предшественник

System.LinkTypes.Dependency

Зависимость

Дочерний

Родительский

System.LinkTypes.Hierarchy

Дерево

Относится

Относится

System.LinkTypes.Related

Сеть

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

Типы ссылок, определенные шаблоном процесса

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

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

Прямое имя

Обратное имя

Ссылочное имя типа ссылки

Топология

Влияет (см. примечание 1)

Затрагивает

Microsoft.VSTS.Common.Affects

Зависимость

Имеются ссылки (см. примечание 2)

Ссылки

Microsoft.VSTS.TestCase.SharedParameterReferencedBy

Зависимость

Проверил

Тесты

Microsoft.VSTS.Common.TestedBy

Зависимость

Тестовый случай

Общие шаги

Microsoft.VSTS.TestCase.SharedStepReferencedBy

Зависимость

Примечания

  1. Тип ссылок "влияет/затрагивает" связывают запросы на изменения и требования. Данный тип ссылок добавляется только в командные проекты, созданные с использованием шаблона CMMI.

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

Файлы определения типов ссылок находятся в папке Tracking\LinkTypes файла Template.zip. Следующее определение для типа ссылки Microsoft.VSTS.Common.TestedBy задано в файле TestedBy.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
   <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

Определение типа ссылки импортируется в коллекцию проекта при создании командного проекта с использованием соответствующего шаблона процесса.

Ограничения и топологии ссылок

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

Тип топологии

Рисунки

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

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

 Топология связей сетей

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

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

 Топология связей направленных сетей

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

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

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

 Топология ссылок зависимостей

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

На рисунке невозможно присвоить одному дочернему элементу два родительских.

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

 Топология связей деревьев

Определение схемы типа ссылки

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

<?xml version="1.0" encoding="utf-8"?>
<xs:schema
  id="WorkItemLinkTypeDefinition"
  elementFormDefault="unqualified"
  attributeFormDefault="unqualified"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  targetNamespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd"
  xmlns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd"
  xmlns:mstns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd"
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"
  version="1.0">
   <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"/>
  <xs:simpleType name="TopologyTypes">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Network" />
      <xs:enumeration value="DirectedNetwork" />
      <xs:enumeration value="Dependency" />
      <xs:enumeration value="Tree" />
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="LinkTypeType">
    <xs:attribute name="ReferenceName" type="typelib:ReferenceName" use="required" />
    <xs:attribute name="Topology" type="TopologyTypes" use="optional" />
    <xs:attribute name="ForwardName" type="typelib:FriendlyName" use="optional" />
    <xs:attribute name="ReverseName" type="typelib:FriendlyName" use="optional" />
  </xs:complexType>
  <xs:complexType name="LinkTypesType">
    <xs:sequence>
       <xs:element name="LinkType" type="LinkTypeType" minOccurs="1" maxOccurs="unbounded" />
      </xs:sequence>
      </xs:complexType>
   <xs:element name="LinkTypes" type="LinkTypesType" />
</xs:schema>

Вопросы и ответы

Вопрос: Как добавить пользовательский тип ссылок?

Ответ: Задайте в XML-файле определения тип в соответствии с настоящим разделом и воспользуйтесь witadmin importlinktype, чтобы импортировать файл определения типа ссылки в коллекцию проекта, где размещен командный проект.

Вопрос: Какой тип ссылок используется для связи тестовых случаев и наборов тестов, а также наборов тестов и планов тестирования?

Ответ: Просмотреть, какие тестовые случаи определены для набора тестов, а также какие наборы тестов определены для плана тестирования можно, используя Team Web Access или Test Manager. Однако, данные объекты не соединены между собой ссылками каких-либо типов.

См. также

Основные понятия

Настройка объектов отслеживания работ для поддержки командных процессов

Другие ресурсы

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