Zum Hauptinhalt springen

Test Run

TMT API (1.0.0)

Download OpenAPI specification:Download

API working with Test folders in TMT

Get test run

Get content of a test run by given document reference

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

GET_DOCUMENT

required
object

Responses

Request samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "method": "GET_DOCUMENT",
  • "id": "GET_DOCUMENT-2",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "GET_DOCUMENT-2",
  • "result": {
    }
}

List test run Deprecated

List test run documents for given search criteria. This is deprecated and will not be supported in the next release. Please use List test run documents instead

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
any

LIST_TEST_RUNS

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "TestRuns.DataProvider-3",
  • "jsonrpc": "2.0",
  • "method": "LIST_TEST_RUNS",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "TestRuns.DataProvider-3",
  • "result": {
    }
}

List test run documents

List test run documents for given search criteria.

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

LIST_DOCUMENT

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "TestRun.DataProvider-98",
  • "jsonrpc": "2.0",
  • "method": "LIST_DOCUMENTS",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "TestRun.DataProvider-98",
  • "result": {
    }
}

Create a test run

Create a new test run

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

ADD_DOCUMENT

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "ADD_TEST_RUN",
  • "method": "ADD_DOCUMENT",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "ADD_TEST_RUN",
  • "result": {
    }
}

Update test run

Update test run content

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

MODIFY_DOCUMENT

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "MODIFY_TEST_RUN",
  • "method": "MODIFY_DOCUMENT",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "MODIFY_TEST_RUN",
  • "result": null
}

Delete a test run

It is only possible to delete an empty run. For non empty test run, you must remove its test suites first, which can be done by calling DELETE_SUITE_FROM_RUN operation

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

DELETE_TEST_RUN

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "DELETE_TEST_RUN_TestRun-dm/11825df5-4460-479d-a282-e996d804b571",
  • "jsonrpc": "2.0",
  • "method": "DELETE_TEST_RUN",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "DELETE_TEST_RUN_TestRun-dm/11825df5-4460-479d-a282-e996d804b571",
  • "result": true
}

Check a run is empty

Check a run is empty or not. You should call this endpoint before deleting a test run.

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

CHECK_TEST_RUN_EMPTY

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "CHECK_TEST_RUN_EMPTY_6f1f3601-88bb-47e0-b4b5-42f4ff3596be",
  • "jsonrpc": "2.0",
  • "method": "CHECK_TEST_RUN_EMPTY",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "DELETE_TEST_RUN_TestRun-dm/11825df5-4460-479d-a282-e996d804b571",
  • "result": true
}

Get available test suites to add to run

List all suites that are available to add into Run, which excludes the suites already in Run. This is not applicable for closed run

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
string

GET_AVAILABLE_TEST_SUITES

object

Responses

Request samples

Content type
application/json
{
  • "id": "TestSuites.DataProvider-0",
  • "jsonrpc": "2.0",
  • "method": "GET_AVAILABLE_TEST_SUITES",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "TestSuites.DataProvider-0",
  • "result": {
    }
}

Add test suites to open run

Add available test suites to an open run

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

ADD_TEST_SUITES_TO_RUN

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "ADD_TEST_SUITES_TO_RUN_1",
  • "method": "ADD_TEST_SUITES_TO_RUN",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "ADD_TEST_SUITES_TO_RUN_1",
  • "result": [
    ]
}

Delete test suites from open run

Delete the test suites from an open run. This is not applicable to closed run

Authorizations:
bearerAuth
header Parameters
Project-Id
required
string

Project Id or the project document reference

Subproject-Id
string

Sub Project Id or the project document reference. It might be required if you want to access the sub project's resource

Request Body schema: application/json
required
id
required
string

id of the operation

jsonrpc
required
string

must be 2.0

method
required
string

DELETE_TEST_SUITES_FROM_RUN

required
object

Responses

Request samples

Content type
application/json
{
  • "id": "DELETE_TEST_SUITES_FROM_RUN_1",
  • "method": "DELETE_TEST_SUITES_FROM_RUN",
  • "params": {
    }
}

Response samples

Content type
application/json
{
  • "jsonrpc": "2.0",
  • "id": "DELETE_TEST_SUITES_FROM_RUN_1",
  • "result": null
}