tcm: 명령줄 유틸리티를 사용하여 테스트 계획에서 테스트 실행
명령줄에서 테스트 계획의 일부인 자동 테스트를 실행할 수 있습니다. 이를 통해 배치 파일로 테스트 실행을 시작하여 실행을 예약할 수 있습니다. 명령줄에서 테스트 실행을 관리할 수도 있습니다. 개발자가 Visual Studio을 사용하여 테스트 결과를 볼 수 있도록 테스트 실행을 내보내려는 경우 tcm을 사용하여 내보낼 수 있습니다. tcm을 사용하여 Visual Studio 테스트 실행 파일(.trx)에서 테스트 실행 결과를 게시할 수도 있습니다. 이 테스트 실행 파일에서 테스트 계획에 다시 게시하려는 결과를 지정할 수 있습니다. 다음 tcm 명령을 사용하여 이러한 작업을 완료할 수 있습니다.
tcm run /create
tcm run /list
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
tcm.exe는 Visual Studio Ultimate이 설치된 컴퓨터의 <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE에 있습니다.
자동화된 테스트를 테스트 프로젝트로 가져오는 방법과 테스트 계획을 설정하여 이 테스트를 실행하는 방법은 자동화된 테스트의 어셈블리에서 테스트 사례 만들기 또는 방법: 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]
매개 변수
Parameter |
설명 |
---|---|
/collection:CollectionURL |
팀 프로젝트 컬렉션의 URI를 지정합니다. URI에 대한 형식: http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다. http://ServerName:Port/CollectionName |
/teamproject:project |
자동화된 테스트를 가져올 테스트 계획이 들어 있는 팀 프로젝트의 이름입니다. |
/title: title |
만들거나 테스트 실행 파일을 게시하는 실행에 대해 사용할 제목을 지정합니다. |
/planid:id |
실행하려는 테스트가 포함된 계획 또는 나열하려는 테스트 실행과 연결된 계획을 지정합니다. |
/suiteid:id |
실행할 테스트 도구 모음을 선택합니다. 예를 들어 두 개 이상의 테스트 도구 모음을 실행하려면 tcm 명령 /suiteid:2 /suiteid:3의 일부로 다음 구문을 사용할 수 있습니다. 또한 테스트 실행을 게시할 때 사용할 테스트 도구 모음을 지정할 수 있습니다.
참고
테스트 실행의 테스트 도구 모음을 나열하면 도구 모음 id를 찾을 수 있습니다.자세한 내용은 tcm: 테스트 계획, 테스트 도구 모음, 테스트 구성 및 환경 나열을 참조하십시오.
|
/configid:configid |
테스트 도구 모음에 실행할 테스트 구성을 지정합니다. 예를 들어 두 개 이상의 테스트 구성을 실행하려는 경우 tcm 명령 /configid:2 /configid:3의 일부로 다음 구문을 사용할 수 있습니다. 또한 테스트 실행을 게시할 때 사용할 테스트 구성을 지정할 수 있습니다. |
/querytext:query |
테스트 실행을 반환하는 데 사용할 쿼리 또는 실행하려는 테스트를 선택하는 데 사용할 쿼리를 지정합니다. |
/settingsname:name |
선택적 요소로서, 이 테스트 실행에 사용할 테스트 설정을 지정합니다. 이 매개 변수로 테스트 설정을 선택하지 않을 경우 테스트 계획의 자동화된 테스트에 기본 테스트 설정이 사용됩니다. |
/owner:owner |
선택적 요소로서, 테스트 실행의 소유자를 지정합니다. |
/runowner:owner |
선택적 요소로서, 테스트 실행의 소유자를 지정합니다. |
/builddir:directory |
선택적 요소로서, 자동화된 테스트의 테스트 어셈블리를 찾는 데 사용할 빌드 디렉터리를 지정합니다. 이 속성을 설정하지 않으면 현재 테스트 계획에 할당된 빌드를 기준으로 빌드 위치가 사용됩니다. |
/testenvironment:name |
선택적 요소로서, 이 테스트 실행에 사용할 테스트 환경을 지정합니다. 이 매개 변수로 테스트 환경을 선택하지 않을 경우 테스트 계획에서 자동화된 테스트에 대해 기본 테스트 환경이 사용됩니다. |
/id:id |
삭제하거나 중단하거나 내보낼 실행 ID를 지정합니다. |
/resultsfile:path |
테스트 실행을 내보낼 위치 또는 게시할 테스트 실행을 찾을 위치를 지정합니다. 예를 들면 "c:\temp\ResultsForDeveloper.trx"와 같습니다. |
/attachment:attachmentname |
내보내는 테스트 실행에 대한 첨부 파일의 이름을 지정합니다. |
/resultowner:owner |
테스트 결과의 소유자를 지정합니다. |
/build:buildnumber |
선택적 요소로서, 테스트 실행을 게시하는 데 사용할 빌드 번호를 지정합니다. 이 매개 변수는 /builddefinition과 함께 사용해야 합니다. |
/builddefinition:builddefinition |
선택적 요소로서, 테스트 실행을 게시하는 데 사용할 빌드 정의를 지정합니다. 이 매개 변수는 /build와 함께 사용해야 합니다. |
/flavor:flavor |
선택적 요소로서, 빌드 버전을 지정합니다. 예: 릴리스. 이 매개 변수는 /build 매개 변수가 사용된 경우에만 사용됩니다. |
/platform:platform |
선택적 요소로서, 빌드 플랫폼을 지정합니다. 예: x86. 이 매개 변수는 /build 매개 변수가 사용된 경우에만 사용됩니다. |
/assignfailurestouser:user |
선택적 요소로서, 테스트 실행에서 실패한 테스트를 할당할 사용자를 지정합니다. |
/buildverification |
선택적 요소로서, 이 테스트 실행에 빌드의 기본 기능을 검사하는 빌드 확인 테스트를 포함하도록 지정합니다. |
/include |
선택적 요소로서, 현재 활성 상태로 설정되어 있지 않은 테스트인 경우에도 테스트 실행에 모든 테스트를 선택하도록 지정합니다. |
/noprompt |
선택적 요소로서, 사용자에게 테스트 실행을 확인하는 메시지를 표시하지 않도록 지정합니다. |
/login:username,[password] |
선택적 요소로서, Team Foundation Server에 대한 응용 프로그램 계층 서버에 로그온한 사용자 및 명령 실행 권한을 가지고 있는 사용자의 이름과 암호를 지정합니다. 사용자의 Windows 자격 증명에 적절한 권한이 없는 경우, 기본 인증을 사용하는 경우 또는 도메인에 연결되지 않은 경우 이 옵션을 사용할 수 있습니다. |
tcm.exe와 같은 디렉터리(<Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE)에 있는 tcm.exe.config XML 파일에 /collection 및 /teamproject에 대한 매개 변수를 추가할 수 있습니다. 이를 파일에 추가하면 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 Tools를 차례로 가리킨 다음 **Visual Studio 명령 프롬프트(2010)**를 클릭합니다.
명령 프롬프트에서 <drive>:\Program Files\Microsoft Visual Studio 10.0\VC 폴더를 엽니다.
테스트 프로젝트에서 빌드된 어셈블리를 포함하는 폴더로 디렉터리를 변경합니다.
중요
tcm.exe를 사용하여 명령줄에서 자동화된 테스트를 실행하려면 테스트 사례를 자동화된 테스트에 연결해야 합니다. 명령줄에 빌드 정보를 지정하지 않는 경우 빌드를 사용하여 실행할 자동화된 테스트를 찾을 수 있도록 테스트 계획도 올바르게 설정해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 방법: tcm.exe를 사용하여 자동화된 테스트의 어셈블리에서 테스트 사례 만들기을 참조하십시오.
다음 명령에 필요한 ID를 얻으려면 tcm을 사용하여 테스트 아티팩트 및 ID를 나열해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 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>
다음 명령은 특정 테스트 도구 모음과 구성에 대한 테스트 실행을 게시하고 소유자를 재할당합니다. 이는 이 구성과 쌍을 이루는 테스트 도구 모음에 있는 테스트 사례의 기존 테스트 지점을 .trx 파일의 결과에 업데이트합니다.
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>