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


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

Из командной строки можно выполнять автоматические тесты, входящие в план тестирования.Это позволяет запустить тест с помощью пакетного файла, так что вы можете запланировать запуск.Тестовыми запусками также можно управлять из командной строки.Если вы хотите экспортировать тестового запуска, так что разработчик может просматривать результаты теста с помощью Visual Studio, можно использовать для этого tcm.Можно также опубликовать результаты тестового запуска из файла тестового запуска Visual Studio (.trx) с помощью tcmМожно указать, какие результаты из этого файла тестового запуска, который требуется опубликовать, нужно отправить обратно в план тестирования.Для выполнения этих задач можно использовать следующие команды tcm:

  • tcm run /create

  • tcm run /list

  • tcm run /execute

  • tcm run /abort

  • tcm run /delete

  • tcm run /export

  • tcm run /publish

TCM.exe находится в <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE Visual Studio тест Professional установлена или на любом компьютере, который имеет Visual Studio Ultimate, Visual Studio Premium,.

Для получения дополнительных сведений о том, как импортировать автоматизированные тестов в тестовый проект и создать план для запуска этих тестов, см. Create Test Cases from an Assembly of Automated Tests и Практическое руководство. Запуск автоматических тестов из командной строки с помощью программы Tcm.

tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory]  [/testenvironment:name] [/login:username,[password]] [/include]

tcm run /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]

tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]

tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project    [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform]  [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]

Параметры

Параметр

Описание

/collection:CollectionURL

Задает универсальный код ресурса (URI) коллекции командных проектов.URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции

Если виртуальный каталог не используется, URI имеет следующий формат:

http://имя_сервера:порт/имя_коллекции

/teamproject:project

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

/title: title

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

/planid:id

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

/suiteid:id

Определяет наборы тестов, которые вы хотите запустить.

Можно также задать конфигурацию тестовой сборки для использования при публикации тестового запуска.

ПримечаниеПримечание
Чтобы найти идентификатор набора, можно перечислить наборы тестов для плана тестирования.Дополнительные сведения см. в разделе tcm. Создание списков планов тестирования, наборов тестов, конфигураций тестов и сред.
СоветСовет
Чтобы выполнить более одного набора тестов, можно использовать параметр /querytext.

/configid:configid

Указывает, какую конфигурацию теста необходимо запустить наборы тестов.

Можно также задать конфигурацию теста для использования при публикации тестового запуска.

СоветСовет
Запуск более одной конфигурации теста, можно использовать параметр /querytext.

/querytext:query

Определяет запрос, используемый для возврата тестовых запусков, или запрос, используемый для выбора тестов, которые вы хотите запустить.

СоветСовет
Параметр /querytest используется для запуска более чем одного набора тестов.Примеры.querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”

/settingsname:name

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

/owner:owner

Необязательный.Указывает владельца тестового запуска.

/runowner:owner

Необязательный.Указывает владельца тестового запуска.

/builddir:directory

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

/testenvironment:name

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

/id:id

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

/resultsfile:path

Указывает местоположение для экспорта тестового запуска или для поиска тестового запуска для публикации.Например "c:\temp\ResultsForDeveloper.trx".

/attachment:attachmentname

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

/resultowner:owner

Указывает владельца результатов теста.

/build:buildnumber

Необязательный.Указывает номер построения, который следует использовать для публикации тестового запуска.Параметр должен использоваться вместе с /builddefinition.

/builddefinition:builddefinition

Необязательный.Указывает определение построения, которое следует использовать для публикации тестового запуска.Параметр должен использоваться вместе с /build.

/flavor:flavor

Необязательный.Указывает конфигурацию построения.Например, Release.Этот параметр можно использовать только в том случае, если используется параметр /build.

/platform:platform

Необязательный.Указывает платформу построения.Например, x86.Этот параметр можно использовать только в том случае, если используется параметр /build.

/assignfailurestouser:user

Необязательный.Определяет, кому назначить любые неудачно завершившиеся тесты в тестовом запуске.

/buildverification

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

/include

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

/noprompt

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

/login:username,[password]

Необязательный.Задает имя и пароль пользователя, который выполнил вход на сервер уровня приложений Team Foundation Server и имеет разрешения на выполнение команды.Этот параметр используется в следующих случаях: учетным данным Windows не предоставлены соответствующие разрешения, используется базовая проверка подлинности, пользователь не подключен к домену.

Можно добавить параметры для /collection и /teamproject в XML-файл tcm.exe.config, расположенный в той же папке, что и файл tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.Если вы добавляете их в файл, вам не нужно вводить их в командной строке каждый раз при выполнении командыtcm .Можно добавить эти ключи и их значения в файл следующим образом в разделеappSettings :

    <appSettings>
         <add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

Запуск тестов и управление тестовыми запусками

В следующих примерах предполагается, что вы запустили командную строку Visual Studio.

Для этого выберите Начать, пункт Все программы, пункт Visual Studio 2012 Microsoft, пункт Средства Visual Studio, а затем выберите разработчиков командной строки.

В командной строке откроется папка:<drive>:\Program Files\Microsoft Visual Studio 11.0\VC

Перейдите в папку, в которой содержится сборка, построенная для тестового проекта.

Важное примечаниеВажно

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

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

Следующая команда выполняет тесты с помощью запроса тестовой точка:

tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

Следующая команда выполняет тесты с помощью конкретного набора тестов и конфигурации:

tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

Следующая команда выполняет тесты, используя определенный идентификатор:

Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>

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

tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>

Следующая команда удаляет заданный тестовый запуск:

tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>

Следующая команда экспортирует тестовый запуск в TRX-файл:

tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

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

tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

См. также

Ссылки

tcm. Создание списков планов тестирования, наборов тестов, конфигураций тестов и сред

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

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