tcm：向测试用例中导入自动测试
可以将自动测试（例如，单元测试或编码的 UI 测试）导入测试项目中以用作测试计划的一部分。 使用以下 tcm 命令从测试程序集导入测试：
- tcm testcase /import
你基于提供的参数选择的每个自动测试都具有为其创建的测试用例。 自动测试会自动与该测试用例关联。 可以使用此命令向静态测试套件添加测试用例，也可以在导入测试用例后将其添加到测试套件。 有关如何将测试用例添加到测试套件中的更多信息，请参见使用 Team Web Access 计划手动测试。 你还可以将这些测试用例链接到要求，以便查看要求的自动测试状态。 有关如何执行此操作的更多信息，请参见将现有测试用例链接到要求。
有关如何从测试计划运行自动测试的更多信息，请参见自动系统测试。
tcm.exe 位于安装了 Visual Studio 旗舰版、Visual Studio 高级专业版或 Visual Studio 专业测试工具版的所有计算机上的 <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE 中。
警告
也可以使用此命令来更新现有的导入测试用例。如果你选择进行更新的测试用例不包括以前导入的测试，则只更新选定的测试用例。如果你指定更新测试用例时同步到的测试套件，则会从测试套件（而不是从测试计划本身）中删除未导入的测试。
tcm testcase /import /collection:CollectionURL /teamproject:project /storage:path [/maxpriority:priority] [/minpriority:priority] [/category:filter] [/syncsuite:id [/include:]] [/login:username,[password]]
参数
参数 |
描述 |
|---|---|
/collection:CollectionURL |
指定团队项目集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果未使用虚拟目录，则 URI 将为以下格式： http://ServerName:Port/CollectionName |
/teamproject:project |
包含要将自动测试导入到的测试计划的团队项目的名称。 |
/storage: path |
指定包含要导入的自动测试的测试程序集的路径和名称。 |
/maxpriority:priority |
可选。 指定要基于测试方法的最高优先级导入的测试。 例如，如果参数是 /maxpriority:1，则只导入测试方法优先级特性小于或等于 1 的测试作为程序集的测试用例。 |
/minpriority:priority |
可选。 指定要基于测试方法的最低优先级导入的测试。 例如，如果参数是 /minpriority:2，则只导入测试方法优先级特性大于或等于 2 的测试作为程序集导的测试用例。 |
/category:filter |
可选。 指定要基于测试程序集中每种测试方法的类别导入的测试。 可以将此参数与 /syncsuite 一起使用，来将测试与某些类别一起导入特定的测试套件。 有关测试类别的更多信息，请参见定义对测试进行分组的测试类别。 |
/syncsuite:id |
可选。 指定要向其中添加所导入测试用例的测试计划中测试套件的套件 ID。 此套件不能为动态套件或基于查询的套件。 如果你指定要同步的测试套件以更新已添加的测试，则会从测试套件（而不是从测试计划本身）中删除未导入的测试。 若要确定要使用的测试套件的套件 ID，可以使用以下命令列出团队项目中的测试套件： tcm suites /list 有关此命令的更多信息，请参见 tcm：列出测试计划、测试套件、测试配置和环境。 |
/include |
可选。 指定也会导入将其标记为 Ignore() 特性的测试方法。 |
/login:username,[password] |
可选。 指定登录到 Team Foundation Server 的应用层服务器并有权运行该命令的用户的名称和密码。 如果你的 Windows 凭据没有适当权限、你使用的是基本身份验证或者你未连接到域，你将使用此选项。 要登录到 Visual Studio Online，你还需使用下列 /allowalternatecredentials。 |
/allowalternatecredentials |
连接到 Visual Studio Online 时，不仅需要指定 /login 参数，还必须指定此标志。 (仅当使用 Visual Studio 2013 Update 4 或更高版本时，此标志才可用。) |
可以将 /collection 和 /teamproject 的参数添加到 tcm.exe.config XML 文件中，该文件位于 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 命令提示符。
为此，请选择**“开始”，指向“所有程序”，指向“Microsoft Visual Studio 2012”，指向“Visual Studio 工具”，然后选择“开发人员命令提示”**。
命令提示符对文件夹打开：<drive>:\Program Files\Microsoft Visual Studio 11.0\VC
将目录更改为包含从测试项目生成的程序集的文件夹。
以下命令会将测试从 TestProject1.dll 导入 DinnerNow 团队项目：
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll
以下命令仅导入优先级为 1 的测试用例：
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /maxpriority:1
以下命令仅导入 SmokeTest 和 ShoppingCart 类别中的测试用例，并将它们添加到 ID 为 3 的测试套件中：
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /category:"ShoppingCart&SmokeTest" /syncsuite:3