Manage tests in the Session Manager

In the Session Manager you manage your exploratory tests. The Session Manager is part of the Exploratory Testing Agent and guides you in performing your exploratory tests on your machine, maintaining your captured scenarios, and handles the uploading of the test results to the Exploratory Testing Server.

In the Session Manager you can either create new scenarios, continue recorded scenarios, or delete existing ones (see "Create, continue or delete scenario").

Once you have finished your exploratory tests, you may end your session in the Session Manager. Your test results will be uploaded to the Exploratory Testing Server (see "Upload test results"). The session owner may import the test results into Tosca Commander after uploading (see chapter "Import test results").

Session Manager start page

Once the Exploratory Testing Agent is opened, the start page of the Session Manager will be shown. This start page shows the session that is currently open. Use the language selection option to define the language to be applied to the Exploratory Testing Agent (see chapter "Session Settings").

  • Click on the View Charter button to display the session charter, the tester charter and the session details. The session charter includes recommendations and instructions for exploratory testers regarding test goals.

  • Click on the Start Testing button to start recording a new scenario (see chapter "Record new scenario").

  • Under Session Details you will find details and settings of the current session, which is shown in the main view of the Session Manager. The Session Details enable you to view detailed information on the session and adjust settings for the current session (see chapter "Session details and settings").

  • Click on to switch from the main view to the start page of the Session Manager.

Session Manager start page

Record new scenario

To start recording a new scenario, follow the steps below:

  1. Click on Start Testing on the start page of the Session Manager, or on the Start Testing button in the main view of the Session Manager.

Starting to record scenarios in the main view of the Session Manager

  1. Select the applications you want to record. To record interactions in applications that require administrator rights, enable the option Start as administrator.

Select applications for recording

The Scenario Manager is started in the record interaction mode (see chapter "Record interactions").

Create, continue or delete scenario

The Scenarios tab in Session Items section in the main view of the Session Manager lists all scenarios that you have already captured in this session. The lower part of the window provides you with an overview of results that you defined for your scenarios: Passed, Failed, No Result.

Session Manager: captured scenarios

In the Scenarios tab of the Session Items section you can perform the following options:

Create scenario

To create a new scenario, click on the Create button in the Scenarios tab in the Session Items section. The Scenario Manager will be launched.

Continue scenario

To continue a existing scenario, select the scenario you would like to continue and click on the Continue button.

Delete scenario

To delete a scenario, select the scenario to be deleted and click on the Delete button.

Rename scenario

To change the name of a scenario, select the required scenario, click on it and rename it accordingly.

You can use the Undo and Redo buttons to undo or redo your local changes.

Raise issue proposal

You can raise issue proposals in the Session Manager, in the Scenario Manager or in the Tosca Commander. You can create an issue from the issue proposal afterwards.

To raise an issue proposal in the Session Manager, follow the steps below:

To raise an issue proposal , follow the steps below:

  1. Go to the Raised Issues tab in the Session Items section of the Session Manager, and click on the Raise button.

Session Manager: raise issue proposal

  1. Define the Type, Priority, Name and Description of the issue. You can also edit the issue proposal later on.

Raise issue proposal in the Session Manager

  1. Optionally you can select the scenarios you want to link to the raised issue in the Scenarios tab of the Raise Issue dialog.

  1. Click on the Raise button to raise the issue proposal.

The issue proposal is created in the Session Manager. The issue proposal is created in Tosca once the test results are imported in Tosca (chapter "Import test results").

Alternatively, you can raise an issue proposal for a scenario by clicking on the Raise Issue button in the Scenario Manager.

Edit issue proposal

To edit an issue proposal, follow the steps below:

  1. Go to the Raised Issues tab in the Session Items section of the Session Manager, and click on the Edit button.

  2. Edit the Type, Priority, Name and Description of the issue.

  3. Click on the Update button to update the issue.

Delete issue proposal

To delete an issue proposal, follow the steps below:

  1. Go to the Raised Issues tab in the Session Items section of the Session Manager.

  2. Select the issue proposal you want to delete

  3. Click on the Delete button.

Link issue proposal to scenarios

To link an issue proposal to scenarios in the Session Manager, follow the steps below:

  1. Go to the Raised Issues tab in Session Items section of the Session Manager.

  2. Select the issue proposal you want to link and click on the Edit button, or click on the / icon next to charter issue.

Link issue proposal to scenario

  1. Switch to the Scenarios tab in the dialog and select the scenarios to which you want to link the issue proposal.

Link issue proposal to scenario

  1. Click on the Update button to link the scenarios to the issue proposal.

Session details and settings

The Session Details section in the main view of the Session Manager provides you with detailed information on your current session.

Click on the View Charter button to view the session charter and the tester charter.

Session Manager: session details

Session Settings

In the Session Settings dialog of the Session Manager you can change the settings for the current session.

To modify the settings for the session switch to the Session Settings tab.

Session Manager: session settings

In the Session Settings, you can specify the following settings:

  • specify language of the Session Manager. If the language is set to Auto, the Exploratory Testing Agent will be launched in the language that is set on the landing page.

  • specify the screenshot quality

  • specify a limit for recording steps upon interaction

  • enable and disable warning and hint messages

  • specify if you want to show the Configure Interactions Recording dialog, in order to select the applications you want to record.

Pause testing

To pause your exploratory test and to close the Session Manager, click on the Pause button in the Stop Testing section in the Session Manager. Alternatively, you can simply close the Session Manager window. As a result, the exploratory test is paused and it can be continued and finished at a later point in time.

Pause testing in the Session Manager

Continue testing

To continue paused sessions, click either on the session link in the session owner's e-mail, or open the according session in the Exploratory Testing Agent via the Windows start menu.

Continue session via the Windows start menu

The Session Manager will open again and you continue your exploratory test.

Upload test results

The Stop Testing section in the main view of the Session Manager allows you to terminate your exploratory test and to upload your test results.

  1. Click on the Complete button in the Stop Testing section to terminate your exploratory test and to transfer your test results to the session owner. Please note that you cannot make any changes to the session after you have terminated the session.

    The Session Manager uploads the data that you created upon exploratory testing. The upload status is indicated by a progress bar.

Terminating the session and uploading results

  1. Optionally you can enable the option Notify Session Owner to send a message to the session owner. As soon as the Session Manager is closed, the system will create an e-mail in your default e-mail application. You can either edit this e-mail or send this directly to the session owner.

  2. Click on the Close button to exit from the Session Manager.

The status of your exploratory test is set to Results Available in Tosca Commander.

Test status Results Available in Tosca Commander

If you would like to upload your test results but you were either uninvited from the session, or you cannot connect to the Exploratory Testing Server, you can save your test results locally and share them manually with the session owner. Click on Share your results manually to save your test results locally as a .txr file. Send the results file to the session owner who will then import this results file into Tosca Commander (see chapter "Import test results from the results file").

Please note that only scenarios that are smaller than 1 GB can be uploaded.