صيغة نتائج الاختبارات
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 لا تُثبت بالتكامل المستمر. أعلن الحالة يدوية في الخطة ("type": "manual"، مع خطواتها)، ثم أدخل نتيجتها في تبويب الاختبارات اليدوية: ناجح، أو فاشل، أو معطّل، وتاريخ التنفيذ ومكانه، والمعاينة (إلزامية)، و المرفقات (محضر، صورة؛ 5 ميغابايت كحد أقصى لكل منها).
- يتم الإدخال باسم الشخص المتصل — وليس أبدًا باسم مكتوب في حقل؛
- بصمة SHA-256 لكل مرفق تدخل في المُسلَّم، أي تحت الختم: المرفق المستبدَل لاحقًا لم يعد يطابق؛
- لا يُعدَّل الإدخال ولا يُمحى: يحل محله الإدخال التالي في الحكم، ويحتفظ السجل بكليهما؛
- تميّز الشهادة الاختبار اليدوي عن نتيجة CI، وتذكر عدد المتطلبات المُثبتة بهذه الطريقة؛
- الحالة الآلية لا تُدخل يدويًا: بل تُثبت بنتائج التكامل المستمر.
إلغاء إيداع خاطئ
التقرير المُرسل خطأً (فرع خاطئ، مشروع خاطئ) يُلغى من تبويب «التنفيذات»، مع سبب: يبقى في السجل، موسومًا بأنه ملغى (من، متى، لماذا)، لكنه لم يعد يُحتسب في الحكم. ويمكن استعادته بالطريقة نفسها. والإدخال اليدوي الخاطئ يُلغى بالطريقة ذاتها. تحتفظ المُسلَّمات الصادرة سلفًا بما ختمته؛ ويذكر المُسلَّم التالي الإيداعات الملغاة.
الخطة
نزّل النموذج: plan-modele.json — ثلاثة متطلبات من CRA، وأربعة اختبارات. أودعه (تبويب «المتطلبات»)، ثم أحد نماذج النتائج الثلاثة: تُربط الاختبارات الأربعة، ويفشل أحدها — فترى ما يؤول إليه متطلب فاشل، وصولًا إلى الحكم.
الإيداع
- من الشاشة: الخطوة ② من المسار، أو تبويب «التنفيذات»؛
- من نظام CI:
POST /runs?p=<projet>&format=jsonبمفتاح CI الخاص بالمشروع — انظر ربط نظام التكامل المستمر.
يبيّن الرد الصيغة المتعرَّف عليها (dialecte)، والاختبارات المرتبطة، وتلك الخارجة عن الخطة، واختبارات الخطة التي لم تُنفَّذ قط.