QATrax
以 Markdown 查看

测试结果格式

JUnit XML、NUnit、TRX、TestNG、Robot Framework、CTest、Cucumber、Behave、Allure、CTRF、TAP 或 JSON——通用规则、每种格式须包含的内容,以及可下载的模板。


QATrax 不运行您的测试:它接收您的持续集成已经执行的内容,并将其与您的需求关联起来。它读取按测试工具原样 输出的报告,并根据内容识别格式——无需编写转换器,无需更换工具。Xray、Allure TestOps、TestRail、Zephyr、 ReportPortal 和 Azure DevOps 读取的也是这些格式:您的报告依然归您所有。

格式生成工具上传的文件
JUnit XMLpytest(--junitxml)、Maven Surefire、Gradle、Jest(jest-junit)、Go(gotestsum)、GitLab、Jenkins、mjs-unit --junit.xml 文件——最常见
NUnit 2 和 3nunit3-console、NUnit3TestAdapterTestResult.xml
TRXdotnet test --logger trx(xUnit、MSTest、NUnit).trx 文件
TestNGTestNG(Maven、Gradle)testng-results.xml
Robot Frameworkrobot(6 和 7)output.xml
CTestctest -T Test(C、C++)Testing/<date>/Test.xml
Cucumber JSONcucumber-js、Cucumber-JVM、Cucumber Ruby(--format json).json 文件
Behave JSONbehave -f json -o behave.json.json 文件
Allure 2任何语言(allure-results/)一个 -result.json,或全部合并:jq -s . allure-results/-result.json > allure.json
CTRFctrf-io 报告器、mjs-unit --ctrf.json 文件
TAPnode --test、prove、pytest-tap最容易手工编写
JSONmjs-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。

使用 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)。

撤销错误的上传

误推送的报告(分支错误、项目错误)可在“执行记录”标签页中撤销,须填写理由:它保留在历史记录中,标记为已撤销 (由谁、何时、为何),但不再计入结论。可用同样方式恢复。错误的人工录入也以同样方式撤销。已签发的交付物保留 它们所封存的内容;下一份交付物会写明被撤销的上传。

计划

下载模板:plan-modele.json——三条 CRA 需求、四个测试。上传它(“需求”标签页),然后 上传三个结果模板之一:四个测试都会被关联,其中一个失败——您可以看到一条失败的需求会如何变化,直至结论。

上传

响应会说明识别出的格式(dialecte)、已关联的测试、计划外的测试,以及计划中从未执行的测试。