SessionCreatorHelp

Help for the
SessionCreator
Version 1.4.3

Content:
Introduction
1. System Requirements
2. Configuration
3. The SessionCreator Wizard
3.1 Welcome-Tab
3.2 Charter-Tab
3.3 Areas-Tab
3.4 Testsession-Tab
4. Review Page
5. Report Site
6. Example Content coverage.ini

1

Introduction
My tool the SessionCreator is an add-on for James Bach Session-Based Test Management
(SBTM), but you can also use it as a standalone tool.
With the SessionCreator you can create new “Todo”-Sessions, run a Testsession, do a
review (known as “debriefings” at SBTM) and you also have a reporting page.

If you have questions or suggestions send me an e-mail: sabf81@gmail.com

1. System Requirements
Operationsystem:
● Windows XP or Windows 7
● MacOS 10.6

Java platform:
● JDK 1.6 (Default)

There are two options to use my tool:

1. As an add on
In this case you have to download the Session-Based Test Management (SBTM) from
James Bach you can click this link: prototype to download it now.
After that download the SessionCreator and do some settings, which you can read in
the “Configuration”-Chatper.

2. As standalone tool
You only need to download the SessionCreator and do some configuration. Which please
read the “Configuration”-Section.

2

2. Configuration
First unzip the SessionCreator-zip file. Now you see four files. Here you can read how to set up
the SessionCreator for the two options:

File Add on Version standalone

Config.txt Edit the path to the Edit this file and enter the path
corresponding folder in to three folders and also the
the directory of SBTM path to the “coverage.ini”. If
(Todo, Submitted and that file does not exists you
Approved) and also the path should create it!1.
to "coverage.ini" (the file is
filled in with my paths as an
example)

Tester.txt Here you enter the names Here you write down your
of their testers. Please use testers name. Please use
the format "<acronym>,<Full the format "<acronym>,<Full
Name>" e.g. sfi, Sven Name>" e.g. sfi, Sven
Finsterwalder Finsterwalder

Session-template.ses This file should remain This file should remain
unchanged! It serves the unchanged! It serves the
session for submission to session for submission to
saving a Test Session. saving a Test Session.

SessionCreator.jar The application itself, start by The application itself, start by
double-click. double-click.

1An example of the content for the coverage.ini you can find at the end of this document

3

3. The SessionCreator Wizard
After the configuration has finished the session creator can be started by double click.
Now the SessionCreator Wizard appears. You should see this screen:

If you want to create a Todo-Session or if you want to make a Test-Session read this chapter.

3.1 Welcome-Tab
First select your name, it is important for two things: 1. to save the Test-Session and 2. to fill out
the testers name.
If you do a Test-Session with another Tester please select the check-box “More Testers?” and
choose the second Tester.
The two text fields “Path to Todo-Sessions” and “Path to ‘Submitted’-Folder” show again the paths
to the directories.
The first file path is required to view the current Todo-Session in the SessionCreator and in order
to save a new Todo-Session. If you select the check-box “Include Sub-folder e.g. _older” then the
SessionCreator looks also in the Sub-folders of Todo-Folder.
The second file path is required to save the finished Test-Session.
Now press the “Next”-Button right below.

4

3.2 Charter-Tab
Now the Charter-Tab appears.

If you want to do a Test-Session you can:
1. choose one Charter of the first drop-down (here are all the Charters from the Todo
directory displayed). Or
2. you can select the check-box “New Charter” and write down your own Charter (if you
choose this option you will be able to save this Charter as a new Todo-Session).

Click the “Next”-Button to go on.

5

3.3 Areas-Tab
On this page you can choose the corresponding “Areas” for the Testsession.

All the Areas from the “coverage.ini”-file are here displayed grouped by a tab-rider.
You can double-click the area you want to use and they will be listed in the text-box at the bottom.
Or you can select the areas in one tab-rider e.g. “OS | Windows 7” and “OS | MAC” and add them
by clicking the “+”-Button at the right side below.
If you want to remove an area you can press the “-”-Button at the right side below or removes it by
pressing the “Del”-Button at your keyboard.

In the event that you want to create a new Todo-Session (you have selected the “New Charter”-
Check-box), the “Save-Todo-Session”-button must be pressed. A small dialog appears where
you should enter the name for the new “Todo”-Session and press the “Save”-Button.

To create the Testsession just press the “Create Testsession”-button at the bottom.

6

3.4 Testsession-Tab

Here is the Testsession with SBTM it was a simple textfile, with the SessionCreator it is easier to
create one.

Press the “Start”-Button either above or below to start the session and it automatically sets the
start date. A stopwatch is running with, this will automatically calculate the duration when the stop
button (above or below) is pressed.
If you have pressed the “Start”-Button you can not go back in the wizard and edit some thing of
your Testsession.
On the left side at the top you see your charter.

7

Below that there are the Areas listed. In this text box you can edit the areas too. You can open a
context menu to add an area during the Testsession. If you need to remove some areas do it with
your keyboard as in a text document.

On the right side there are five tabs:
Data Files there you can add the file-path to your data file.
Test Notes here you can write down your session protocol.
Bugs here you can enter your errors found. With a context menu, you can simple add
the “#BUG”-Tag.
Issues in this section you can add your Issues. With a context menu, you can easily add the "#
ISSUE"-Tag.
Review The review section will not be filled.
After stopping the session you can fill out the “Task Breakdown” and press the “Save”-Button.
If you did a mistake a validator for „Test Design and Execution“, „Session Setup“ and „Bug
Investigation and Reporting“ also for „Charter vs. Opportunity“ will show you what you have to do.

8

When the store was successful, a dialog appears with the file name.

If there are more then two Testsession a second dialog appears:

Now you can press the “New”-Button and start a new Testsession.

10

4. Review Page
If you wish to do a review, please open the review page. You found it in the menu Session ->
Review Page.

On the first page of the Review Page you get an overview.
In the first box you can see how many session each Tester has done.
In the dropdownbox the session can be selected for a review to be performed. If you have a
session selected press the “Next”-Button.

11

On the review page you can do the debrief and enter your results in the “Review”-tab.

After you have done your review you can save the session and choose another session to review.

5. Report Site
The SessionCreator contains a small report page. It can be opened by this menu:

12

It can take a while until the report is generated and you will see a waiting screen.

After the report is loaded you get a table with all your Testsession, grouped by charter. At the
bottom you will get an pie-chart that contains Sessions by Tester. You can sort both columns.

13

SessionCreatorHelp

More Related Content

Similar to SessionCreatorHelp (20)

Recently uploaded (20)

SessionCreatorHelp