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. Импорт и запуск автоматических тестов для плана тестирования из командной строки