测试结果格式
JUnit XML、NUnit、TRX、TestNG、Robot Framework、CTest、Cucumber、Behave、Allure、CTRF、TAP 或 JSON——通用规则、每种格式须包含的内容,以及可下载的模板。
QATrax 不运行您的测试:它接收您的持续集成已经执行的内容,并将其与您的需求关联起来。它读取按测试工具原样 输出的报告,并根据内容识别格式——无需编写转换器,无需更换工具。Xray、Allure TestOps、TestRail、Zephyr、 ReportPortal 和 Azure DevOps 读取的也是这些格式:您的报告依然归您所有。
| 格式 | 生成工具 | 上传的文件 |
|---|---|---|
| JUnit XML | pytest(--junitxml)、Maven Surefire、Gradle、Jest(jest-junit)、Go(gotestsum)、GitLab、Jenkins、mjs-unit --junit | .xml 文件——最常见 |
| NUnit 2 和 3 | nunit3-console、NUnit3TestAdapter | TestResult.xml |
| TRX | dotnet test --logger trx(xUnit、MSTest、NUnit) | .trx 文件 |
| TestNG | TestNG(Maven、Gradle) | testng-results.xml |
| Robot Framework | robot(6 和 7) | output.xml |
| CTest | ctest -T Test(C、C++) | Testing/<date>/Test.xml |
| Cucumber JSON | cucumber-js、Cucumber-JVM、Cucumber Ruby(--format json) | .json 文件 |
| Behave JSON | behave -f json -o behave.json | .json 文件 |
| Allure 2 | 任何语言(allure-results/) | 一个 -result.json,或全部合并:jq -s . allure-results/-result.json > allure.json |
| CTRF | ctrf-io 报告器、mjs-unit --ctrf | .json 文件 |
| TAP | node --test、prove、pytest-tap | 最容易手工编写 |
| JSON | mjs-unit --json,或您自己的脚本 | 当您自己生成报告时 |
既非通过、也非失败、也非跳过的状态——Inconclusive(NUnit、TRX)、undefined 或 pending 步骤(Cucumber、 Behave)、unknown(Allure)、可执行文件缺失导致的 notrun(CTest)——一律计为受阻:绝不计为通过。失败的 TestNG 配置方法会以其名称显示出来。Allure:被重新运行的测试(相同的 historyId)只计一次,以最后一次为准。
通用规则:测试编号位于名称开头
您的计划为每个测试指定一个编号(T-MOD-01)和一个 autoRef:<fichier de test>::<référence>。在报告中, 每个测试的名称都以该编号开头,后接一个分隔符(·、—、: 或 -):
T-MOD-01 · aucune vulnérabilité connue non traitée
用 _ 书写——pytest 和 JUnit 要求如此,因为它们不允许在函数名中使用连字符——同样能被识别: test_T_MOD_01_aucune_vulnerabilite。
在 BDD(Cucumber、Behave)中,或使用 Robot Framework、Allure 时,一个与编号相同的标签即可:在场景上写 @T-MOD-01。如果名称中带有编号,以名称为准。
编号不在计划中的测试会被报告为计划外:它会被显示出来,但不证明任何内容。
JUnit XML
下载模板:resultats-modele.xml。
<testcase name="…">:名称,编号在开头;<failure>(断言失败)和<error>(意外异常):两者都算失败;<skipped>:未运行的测试——绝不计为通过;file(可选):如果缺失或与计划不符,QATrax 会通过编号找到对应文件;- 测试套件的
timestamp:用于标识这次执行。
使用 mjs-unit(0.8.0 及以后版本):mjs-unit test-scripts/*.test.mjs --junit=junit.xml。
TAP
下载模板:resultats-modele.tap。
ok N - <nom> 表示通过,not ok N - <nom> 表示失败,# SKIP 或 # TODO 表示未运行。无需提供文件名:QATrax 会在 计划中找到它。
JSON
下载模板:resultats-modele.json。
{
"title": "Produit modèle — campagne de sécurité",
"generatedAt": "2026-10-03T09:12:00.000Z",
"suites": [
{ "file": "test/acces.test.mjs",
"results": [
{ "name": "T-MOD-03 · un appel sans jeton est refusé (401)", "status": "pass", "durationMs": 8.3 },
{ "name": "T-MOD-04 · un jeton expiré est refusé (401)", "status": "fail", "error": "attendu 401, reçu 200" }
] }
]
}
| 字段 | 必填 | 规则 |
|---|---|---|
suites[].file | 是 | 测试文件,与 autoRef 中的一致;如果不同,当该编号只存在于一个文件中时,可通过编号找到它 |
results[].name | 是 | 编号在开头 |
results[].status | 是 | pass、fail、skip(也接受 passed、failed、error、skipped、todo);其他任何词都会变为“受阻”,绝不会变为“通过” |
error、durationMs | 否 | 失败信息、以毫秒计的耗时 |
generatedAt | 建议 | 用于标识这次执行:每次执行都使用一个新的日期,否则该上传会被识别为已收到 |
手动测试
文档评审、检查、测试台试验:CRA 的许多需求无法通过 CI 证明。在计划中将该用例声明为人工用例("type": "manual", 并列出其步骤),然后在手动测试标签页中录入其结果:通过、失败或受阻,执行日期和地点,观察结果(必填),以及 附件(记录、照片;每个最多 5 MB)。
- 录入以当前登录者的名义进行——而非在字段中手工输入的姓名;
- 每个附件的 SHA-256 指纹都会进入交付物,因而处于封存之下:事后替换的附件将不再匹配;
- 录入既不能编辑也不能删除:下一次录入会在结论中取代它,历史记录保留两者;
- 证书会区分人工测试与 CI 结果,并说明有多少条需求是以这种方式证明的;
- 自动用例不能人工录入:它通过 CI 的结果来证明。
撤销错误的上传
误推送的报告(分支错误、项目错误)可在“执行记录”标签页中撤销,须填写理由:它保留在历史记录中,标记为已撤销 (由谁、何时、为何),但不再计入结论。可用同样方式恢复。错误的人工录入也以同样方式撤销。已签发的交付物保留 它们所封存的内容;下一份交付物会写明被撤销的上传。
计划
下载模板:plan-modele.json——三条 CRA 需求、四个测试。上传它(“需求”标签页),然后 上传三个结果模板之一:四个测试都会被关联,其中一个失败——您可以看到一条失败的需求会如何变化,直至结论。
上传
- 通过界面:流程的第 ② 步,或“执行记录”标签页;
- 通过 CI:使用该项目的 CI 密钥调用
POST /runs?p=<projet>&format=json——参见接入 CI。
响应会说明识别出的格式(dialecte)、已关联的测试、计划外的测试,以及计划中从未执行的测试。