上传结果

如果Squish测试中心尚不支持您使用的测试结果格式，您也可以使用我们的结果上传API实现自己的支持。我们将Robot框架支持作为我们结果报告API示例的一部分。

通过Squish测试中心UI手动上传

要使用Squish测试中心UI手动上传结果，您首先需要登录具有上传权限的用户帐户。然后，将鼠标悬停在右上角的用户图标和姓名上，并从下拉菜单中选择结果上传。您应该看到一个像下面的页面

上传结果

从项目下拉菜单中选择现有项目。或者，您也可以输入新项目名称并选择添加选项，在上传结果时创建一个新项目。在创建项目中描述了另一种创建新项目的方法。

然后在批次字段中输入批次名称，并选择一个.zip、.xml、.js或单个.csmes文件来上传。您可以与一个.csmes文件一起选择多个.csexe文件，Squish测试中心将把它们合并成一个覆盖率报告。您可以选择将任意文件作为附件上传到这些结果中。

在标签下拉菜单中选择或添加标签到结果，以便从探索和历史视图的报告和测试部分更轻松地选择结果。

点击上传按钮上传结果或点击重置按钮清除所有字段。

通过命令行上传

您可以通过使用testcentercmd或squishrunner在命令行上传Squish测试中心上的结果。

使用testcentercmd

要使用命令行上传结果，您需要Squish测试中心附带的可执行文件testcentercmd。

当调用testcentercmd时，以下内容是必须的

• 上传令牌或具有上传权限的Squish测试中心用户的电子邮件地址和密码。
• 用于标识相同软件、项目或模块的测试的项目名称。
• 测试结果文件或结果目录的路径。

以下内容是可选的

• 服务器实例的URL，默认为http://localhost:8800。
• 用于筛选相同项目测试结果的标签，默认为none。
• 而不是自动生成的名称，使用批次的名称

示例用法

$ testcentercmd --url=http://localhost:8800 --token=MyToken upload Myproject
/path/to/results.zip --label=version=1.0.0 --label=OS=Linux --batch=MyBatch

虽然推荐使用上传令牌，但是您也可以使用命令参数[email protected]和--password=password通过电子邮件地址和密码进行认证。如果您省略了--password参数，当您输入此命令时，系统会提示您输入账户密码。

要查看testcentercmd的完整选项列表，请在一个提示符中输入testcentercmd --help。

使用cURL

如果由于外部因素无法使用testcentercmd，仍然可以使用Squish测试中心API上传结果。API以及一些使用cURL的示例可以在此处找到：文档。

使用 squishrunner

上传 squishrunner 测试套件执行结果是一个两步过程。首先，使用 testcenter 报告生成器来生成 squishrunner 的报告。

squishrunner --reportgen "testcenter,http://localhost:8800/project/Myproject?token=MyToken&label=version%3D1.0.0&label=OS%3Dlinux&batch=MyBatch"

您还必须指定 --local 或一个正在运行的 squishserver 实例，以及通过 --testsuite 运行的测试套件。

label 和 batch 是可选的。关于如何创建 token，请参阅 创建和管理上传令牌。注意，对于标签，URL 中标签值的等号（=）需要转义，并变为 %3D。

squishrunner 完成后，您应该能看到可以用来添加标签或上传附件的 IMPORT_ID。

通过命令行上传附件

一旦您从结果上传或从 探索 视图中获得了 IMPORT_ID，您就可以使用该 ID 上传其他附件。

testcentercmd [email protected] add IMPORT_ID --attachment=MyFile1 --attachment=MyFile2

从 Squish IDE 进行交互式上传

在 Squish IDE 中，选择 窗口 > 显示视图 > Squish Test Center。

Squish IDE 集成

单击 配置 Squish Test Centers 按钮（），然后单击 添加，指定到 Squish Test Center 实例的连接。输入服务器 URL、电子邮件和密码，然后单击 确定。

在 Squish IDE 中设置 Squish Test Center 实例后，实际的结果上传可以在 测试结果 视图的右上角找到。

Squish IDE 集成上传

使用 Jenkins 插件上传

如何配置 Jenkins 插件以上传到 Squish Test Center 是插件文档的一部分：请参阅Jenkins 插件文档。

从 Robot Framework 上传

作为我们 结果上传 API 示例的一部分，我们还包括了一个适用于 Robot Framework 的监听器，该监听器可以从 Robot Framework 测试执行上传结果到 Squish Test Center。

用于监听器的文件可以在 testcenter/examples 文件夹中找到。这是一个使用监听器的 Robot Framework 调用示例

robot --listener TestCenterListener;http://127.0.0.1:8800/upload?project=<project-name>&token=<upload-token>&batch=<batch-name>&os=windows test.robot

监听器提供了单个 URL 作为参数。以下信息是必需的

• 服务器实例的 URL（示例中的 http://127.0.0.1:8800）。
• 项目名称。
• 上传令牌。

可选参数是批处理名称，以及所有其他 URL 查询参数，这些参数作为标签解释。在提供的示例中，上传的结果将被标记为 os=windows。

从 TeamCity 上传

Squish Test Center插件为TeamCity添加了将结果发送到Squish Test Center的功能。需要从代理程序作为工件获取结果，并从TeamCity服务器发送到Squish Test Center。在构建页面中添加了Squish Test Center标签页，包含一个链接用于在Squish Test Center中查看结果。此插件可以集成到Squish Runner插件（2.4版及以上），其中Squish Runner插件负责执行Squish测试，而Squish Test Center插件负责将它们发送到Squish Test Center。

安装

该插件可在以下位置获取：download.froglogic.com/resources/testcenter-teamcity-latest.zip。要安装Squish Test Center插件，请关闭TeamCity服务器，并将插件zip存档复制到TeamCity数据目录的plugins目录。

当您启动TeamCity服务器时，插件文件将自动解包和处理。要检查TeamCity数据目录的位置，请转到管理 > 全局设置。要验证插件是否已安装，请转到管理 > 插件列表。Squish Test Center插件应在外部插件列表中列出。

配置

第一步是为TeamCity提供Squish Test Center安装的信息。

1. 转到管理 > Squish Test Center。
2. 提供测试中心基本URL和上传令牌。
3. 单击测试连接按钮以验证您输入的数据是否正确。

下一步是配置构建配置以将结果发送到Squish Test Center

1. 编辑构建配置设置。
2. 转到构建功能。
3. 单击添加构建功能。
4. 选择Squish Test Center构建功能。
5. 提供Squish Test Center的项目名称、批次名称、标签和结果目录。如果正在将Squish结果发送并且使用Squish插件运行测试，则在结果目录中输入xml3。

探索结果

TeamCity构建完成后，构建页面中的Squish Test Center标签页将包含一个链接，用于在Squish Test Center中探索结果。