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

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 <version>\Common7\IDE на любом компьютере с установленными продуктами Visual Studio Enterprise или Visual Studio Test Professional.

Дополнительные сведения о том, как импортировать автоматические тесты в тестовый проект и настроить план тестирования для выполнения этих тестов, см. в разделах Создание тестового случая из сборки автоматических тестов и Запуск автоматических тестов из командной строки с помощью 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 не предоставлены соответствующие разрешения, используется базовая проверка подлинности, пользователь не подключен к домену.

Чтобы войти в Visual Studio Online, необходимо также использовать /allowalternatecredentials, перечисленые ниже.

/allowalternatecredentials

Этот флаг требуется указать в дополнение к параметру /login при подключении к Visual Studio Online. (Этот флаг доступен только при наличии Visual Studio 2013 с обновлением 4 или более поздней версии.)

Можно добавить параметры для /collection и /teamproject в XML-файл tcm.exe.config, расположенный в той же папке, что и файл tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio <version>\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, «Инструменты Visual Studio», «Командная строка разработчика».)

В командной строке откроется папка: <drive>:\Program Files\Microsoft Visual Studio <version>\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>

Следующая команда публикует тестовый запуск для конкретного набора тестов и тестирования конфигурации и переназначает владельца. Это обновляет существующие тестовые точки для тестовых случаев в тестовом пакете в паре с такой конфигурации, записывая результаты в файл 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 для импорта и запуска автоматических тестов для плана тестирования из командной строки