Getting Started

Turning on the Extension

If the SpiraCapture icon doesn't appear at the top right of your screen, go to chrome://extensions to make sure the extension is enabled (check that the toggle in the bottom right of the extension card is lit up blue, if not click it to turn on the extension).

How to start capturing

To start capturing click the SpiraCapture icon in the toolbar, which should bring the SpiraCapture menu.

You should see a "Start capturing" button to capture the current tab. Note: this will only capture the current tab you are on! If you would like to capture other tabs repeat this step. Warning: if you have just enabled the extension, you need to refresh the tab before capturing will work.

You can tell if SpiraCapture is capturing the current tab, because the SpiraCapture icon in the toolbar will show in color. When it is not capturing a tab, the icon is shown in grayscale.

What event triggers data to be captured?

A number of events trigger SpiraCapture to capture how the user is interacting with the current browser tab:

Additionally, there are a few ways that data can be captured manually by the tester, by interacting with the SpiraCapture menu. These give users flexibility in organizing the captured data to reflect their test.

SpiraCapture Menu

Clicking the SpiraCapture icon from the browser toolbar will show the SpiraCapture menu. This gives you access to the main functionality of the extension.

View captured data

When you click the "View data" link from the SpiraCapture menu the tab that opens shows all data collected. This page is divided into three parts:

  1. The event list on the left hand side, which shows every event captured by SpiraCapture
  2. The preview window on the right hand side, which is used for showing more information about a particular event from the data list
  3. The action bar at the top of the page is where you can manage your captured data, or send selected events to Spira
  4. Additionally, there are popups to connect to Spira, view the events selected, and send select events to Spira as a new incident.

Each of these areas is explained in more detail below.

SpiraCapture's data page

The event list

The event list is shown on the left hand side of the page. Every event is shown in chronological order, broken down into testing steps (which can be manually created by the user and incremented automatically over time).

Each step has a heading which shows the name of the step and the time that particular step started. If the step contains any notes, a pin icon is shown in the step heading. This is designed to help you see which steps have notes in as these are likely the steps that you want to examine more closely. Clicking on the step heading will collapse or expand the events inside the step.

Each event shows certain standard information to make it easy to navigate and browse the data.

Each event also has a checkbox on its left. Checking the checkbox will mark that event as selected. Only selected events are sent through to Spira when logging new incidents.

The preview window

Clicking on an event with a screenshot will display in the large preview window on the right hand side of the page. This is helpful if you want to see a screenshot in more detail.

The action bar

The action bar has four buttons:

Sending selected events to Spira

You can send all selected events to Spira as a single new incident. Once connected to Spira, as explained below, you choose a product and then create your incident. The selected events, including their screenshots, will be saved into the description field of the new incident.

Connect to Spira

First, make sure you have enabled API access to Spira. You do this from your Profile Page from within the Spira application. Make sure you enable rss and generate an RSS Token. This RSS token is the same token you use for API access, which is what SpiraCaptures uses.

Note This can be disabled be you or your administrator make sure you have it enabled if you would like to use this feature see warnings section below

Clicking the Send selected events to Spira button will show a popup. The first time you see this popup you will need to enter your connection credentials:

Create the incident

Once you are logged in to your Spira (and have your events selected) the popup will require 3 fields to be selected/filled in.

Once these have been filled in, click the "Send data to Spira" button to connect to your Spira application and upload the incident. Once the incident has been created you will see a link next to the send button that will open the incident in Spira for you.

Potential Gotchas