tcm: テスト計画、テスト スイート、テスト構成、および環境の一覧
tcm.exe を使用してコマンド ラインからテストを実行したり、テスト ケースを特定のテスト スイートにインポートしたりするには、テストを実行するのに必要な成果物の名前と ID が必要です。 次の tcm コマンドを使用して、コマンド ラインからテストの成果物のリストを取得できます。
tcm plans /list
tcm suites /list
tcm configs /list
tcm testenvironments /list
tcm.exe は、Visual Studio Ultimate、Visual Studio Premium、または Visual Studio Test Professional がインストールされているコンピューターの <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE にあります。
tcm plans /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm suites /list [/planid: id | /querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm configs /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm testenvironments /list /collection:CollectionURL /teamproject:project [/login:username,[password]]
パラメーター
パラメーター |
説明 |
---|---|
/querytext:query |
テストの成果物を返すために使用するクエリを指定します。 |
/planid:id |
このテスト計画のテスト スイートのみが一覧表示されるように指定します。 |
/collection:CollectionURL |
チーム プロジェクト コレクションの URI を指定します。 URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。 仮想ディレクトリを使用していない場合、URI の形式は次のようになります。 http://ServerName:Port/CollectionName |
/teamproject:project |
自動テストのインポート先となるテスト計画を含むチーム プロジェクトの名前です。 |
/login:username,[password] |
省略可能です。 Team Foundation Server のアプリケーション層サーバーにログオンしており、コマンド実行のためのアクセス許可を持つユーザーの名前とパスワードを指定します。 Windows の資格情報に適切なアクセス許可がない場合、基本認証を使用する場合、またはドメインに接続されていない場合はこのオプションを使用します。 Visual Studio Online にログインするには、次の /allowalternatecredentials も使用する必要があります。 |
/allowalternatecredentials |
Visual Studio Online へ接続する際には、/login パラメーターに加えてこのフラグも指定する必要があります。 (Visual Studio 2013 更新プログラム 4 以降をお使いの場合のみ、このフラグを使用できます。) |
/collection および /teamproject のパラメーターは、tcm.exe と同じディレクトリ (<Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE) にある tcm.exe.config XML ファイルに追加できます。 このファイルに追加しておくと、tcm コマンドを実行するたびに、コマンド ラインでこれらのパラメーターを入力する必要がなくなります。 これらのキーとその値をファイルに追加するには、appSettings セクションで次のように指定します。
<appSettings>
<add key="TeamFoundationServer" value=""http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
テスト項目の一覧表示
以下の各例は、Visual Studio コマンド プロンプトを起動していることを前提としています。
これを行うには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft Visual Studio 2012]、[Visual Studio Tools] の順にポイントして、[開発者コマンド プロンプト] を選択します。
コマンド プロンプトで <drive>:\Program Files\Microsoft Visual Studio 11.0\VC フォルダーが開きます。
次のコマンドでは、DinnerNow チーム プロジェクトのテスト構成が一覧表示されます。
tcm configs /list /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
次のコマンドでは、DinnerNow チーム プロジェクトのテスト計画 Sprint 1 のみが一覧表示され、その ID を確認できます。
tcm plans /list /querytext:"SELECT * FROM TestPlan WHERE PlanName=’Sprint 1’" /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
次のコマンドでは、DinnerNow チーム プロジェクトの、ID が 3 のテスト計画にあるテスト スイートが一覧表示されます。
tcm suites /list /planid:3 /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
参照
関連項目
tcm: コマンド ライン ユーティリティを使用したテスト計画からのテストの実行