Exploratory Executions
This chapter focuses on services for exploratory executions. An exploratory execution represents the execution of an exploratory session by an assigned user. It belongs to an exploratory session.
Get an exploratory execution
A GET
to /exploratory-executions/{id}
returns the exploratory execution with the given id.
Path parameters
Parameter | Description |
---|---|
|
the id of the exploratory execution |
HTTP request
GET /api/rest/latest/exploratory-executions/1 HTTP/1.1
Accept: application/json
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1838
{
"_type" : "exploratory-execution",
"id" : 1,
"name" : "execution 1",
"reference" : "REF 1",
"execution_mode" : "EXPLORATORY",
"progress_status" : "RUNNING",
"last_executed_by" : "User 1",
"last_executed_on" : "2023-11-03T11:00:00.000+00:00",
"charter" : "this is an Exploratory Test Case Charter",
"task_division" : "User 1 : Test the buttons, User 2 : test the login form",
"session_notes" : [ {
"_type" : "session-note",
"id" : 1,
"kind" : "SUGGESTION",
"content" : "Suggestion 1",
"_links" : {
"self" : {
"href" : "http://localhost:8080/api/rest/latest/session-notes/1"
}
}
} ],
"reviewed" : true,
"comment" : "no comment",
"custom_fields" : [ {
"code" : "CUF_TXT",
"label" : "cuf text",
"value" : "cuf text value"
}, {
"code" : "CUF_TXT_2",
"label" : "cuf text 2",
"value" : "cuf text value 2"
} ],
"test_case_custom_fields" : [ {
"code" : "TC_CUF_TXT",
"label" : "tc cuf text",
"value" : "tc cuf text value"
}, {
"code" : "TC_CUF_TXT_2",
"label" : "tc cuf text 2",
"value" : "tc cuf text value 2"
} ],
"attachments" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost:8080/api/rest/latest/exploratory-executions/1"
},
"test_plan_item" : {
"href" : "http://localhost:8080/api/rest/latest/iteration-test-plan-items/1"
},
"project" : {
"href" : "http://localhost:8080/api/rest/latest/projects/1"
},
"exploratory_session" : {
"href" : "http://localhost:8080/api/rest/latest/exploratory-sessions/1"
},
"attachments" : {
"href" : "http://localhost:8080/api/rest/latest/exploratory-executions/1/attachments"
},
"issues" : {
"href" : "http://localhost:8080/api/rest/latest/exploratory-executions/1/issues"
}
}
}
Response fields
Path | Type | Description |
---|---|---|
|
|
the type of the entity |
|
|
the id of the exploratory execution |
|
|
the reference of the exploratory execution |
|
|
the name of the exploratory execution |
|
|
the execution mode of the exploratory execution |
|
|
the progress status of the exploratory execution |
|
|
the user who last executed this execution |
|
|
the date this execution was last executed |
|
|
the charter for the exploratory execution |
|
|
the task division regarding the exploratory execution |
|
|
the session notes of the exploratory execution. Please refer to the session note documentation for more details. |
|
|
whether the exploratory execution has been reviewed |
|
|
any comments added to the exploratory execution |
|
|
the custom fields for the exploratory session. Please refer to the custom field documentation for more details. |
|
|
the custom fields for the referenced test case. Please refer to the custom field documentation for more details. |
|
|
the attachments of the exploratory session. Please refer to the attachment documentation for more details. |
|
|
related links |
Links
Relation | Description |
---|---|
|
the link to this execution |
|
the link to its test plan item |
|
the link to its project |
|
the link to its exploratory session |
|
the link to an execution’s attachments |
|
link to the issues of this exploratory execution |
Get issues of an exploratory execution
A GET
to /exploratory-executions/{id}/issues
returns all the issues of the exploratory execution with the given id.
Path parameters
Parameter | Description |
---|---|
|
the id of the exploratory execution |
HTTP request
GET /api/rest/latest/exploratory-executions/1/issues HTTP/1.1
Accept: application/json
Host: localhost:8080
Request parameters
Parameter | Description |
---|---|
|
number of the page to retrieve (optional) |
|
size of the page to retrieve (optional) |
|
which fields of the elements should be returned (optional) |
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 622
{
"_embedded" : {
"issues" : [ {
"remoteIssueId" : "165",
"url" : "http://192.175.1.51/bugzilla/show_bug.cgi?id=165",
"session-notes" : [ {
"_type" : "session-note",
"id" : 1,
"_links" : {
"self" : {
"href" : "http://localhost:8080/api/rest/latest/session-notes/1"
}
}
} ]
} ]
},
"_links" : {
"self" : {
"href" : "http://localhost:8080/api/rest/latest/exploratory-executions/1/issues?page=0&size=20"
}
},
"page" : {
"size" : 20,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}
Response fields
Path | Type | Description |
---|---|---|
|
|
the issues of this exploratory execution |
|
|
the remote issue id of the issue linked to the exploratory execution. |
|
|
the url of the issue linked to the exploratory execution. |
|
|
the session notes linked to the issue. If the issue is not linked to any session notes, this field will not appear. |
|
|
the page size for that query |
|
|
total number of elements the user is allowed to read |
|
|
how many pages can be browsed |
|
|
the page number |
|
|
related links |
Links
Relation | Description |
---|---|
|
link to the first page (optional) |
|
link to the previous page (optional) |
|
link to this page |
|
link to the next page (optional) |
|
link to the last page (optional) |