برای تحلیل اختصاصی نتایج تست یا نمایش آنها کنار دادههای دیگر در یک dashboard شخصیسازیشده، میتوانید نتایج را از یک یا چند test run یا test plan با ساختار JSON خروجی بگیرید.
با دریافت جزئیات test runها و نتایج، میتوانید از ابزارهای تحلیلی قدرتمند برای بررسی وضعیت تستها استفاده کنید یا پیشرفت تست را در ابزارهای بیرونی نمایش دهید، برای مثال:
- تحلیل نتایج تست در یک ابزار BI
- نمایش نتایج تست در dashboardهای عملیاتی
دریافت test runها #
ممکن است بخواهید دادههای اجرای تست را از TestRail دریافت کنید تا آنها را نمایش دهید یا به هر شکلی پردازش کنید. اگر فقط به یک نمای کلی از اجرای تست نیاز دارید، مثلا تعداد تستهای passed یا failed در مجموعهای از test runها، میتوانید درخواستی مشابه نمونه زیر ارسال کنید.
GET index.php?/api/v2/get_runs/{project_id}
curl -X GET \
-u "user@example.com:password" \
"https://example.testrail.io/index.php?/api/v2/get_runs/27"{
"offset": 0,
"limit": 250,
"size": 250,
"_links": {
"next": "/api/v2/get_cases/1&limit=250&offset=250",
"prev": null
},
"runs": [
{
"id": 228,
"suite_id": 53,
"name": "New test run",
"description": "Test run description",
"milestone_id": null,
"assignedto_id": 5,
"include_all": false,
"is_completed": false,
"completed_on": 1684939401,
"config": null,
"config_ids": [],
"passed_count": 0,
"blocked_count": 0,
"untested_count": 1,
"retest_count": 0,
"failed_count": 2,
"custom_status1_count": 0,
"custom_status2_count": 0,
"custom_status3_count": 0,
"custom_status4_count": 0,
"custom_status5_count": 0,
"custom_status6_count": 0,
"custom_status7_count": 0,
"project_id": 27,
"plan_id": null,
"created_on": 1684936873,
"updated_on": 1684936873,
"refs": null,
"dataset_id": null,
"created_by": 18,
"url": "https://marketing80testing.testrail-staging.com/index.php?/runs/view/228"
}
]
}فیلتر کردن test runها با query parameterها #
- همه test runهای فعال project با ID ۱ که توسط کاربر با ID ۱ یا ۲ ایجاد شدهاند:
GET index.php?/api/v2/get_runs/1&is_completed=0&created_by=1,2
دریافت نتایج test run #
اگر میخواهید نتایج همه test caseهای خود را تحلیل کنید و از آنها دید دقیقتری بگیرید، میتوانید نتایج را برای هر test run جداگانه دریافت کنید. این کار کنترل جزئیتری روی نتایج تست به شما میدهد.
GET index.php?/api/v2/get_results_for_run/{run_id}
curl -X GET \
-u "user@example.com:password" \
"https://example.testrail.io/index.php?/api/v2/get_results_for_run/228"{
"offset": 0,
"limit": 250,
"size": 250,
"_links": {
"next": "/api/v2/get_results/42&limit=250&offset=250",
"prev": null
},
"results": [
{
"assignedto_id": 1,
"comment": "This test passed.",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "5m",
"id": 801,
"status_id": 1,
"test_id": 91
},
{
"assignedto_id": 1,
"comment": "This test failed: ..",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "3m",
"id": 802,
"status_id": 5,
"test_id": 92
}
]
}فیلتر کردن نتایج تست با query parameterها #
- آخرین ۱۰ نتیجه برای test run با ID ۱ که توسط کاربر ۵ ایجاد شده است
GET index.php?/api/v2/get_results_for_run/1&created_by=5&limit=10
