Добавление полей интеграции в типы рабочих элементов

Статья
08/11/2011

В типах рабочих элементов можно настроить содержание информации, формируемой автоматическими процессами, путем добавления полей, интегрируемых с Team Foundation Build, Microsoft Test Manager и Team Foundation (подсистема контроля версий).

В этом разделе

Поля, интегрируемые с Team Build
Поля, интегрируемые со средствами тестирования Visual Studio
Поля, интегрируемые с подсистемой контроля версий Team Foundation

Поля, интегрируемые с Team Foundation Build

Система Team Foundation Build является системой автоматических построений для сервера Team Foundation Server. Настроить процесс построения можно с помощью Team Foundation Build. Team Foundation Build может формировать рабочие элементы при сбое построения, а также добавлять сведения о построении к рабочим элементам, разрешенным в определенном построении. Чтобы эти функции работали, системе Team Foundation Build требуется два поля: Found In и Integration Build.

Добавление поля "Found in" ("Найдено в...")

Средство Team Foundation Build создает новый рабочий элемент при сбое построения и присваивает полю Found In значение номера неудачно завершившегося построения. Поле Found In должно присутствовать в типе рабочего элемента, который требуется создать средству Team Foundation Build при сбое построения. При отсутствии поля Found In средство Team Foundation Build не создает рабочий элемент для неудачно завершившегося построения, и в остальном система работает, как ожидалось.

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

Имя атрибута	Значение атрибута
RefName	Microsoft.VSTS.Build.FoundIn
Имя	Можно установить в любое значение, поскольку интеграции работают по ссылочным именам полей, а не по именам полей.
Тип	String

Пример поля "Found In" ("Найдено в...")

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>

Добавление поля "Integration Build" ("Построение интеграции")

Система Team Foundation Build определяет рабочие элементы, которые были разрешены в каждом построении, и затем обновляет эти рабочие элементы, устанавливая номер построения, в котором они были разрешены. Номер построения устанавливается в поле Integration Build. Если поле Integration Build отсутствует, Team Foundation Build не сохраняет номера построений в рабочих элементах, и система в остальном работает, как ожидалось.

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

Имя атрибута	Значение атрибута
RefName	Microsoft.VSTS.Build.IntegrationBuild
Имя	Можно установить в любое значение, поскольку интеграции работают по ссылочным именам полей, а не по именам полей.
Тип	String

Пример поля "Integration Build Field" ("Построение интеграции")

<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Поля, интегрируемые со средствами тестирования Visual Studio

Некоторые выпуски Visual Studio включают средства тестирования, встроенные в среду разработки. Одной из возможностей, которые предоставляют эти средства, является создание новых рабочих элементов при сбое тестирования. Для этого, в окне "Результаты теста", щелкните правой кнопкой мыши результат теста, для которого следует создать элемент ошибки, наведите курсор на подраздел меню Создать рабочий элемент, а затем выберите тип рабочего элемента, который хотите создать, например Ошибка. Дополнительные сведения см. в разделе Практические примеры: Create a Work Item from a Test Result.

После создания этим способом рабочего элемента три поля могут быть заполнены автоматически сведениями о сбое тестирования. Имена этих трех полей — TestName ("Имя теста"), TestId ("Идентификатор теста") и TestPath ("Путь теста"). Менеджер тестирования заполняет эти поля сведениями о непройденном тесте. Если поля TestName, TestId и TestPath отсутствуют в рабочем элементе, то значения полей не устанавливаются и система в остальном работает, как ожидалось.

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

Имя атрибута	Значение атрибута
RefName	Microsoft.VSTS.Test.TestName, Microsoft.VSTS.Test.TestId, Microsoft.VSTS.Test.TestPath
Name	Можно установить в любое значение, поскольку интеграции работают по ссылочным именам полей, а не по именам полей.
Тип	String

Примеры полей "TestName" ("Имя теста"), "TestId" ("Идентификатор теста") и TestPath ("Путь теста")

<FIELD name="Test Name" refname="Microsoft.VSTS.Test.TestName" type="String" reportable="detail">
    <HELPTEXT>The name of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Id" refname="Microsoft.VSTS.Test.TestId" type="String" reportable="detail">
    <HELPTEXT>The Id of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Path" refname="Microsoft.VSTS.Test.TestPath" type="String" reportable="detail">
    <HELPTEXT>The full pathname of the test that found this bug</HELPTEXT>

Поля, интегрируемые с подсистемой контроля версий Team Foundation

Одной из возможностей системы Team Foundation (подсистема контроля версий) является связывание или разрешение рабочих элементов при возврате кода. Во время работы над рабочим элементом при внесении изменений в код можно установить эту связь из окна возврата кода системы управления версиями после окончания работы над кодом.

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

Примечание

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

Дополнительные сведения о действиях см. в разделе Associating a State Transition with an Action и Transition Action Details.

Пример действия "Checkin" ("Вернуть")

<TRANSITION from="Active" to="Resolved">
....
    <ACTIONS>
        <ACTION value="Microsoft.VSTS.Actions.Checkin"/>
    </ACTIONS>
....  
</TRANSITION>

См. также

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