Указание типа ошибки в файле с помощью Microsoft Test Manager

Можно включить автоматическое создание рабочего элемента, когда тест-инженер обнаруживает ошибку кода при использовании Microsoft Test Manager.Средство командной строки tcm bugfieldmapping поддерживает импорта и экспорта файла сопоставления для командного проекта.Файл сопоставления определяет тип создаваемого рабочего элемента и три поля для заполнения Microsoft Test Manager.Эти поля представляют собой шаги воспроизведения, системную информацию и построение, в котором был обнаружен дефект.Если тест-инженер находит дефект в ходе тестирования, может появиться ошибка, при которой три поля заполняются автоматически.

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

Для доступа к инструменту командной строки tcm откройте окно командной строки там, где установлено либо Visual Studio, либо Team Explorer и введите:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

В 64-разрядной версии Windows замените %programfiles% на %programfiles(x86)%.

Дополнительные сведения о дополнительных параметрах командной строки tcm см. в разделе tcm. Импорт и запуск автоматических тестов для плана тестирования из командной строки.

Дополнительные сведения о типе ошибки рабочего элемента см. в разделах Ошибка (Scrum), Ошибка (гибкая разработка) и Ошибка (CMMI).

Необходимые разрешения

Для командного проекта, где определены типы рабочих элементов, необходимо быть членом группы безопасности Администраторы Team Foundation или группы безопасности Администраторы проекта.Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Примечание

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.

tcm bugfieldmapping /export /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

tcm bugfieldmapping /import /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

Параметры

Параметр	Описание
/export	Задает файл для экспорта ошибок сопоставления полей.Этот файл определяет создаваемый тип рабочего элемента при обнаружении ошибки кода с помощью Microsoft Test Manager.Он также указывает поля рабочего элемента, который будет заполняться данными, которые определены в Microsoft Test Manager, например, шаги воспроизведения, сведения о системе и построения, в которой был обнаружен код ошибки.Дополнительные сведения содержатся в разделе Содержимое файла сопоставления полей ошибки далее на этом странице.
/import	Задает файл для импорта ошибок сопоставления полей.
/mappingfile:Path	Задает путь и имя файла XML-определения, содержащего сопоставления полей ошибок. Примечание При использовании Windows Vista не обязательно иметь разрешения на определенные папки.При попытке экспорта типа рабочего элемента в расположение, к которому отсутствуют права доступа, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.Дополнительные сведения о виртуализации реестра см. на следующих страницах на веб-сайте корпорации Майкрософт: Виртуализация реестра и Типовые проблемы виртуализации файлов и реестра в Windows Vista.
/collection:CollectionURL	Задает универсальный код ресурса (URI) коллекции командного проекта.URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если виртуальный каталог не используется, URI имеет следующий формат: http://имя_сервера:порт/имя_коллекции
/teamproject:Проект	Указывает имя командного проекта, для которого будут применены сопоставления полей ошибки.Данный командный проект должен быть определен в коллекции командных проектов, заданной параметром /collection.
/login:UserName,Password	Необязательный параметр.Задает имя и пароль пользователя, который выполнил вход на сервер уровня приложений Team Foundation и имеет разрешения на выполнение команды. Этот параметр следует использовать в тех случаях, когда учетные данные Windows не имеют соответствующие разрешения, когда используется базовая проверка подлинности или когда пользователь находится вне домена.
/? или help	Отображает справку по команде в окне командной строки.

Заметки

Файл сопоставления полей ошибки предоставляет Microsoft Test Manager с именем типа рабочего элемента для создания рабочих элементов и поля для их заполнения.

Можно определить только один тип рабочего элемента, создаваемого при выполнении тестов, использующих Microsoft Test Manager.Каждый раз при запуске команды tcmbugfieldmapping import тип рабочего элемента, указанный элементом BugFilerMappings заменяет любой ранее заданный тип рабочего элемента.Например следующий код показывает создание рабочих элементов, которые основаны на типе с именем AWBug.

<BugFilerMappings workitemtypetocreate="AWBug">

Дополнительные сведения см. в разделе Практическое руководство. Отправка ошибок с помощью Microsoft Test Manager.

Содержимое файла сопоставления полей ошибки

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

<?xml version="1.0" encoding="utf-16"?>
<BugFilerMappings workitemtypetocreate="Bug">
   <ReproSteps>Microsoft.VSTS.TCM.ReproSteps</ReproSteps>
   <SystemInformation>Microsoft.VSTS.TCM.SystemInfo</SystemInformation>
   <BuildFoundIn>Microsoft.VSTS.Build.FoundIn</BuildFoundIn>
</BugFilerMappings>

Дополнительные сведения о полях, используемых для отслеживания информации, найденной Microsoft Test Manager, см. в разделе Ссылка на поле "Построение и тестирование интеграции".

Примеры

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

• URI-адрес коллекции командного проекта: http://AdventureWorksServer:8080/tfs/Collection1

• Имя проекта: AdventureWorks

• Имя файла сопоставлений полей ошибок:bugfieldmappings.xml

• Расположение папки: «C:\Users\AdminUser\Documents\»

Импорт файла сопоставления полей ошибки

Следующая команда импортирует содержимое файла bugfieldmappings.xml в командный проект AdventureWorks, который определен в Collection1 на сервере с именем AdventureWorksServer.

tcm bugfieldmapping /import /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/tfs/Collection1 /teamproject:AdventureWorks 

См. также

Задачи

Практическое руководство. Отправка ошибок с помощью Microsoft Test Manager

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

Настройка шаблонов процессов

Практическое руководство. Запуск автоматических тестов из командной строки с помощью программы Tcm

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

Использование средств командной строки Team Foundation Server