Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

ow you can test out a new dashboard gadget powered by ActionableAgile! We plan to release many gadgets but have started with one - a Cycle Time Summary gadget.

...

Image Added

Table of Contents
minLevel2
maxLevel3
printablefalse

...

Understanding the Dashboard View

The Cycle Time Summary dashboard gadget provides a percentile based view of how long it took you to get work done in the past.

85% of items completed in the past 90 days took 14 days or less

...

How is this useful? The above assumption notwithstanding, you can expect a new work item you start to finish in 14 days or less 85% of the time. This expectation is something that Scrum and Kanban communities are beginning to call a Service Level Expectation or SLE. The SLE is intended as an internal facing measure that teams can use to measure and manage predictability.

Read more about cycle time and the SLE in our Cycle Time Scatterplot documentation.

Info

If you want to see the issues that were used for this calculation, click on the view issues link in the bottom-right corner of the gadget. It will open up an issue filter using the query created by the gadget and show you all the issues that match.

Adding the gadget to a dashboard

The dashboard gadget can be found in the “ Add a gadget” window that opens when you click on the

Status
titleadd gadget
button in the top right corner of your editable dashboard.

Find the listing named “ActionableAgile Cycle Time Summary” and click the

Status
titleadd gadget
button. You can continue to add gadgets. When you are ready to configure the gadget, click
Status
colourBlue
titleclose
to make the window go away.

Image Modified

Configuring the gadget

Once added, the gadget displays the configuration screen

Image Modified

The screen contains the following configurations:

Gadget Title

This will be the text that displays as the title of the Gadget. The default text is “ActionableAgile Cycle Time”.

Project, filter, and/or board

Choose the project, filter and/or board you want to grab data from.

Info

If you choose projects or boards it will use all completed work items. If you don’t want to exclude a subset of items, you will need to create a filter and use that instead.

Certainty

What percentile do you want the gadget to use to calculate the cycle time summary? The default is 85%.

Max completion age (in days)

How many days back should the gadget go to grab data for the calculation of cycle time? The default is 90 days.

Override done statuses

By default we consider work items done if the status they are in have a status category of completed. These workflow statuses matching this default query will be shown as selected.

However, you can edit the statuses the gadget uses to calculate cycle time. Why? Well, status categories are not always properly configured. Sometimes, you might want to calculate cycle time for a different part of the workflow - how long it takes to get items to Release Ready, for instance.

Remove selected statuses you no longer want by clicking on the x icon in the relevant status. To add additional statuses that signify completed work, click on the down arrow in the form field and select the desired workflow status.

Info

You may see statuses that aren’t relevant to your work items as we have to query for all workflow statuses in your Jira instance and their status categories.

Finished Configuring? You’ll see that the number of issues matching your query are shown in the bottom left. Once you are happy with your configuration, click

Status
colourBlue
titlesave
.

...

Info

You will want to make sure that your workflow statuses have status categories set. In this first release we are relying on the status category to denote when items have started, in progress, and are completed. We allow you to override done statuses and soon we’ll allow you to override statuses that are not started.

Understanding the Dashboard View

The Cycle Time Summary dashboard gadget provides a percentile based view of how long it took you to get work done in the past.

85% of items completed in the past 90 days took 14 days or less

Calculating your cycle time with a certain probability lets you communicate a probabilistic forecast for the future (assuming the future you’re forecasting for will roughly resemble the past you’re pulling the data from.)

How is this useful? The above assumption notwithstanding, you can expect a new work item you start to finish in 14 days or less 85% of the time. This expectation is something that Scrum and Kanban communities are beginning to call a Service Level Expectation or SLE. The SLE is intended as an internal facing measure that teams can use to measure and manage predictability.

Read more about cycle time and the SLE in our Cycle Time Scatterplot documentation.

Seeing Data for Issues Used in Calculation

There are two ways to see information about the issues used in the gadget’s calculations and you access them via the icons in the bottom right corner of the dashboard gadget.

Image Added

Viewing the list of Jira issues in the Issue Filter

Issue Filter IconImage Added

The first icon will open up a Jira Issue Navigator screen with the JQL query the gadget constructs based on your configurations. This allows you to see more information about what’s being included.

If you’d like to view this data in ActionableAgile, save the filter and then use the data loader to select the saved filter. As always, you’ll need to ensure that the workflow mapping you do in ActionableAgile matches what you configured for the gadget.

Note

Note that currently the filter is being set using a specific day. This makes it hard to continually use the saved filter in ActionableAgile. We will be updating this soon to use a relative date.

Downloading a CSV of the calculated start and end dates

CSV Download IconImage Added

If you click on the icon in the bottom right (a cloud with a down arrow), a CSV file will be dowloaded to your computer

The CSV will have just three columns:

  • Jira ID

  • Calculated Start Date: the date that an item entered the In Progress workflow status category

  • Calculated End Date: the date that an item entered one of the configured Finish stages

Note

We will be updating this CSV export soon so that you can upload it into ActionableAgile, but we focused on getting this out for troubleshooting purposes first.


Have Questions or Feedback?

Reach out to us via our support portal. We’re happy to help you through issues and hear your suggestions!