GET /test_results¶
Description¶
This API method provides the way for getting test information from HP ALM.
Details¶
Method: GET
Accept: application/json or application/xml
Query parameters:
Name | Description | Required |
---|---|---|
url | URL for HP ALM, must end with "qcbin", e.g. http://almserver:8080/qcbin | Yes |
user | User name for HP ALM | Yes |
encrypted_password | Encrypted password for the user. This is obtained from the /password API | Yes |
domain | Domain for HP ALM project | Yes |
project | Project name in HP ALM | Yes |
testSetPath | Path to a test set in HP ALM TestLab for which results should be pulled, e.g. Root\folder\test set | No (if testPlanPath is set) |
testPlanPath | Path to a test in HP ALM TestPlan for which results should be pulled, e.g. Subject\folder\test | No (if testSetPath is set) |
User must define either testSetPath or testPlanPath parameter in request.
Results¶
Method returns different test results depending on what parameters are passed:
- if testSetPath parameter is passed: Bumblebee returns results for all test instances assigned to the passed test set in HP ALM TestLab.
- if testPlanPath parameter is passed: Bumblebee returns results for all tests inside a TestPlan folder (or single test if only one test is specified) in all test sets into which those tests are assigned. See examples below for details.
Results are returned in either XML or JSON format, depending on the value of "Accept" HTTP header. If "Accept" header is not specified Bumblebee returns results in XML format.
Getting data for a test set in HP ALM TestLab¶
Getting test results for "Demo" test set in "Root\Folder1\Folder2" TestLab folder:
HTTP Request:
GET /bumblebee/test_results?user=qcuser&url=http://almserver:8080/qcbin&domain=default&project=demo&encrypted_password=fd4OMOXLJjkMR6e64RJh3Q==&testSetPath=Root\Folder1\Folder2\Demo HTTP/1.1
Host: bumblebeeserver:8888
XML Results:
<?xml version="1.0" encoding="UTF-8"?>
<results>
<testSet>
<testLabPath>Root\Folder1\Folder2\Demo</testLabPath>
<test>
<name>SearchForTheFirstAlmIntegrationTool</name>
<lastRunStatus>Passed</lastRunStatus>
<lastRunDuration>0</lastRunDuration>
<lastRunExecutionTime>2018-04-11T12:37:37</lastRunExecutionTime>
<runsCount>1</runsCount>
<step>
<name>Test Result</name>
<status>Passed</status>
</step>
</test>
<test>
<name>SomeFailingTest</name>
<lastRunStatus>Failed</lastRunStatus>
<lastRunDuration>0</lastRunDuration>
<lastRunExecutionTime>2018-04-11T12:37:41</lastRunExecutionTime>
<runsCount>1</runsCount>
<step>
<name>Test Result</name>
<status>Failed</status>
<actual>Some error occurred</actual>
</step>
</test>
<testsCount>2</testsCount>
</testSet>
</results>
JSON Results:
{
"testSet": [
{
"testLabPath": "Root\\Folder1\\Folder2\\Demo",
"test": [
{
"name": "SearchForTheFirstAlmIntegrationTool",
"lastRunStatus": "Passed",
"lastRunDuration": 0,
"lastRunExecutionTime": "2018-04-11T12:37:37",
"runsCount": 1,
"step": [
{
"name": "Test Result",
"status": "Passed"
}
]
},
{
"name": "SomeFailingTest",
"lastRunStatus": "Failed",
"lastRunDuration": 0,
"lastRunExecutionTime": "2018-04-11T12:37:41",
"runsCount": 1,
"step": [
{
"name": "Test Result",
"status": "Failed",
"actual": "Some error occurred"
}
]
}
],
"testsCount": 2
}
]
}
Getting results for a test in HP ALM TestPlan¶
Getting test results for "SomeFailingTest" test in "Subject\Folder1\Folder2" TestPlan folder:
GET /bumblebee/test_results?user=qcuser&url=http://almserver:8080/qcbin&domain=default&project=demo&encrypted_password=fd4OMOXLJjkMR6e64RJh3Q==&testPlanPath=Subject\Folder1\Folder2\SomeFailingTest HTTP/1.1
Host: bumblebeeserver:8888
XML Results:
<?xml version="1.0" encoding="UTF-8"?>
<results>
<testSet>
<testLabPath>Root\Folder1\Folder2\Demo</testLabPath>
<test>
<name>SomeFailingTest</name>
<lastRunStatus>Failed</lastRunStatus>
<lastRunDuration>0</lastRunDuration>
<lastRunExecutionTime>2018-04-11T12:37:41</lastRunExecutionTime>
<runsCount>1</runsCount>
<step>
<name>Test Result</name>
<status>Failed</status>
<actual>Some error occurred</actual>
</step>
</test>
<testsCount>1</testsCount>
</testSet>
<testSet>
<testLabPath>Root\Folder1\Folder2\Another set</testLabPath>
<test>
<name>SomeFailingTest</name>
<lastRunStatus>No Run</lastRunStatus>
<lastRunDuration>0</lastRunDuration>
<runsCount>0</runsCount>
<step>
<name>Test Result</name>
<status>No Run</status>
</step>
</test>
<testsCount>1</testsCount>
</testSet>
</results>
JSON Results:
{
"testSet": [
{
"testLabPath": "Root\\Folder1\\Folder2\\Demo",
"test": [
{
"name": "SomeFailingTest",
"lastRunStatus": "Failed",
"lastRunDuration": 0,
"lastRunExecutionTime": "2018-04-11T12:37:41",
"runsCount": 1,
"step": [
{
"name": "Test Result",
"status": "Failed",
"actual": "Some error occurred"
}
]
}
],
"testsCount": 1
},
{
"testLabPath": "Root\\Folder1\\Folder2\\Another set",
"test": [
{
"name": "SomeFailingTest",
"lastRunStatus": "No Run",
"lastRunDuration": 0,
"runsCount": 0,
"step": [
{
"name": "Test Result",
"status": "No Run"
}
]
}
],
"testsCount": 1
}
]
}