Bonfire introduces the concept of a Test Session to JIRA.

Test Sessions Overview

source: http://blogs.atlassian.com/2011/08/test_sessions_with_bonfire/

This section will provide a conceptual introduction and overview of what Test Sessions are and how they differ from Test Cases.

Differences between Test Sessions and Test Cases

Test sessions differ from test cases in two ways. Firstly, more than one test can be carried out in a single session. Secondly, like test cases, test sessions can tell us who tested what, but they can also tell us how, when and why we tested. That makes test sessions useful for planning, executing and tracking manual testing, because they;

  • Require testers to identify test objectives and focus their testing efforts on fulfilling them.
  • Encourage testers to modify existing tests and add new tests to meet those objectives as they test.
  • Provide a useful way to manage and review exploratory testing.
  • Focus attention on the testing that’s actually performed, not just on test case results.
  • Give testers the flexibility to respond to changes and re-plan their testing quickly.

Getting the most out of Test Sessions

There’s no restriction on when test sessions are added. It’s not uncommon for sessions to be created whilst the feature is being planned and developed and tested. Sessions can also be renamed or deleted as needed. If you have pre-written tests they can be run during a session, but because test sessions emphasize test objectives over specific test cases, testers are also encouraged to devise and run any additional tests that they feel will help meet the test objective. Creating and executing more tests based on what you discover and learn whilst testing is an approach called exploratory testing. It’s an extremely powerful way of optimising test coverage without incurring the costs associated with writing and maintaining test cases.

Learn more about Session Based Testing

We recommend reading about Jonathan and James Bach’s Session Based Test Management method.

Test Sessions in Bonfire

This section explains how Test Sessions work within Atlassian Bonfire.

Creating Sessions

To create a session belonging to an issue, click the "More Actions" drop down in the view issue page, and then fill in a session name. A session's name is flexible, and can be anything you like (e.g. "Test browser compatibility with Internet Explorer", or "Find security vulnerabilities").

Tip - You can create test sessions using JIRA's keyboard shortcuts and quick access dialogs as well. So you can quickly create a test session for an issue in the Issue Navigator by typing "." then "Create Test Session".

It is also possible to create a session on the project page by going to the 'Test Sessions' tab and clicking on the 'Create Session' button.

A session can have zero or more "Related Issues" which serve as a relationship between existing issues in your system and the testing being performed. If you create a session from the view issue page, that issue is automatically set as the session's only related issue. 

Sessions can also be created in the "Test Sessions" tab. 

It is possible to associate a shared template with a test session, even if the template is owned by another user. Anyone who joins the shared session will automatically use that template until they leave the session, ensuring consistent bug reports across your entire team. For more information on templates, please read Templates and Variables

Creating Test Sessions from the browser extension

To create a test session from the browser extension, click on the "Create Session" button at the bottom of the session list and fill out the form.

Viewing Session details in the browser extension

To see the full details of a test session in the browser extension, simply click on the session in the session list.

The details view shows the session's additional information, participants, related issues, issues raised and notes. Additional actions such as editing, completing, deleting the test session and adding notes can also be done from this view.

Editing Test Sessions from within the extension.

When you are viewing the details of a session, if you have permission to edit it, you will see an edit button.

Assigning Sessions

Sessions can be assigned to other team members to be worked on.

Only users who have the "Assignable User" permission on the project which this session belongs will be able to have the session assigned to them.

The assignee of the session can start progress on the session, pause the session, capture issues and notes within that session, and complete the session.

Working in a session

Any test session have four states - Created, In Progress, Paused, and Completed. To modify the status of a session, use the buttons on the left. 

For each user, only one session can be active at one time. The active session is always displayed in the orange bar along the top of JIRA web interface. In the Bonfire browser extension, under the "Sessions" tab, you can also see all the test sessions that are available to you. You are also able to start and pause sessions in the list.

Similar to Bonfire in JIRA, the Bonfire browser extension will always display the active test session along the top of the display.

Collaborating with shared Sessions

You can share a test session to allow others to participate in the session and join in collaborative testing efforts.

Once a session is shared and started, other participants on your team can join that session.

To join a shared test session, the session needs to have been started and users need to have the 'Assignable' JIRA permission.

 

The Bonfire browser extension also displays all the sessions that can currently be joined.

Any testing activity performed by any participants will be tracked against the session, like issues raised and notes taken.

You can see all the people who participated in a Test Session on the Test Session page. Greyed out names show users that previously joined but have since left the session.

Completing Sessions

At the end of the testing, you can complete a test session in the JIRA web interface clicking on the "Complete" link. At this stage, you can finalize the testing and summarize the testing, including picking the issues raised during the test session to link to the original issue(s), or logging the time worked during testing.

If there are other active participants in the session, they will be forced to leave the session once the session is completed.

Complete session in the browser extension

It is also possible to complete a test session from within the browser extension. To complete a test session, view its details and then click the "Complete" button. 

All of the operations that can be done in the JIRA page can also be done in the extension.

View details of Test Sessions on an issue

Each issue will have a panel on the issue page that will show all the Test Sessions that have a relationship with the issue.

You can also configure the columns in the JIRA Issue Navigator to show Test Sessions. 

Viewing Test Sessions in GreenHopper

You can also view these details in GreenHopper (as of 6.0). 

Quick actions for Test Sessions

To avoid unnecessary trips to the session page, we have included contextual actions for Test Sessions on the View Issue page and the GreenHopper details view. 

If you have the necessary permissions, you can quickly Assign, Start, Pause, Join, Leave or Complete a test session without going to the session page. You can also edit the Additional Information and Notes.

 

Browse all Test Sessions

To browse all Test sessions, click on the "Test Sessions" drop down and select "Browse Test Sessions"

The new test sessions page gives you an overview of all test sessions on the server, with filter options for assignee, project, status and session name. This page means that you no longer have to go digging through individual project pages just to find a test session. This page also includes sortable columns, a permalink option to help with bookmarking/sharing of filter results and a Create Session link to create a session for any project.

  • No labels

13 Comments

  1. Do sessions allow me to create the test steps I would like a QA person to walk through or does this just track the progress of a test session without particular test steps? I'm just curious if I can use Bonfire sessions to help me with test planning or just quicker bug entry into JIRA.

    1. Bonfire's test sessions are more freeform than traditional test cases, so they don't explicitly define test steps. However, you can use the Additional Info section of a test session to give instructions to the person doing the testing.

      For more details about the thinking behind test sessions, take a look at this blog post written by Atlassian's QA lead: http://blogs.atlassian.com/2011/08/test_sessions_with_bonfire/

  2. Anonymous

    Is it  possible to use Bonfire without tracking the time spent during a session? I didn't find any configuration settings at this point.

    Thanks, Joachim Geißler

    1. Hi Joachim,

      Currently it is not possible to completely disable time tracking for a test session. If time tracking is disabled in JIRA's settings, Bonfire will still ask for time tracking for a test session, but will not allow a the time to be added to the session's related issue.

      I have opened an issue to disable Bonfire's test session time tracking when time tracking is disabled in JIRA:  BON-932 - Getting issue details... STATUS

      As a workaround in the meantime, you can enter "0" or leave the Time Spent field empty when completing the session.

      Cheers,
      Gilmore 

  3. Anonymous

    How do we keep track of the time spent on Test Sessions associated with a project (and not to any issue). We use tempo for time-sheets and time tracking. Time recorded with Bonfire test sessions attached with a project are not visible anywhere, except the test session itself. Can you help me identify where i can view these times other than the test session itself?

    1. If a test session has a related issue, you can also log the time spent during the test session against its related issue (when completing the session).

      We also have an open feature request regarding the logging of test session time to a project:  BON-874 - Getting issue details... STATUS

  4. Anonymous

    Although we can assign test sessions to any resource but i dont see a way to view the test sessions that are assigned to me. How can i view test sessions that are assigned to me on all projects. Also i dont see an email getting generated when test sessions are assigned.

    Regards

    Asad

    1. Hi Asad,

      You can view all the test sessions assigned to you by going to your user profile in JIRA and selecting the "Test Sessions" tab.

      At this stage no email notifications are sent out during test session creation, but I have raised a feature request for you at  BON-1023 - Getting issue details... STATUS

      Cheers,
      Gilmore 

      1. Anonymous

        I would also like to have to have an email notification if a test session is assigned to me. And i would like to see the test session in my dashboard if it is assigned to me.

        Best regards

        Sebastian

  5. Anonymous

    Hi Bonfire Team,

    We’re currently evaluating Bonfire “Test Session” feature.

    Firstly: This is a great concept.

    Please consider to add this feature;

    We would like to see “Test Session” on the GreenHopper Rapid board instead viewing the information under my profile. If a Rapid board user, I would like to see the all the test session for a an Issue. This enable us to see, what are session is currently started, completed, paused, etc. by filtering.

    And also make it available this “Test Session” as a Wallboard gadget.

    Cheers,

    Ganga S

     

  6. Anonymous

    Is there a way to allow any user (or group of users) to start a session that you have created? Currently I only see that you can reassign a session to a specific user, not truly "share" it in regards to allowing other users to start/pause it. So, for example, if I'm out of the office and have not started a session, my co-workers would not be able to log against that session until it was assigned to one of them directly.

     

    Thanks,

    Ann-Marie

    1. Anonymous

      yes, this is something I would really need. let others thatn the assigned tester start/pause a test session

  7. I can't see creating sessions option in the "More Actions" drop down list in the view issue page

    Note: My project is using the scrum template of the greenhopper plugin.