Share:
TestBench CS Online Help Publication

Test Sessions

Items » Test Cases » Test Sessions
To create a new Test Session, navigate to the Product Home Screen.

If there are already existing Test Sessions or Test Suites, they are listed at the Planning Tile at the Product Home Screen. You can see three Test Sessions or Test Suites, sorted by last created or updated. The circle in front of a Test Sessions or a Test Suite shows its status. With a click on one of the Test Sessions or Test Suites, their detailed view opens.

Click on the Planning Tile or on “Test Planning” at the right bottom of the tile. The Planning View opens.

On the Planning View, you can see a complete list of Test Sessions and Test Suites. They are sorted by last created or updated. If you click on the name of an existing Test Session, you can navigate to the detailed view of this Test Session.


With a click on the plus button, you can create a new Test Session. A form opens, where you can insert the name of the Test Session. Click on the "ADD" button.



The detailed view of the Test Session or Test Suite opens. By default, the focus is set on the description field. Enter the description and click on the check icon.



To add Test
Executions to a Test Session, you must be an active participant in a Test Session. Navigate to Specifications View and click on the requested Test Cases. If you start an execution, it will be added automatically to the Test Session.

InformationUse filtering to choose your Test Cases or choose Test Cases from Tree View.


The brown gear icon with the checkbox in the header shows that you are an active participant in a test session.



Sections of the Test Session detailed view

Header with title, Test Session ID, data about creation of that Test Session. To change the title, hover over the field. The background gets gray, and you can click it. Enter the title.

Responsible Users

Status: The status of a Test Session can be new, planned, ready, in progress, or completed. As soon as you click on “Start Session”, the status of the Test Session changes to “In Progress”.



You can also change the status manually from "in progress" to any other status. Click on the arrow symbol next to the progress pill. A dropdown menu opens, and you can select the new status. A modal dialog opens where you can confirm or cancel your action.



WarningIf a user decides to change the status of a Test Session, an active participant will become an inactive participant in that Test Session! 

Schedule: To set the time-box for the test session, click on "Start date" or "End date". A time picker opens where you can make a selection.



Description:
To add a description, hover over the field. The background gets gray, and you can click it. Enter the description.

Evaluation: Here, you can see a pie chart. If the Test Session has no executions, the pie chart is gray, and the legend shows “No data provided”. As soon as there are executions, the chart shows the status of the executions (how many are passed, failed, or in progress). The legend of the chart shows the number of execution’s status.



Participants: There are two types of participants of a Test Session: active or inactive ones.

Active participants of a Test Session appear in the top row of the participant's section with green letters and gray background.
Inactive participants appear in the bottom row of the participant's section with gray letters and a white background

To become an active participant in a Test Session, click the “Join” checkbox. It is enabled as soon as the Test Session is in progress. If you are an active participant, the “Join” checkbox is replaced by the “You participate” checkbox, which is by default checked.





To remove a participant (active or inactive), click on the “x” symbol next to the 
participant's name.

InformationA user can only be an active participant in one Test Session in a Product! If you are already an active participant in a Test Sessions and try to join another, a modal dialog opens. If you want to join another Test Session, click JOIN, if not click CANCEL. 


Test Case Execution: Here, you can see the list of all executions that belong to the Test Session. It shows the execution name, the status, and the creation date. With a click on the “x” button, you can remove an execution.

If you click on one of the executions in the list, the detailed execution view of that specific execution opens.


To delete a Test Session, click on the dust bin icon in the top-right corner of the screen. A dialog opens, where you can confirm or cancel your action.


You can add Custom Fields to the Detailed View of a Test Session in three places: before Description, before Test Case execution, and Bottom. For detailed information about Custom Fields, see Chapter on Custom Fields.