tcm. Запуск тестов из плана тестирования с помощью служебной программы командной строки
Из командной строки можно выполнять автоматические тесты, входящие в план тестирования. Это позволяет запустить тест с помощью пакетного файла, так что вы можете запланировать запуск. Тестовыми запусками также можно управлять из командной строки. Если вы хотите экспортировать тестового запуска, так что разработчик может просматривать результаты теста с помощью Visual Studio, можно использовать для этого tcm. Можно также опубликовать результаты тестового запуска из файла тестового запуска Visual Studio (.trx) с помощью tcm Можно указать, какие результаты из этого файла тестового запуска, который требуется опубликовать, нужно отправить обратно в план тестирования. Для выполнения этих задач можно использовать следующие команды tcm:
tcm run /create
tcm run /list
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
tcm.exe находится в папке <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE на всех компьютерах, где установлен Visual Studio Ultimate.
Для получения дополнительных сведений о том, как импортировать автоматизированные тестов в тестовый проект и создать план для запуска этих тестов, см. Создание тестовых случаев из сборки автоматических тестов и Практическое руководство. Запуск тестовых случаев со средствами автоматизации из командной строки с помощью программы 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 /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 /suiteid:2 /suiteid:3. Можно также задать конфигурацию тестовой сборки для использования при публикации тестового запуска. .gif "Примечание") Примечание
Чтобы найти идентификатор набора, можно перечислить наборы тестов для плана тестирования.Дополнительные сведения см. в разделе tcm. Создание списков планов тестирования, наборов тестов, конфигураций тестов и сред.
|
/configid:configid |
Указывает, какие конфигурации теста необходимо запустить для ваших наборов тестов. Например если вы хотите запустить более одной конфигурации тестов, можно использовать следующий синтаксис в рамках команды tcm /configid:2 /configid:3. Можно также задать конфигурацию теста для использования при публикации тестового запуска. |
/querytext:query |
Определяет запрос, используемый для возврата тестовых запусков, или запрос, используемый для выбора тестов, которые вы хотите запустить. |
/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 10.0\Common7\IDE. Если вы добавляете их в файл, вам не нужно вводить их в командной строке каждый раз при выполнении командыtcm . Можно добавить эти ключи и их значения в файл следующим образом в разделеappSettings :
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Запуск тестов и управление тестовыми запусками
В следующих примерах предполагается, что вы запустили командную строку Visual Studio.
Для этого нажмите кнопку Пуск, последовательно выберите Все программы, Microsoft Visual Studio 2010, Средства Visual Studio, после чего выберите пункт Командная строка Visual Studio (2010).
В командной строке откроется папка:<drive>:\Program Files\Microsoft Visual Studio 10.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 /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. Импорт и запуск автоматических тестов для плана тестирования из командной строки