Exploratory Sessions

This chapter focuses on services for exploratory sessions. An exploratory session represents an overview of the execution for an exploratory test case that has been planned in an iteration test plan. It belongs to an iteration test plan, and binds together the test case to execute with the assigned users and the execution.

get Get an exploratory session

A GET to /exploratory-sessions/{id} returns the exploratory session with the given id.

Path parameters

Table 1. /api/rest/latest/exploratory-sessions/{id}
Parameter Description

id

the id of the exploratory session

HTTP request

GET /api/rest/latest/exploratory-sessions/1 HTTP/1.1
Accept: application/json
Host: localhost:8080

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1487

{
  "_type" : "exploratory-session-overview",
  "id" : 1,
  "name" : "session 1",
  "reference" : "REF 1",
  "due_date" : "2023-01-01T11:00:00.000+00:00",
  "session_duration" : 30,
  "session_status" : "FINISHED",
  "comments" : "",
  "charter" : "this is an Exploratory Test Case Charter",
  "iteration_test_plan_item" : {
    "_type" : "iteration-test-plan-item",
    "id" : 1,
    "execution_status" : "SUCCESS",
    "created_by" : "admin",
    "created_on" : "2017-07-12T10:00:00.000+00:00",
    "last_modified_by" : "admin",
    "last_modified_on" : "2017-07-12T10:00:00.000+00:00",
    "executions" : [ {
      "_type" : "exploratory-execution",
      "id" : 1,
      "last_executed_on" : "2023-11-03T11:00:00.000+00:00",
      "task_division" : "User 1 : Test the buttons, User 2 : test the login form",
      "reviewed" : false,
      "assignee_user" : "User 1",
      "_links" : {
        "self" : {
          "href" : "http://localhost:8080/api/rest/latest/exploratory-executions/1"
        }
      }
    } ],
    "_links" : {
      "self" : {
        "href" : "http://localhost:8080/api/rest/latest/iteration-test-plan-items/1"
      }
    }
  },
  "attachments" : [ ],
  "_links" : {
    "self" : {
      "href" : "http://localhost:8080/api/rest/latest/exploratory-sessions/1"
    },
    "project" : {
      "href" : "http://localhost:8080/api/rest/latest/projects/1"
    },
    "iteration" : {
      "href" : "http://localhost:8080/api/rest/latest/iterations/1"
    }
  }
}

Response fields

Path Type Description

_type

String

the type of the entity

id

Number

the id of the exploratory session

reference

String

the reference of the exploratory session

name

String

the name of the exploratory session

due_date

String

the due date of the exploratory session

session_duration

Number

the session duration of the exploratory session

session_status

String

the session status of the exploratory session

comments

String

the comments of the exploratory session

charter

String

the charter of the exploratory session

iteration_test_plan_item

Object

the iteration test plan item of the exploratory session. Please refer to the iteration test plan item documentation for more details.

iteration_test_plan_item.executions

Array

the exploratory executions of the iteration test plan item. Please refer to the exploratory executions documentation for more details.

attachments

Array

the attachments of the exploratory session. Please refer to the attachments documentation for more details.

_links

Object

related links

Relation Description

self

link to this exploratory session

project

link to the project of this exploratory session

iteration

link to the iteration of this exploratory session