Kanban Velocity Gadget

Gadget Title

Choose what to display in the title bar of the gadget.

Data source

Select the type of Data Source used by the gadget:

• The agile Board of your team.

• A Saved filter representing the scope of your project. Make sure that the specified filter is shared with the users who will also visualize this gadget.

• A JQL query that returns the work items you want to be processed by the gadget.

Interval Start Date

Specify a date when one (or any) of the time intervals starts. This is only used by the gadget to determine when the time intervals should start (date alignment).

Intervals of

Specify the duration for the time intervals used when calculating and displaying the velocity. If you do Agile development, this should be set according to the length of your sprints or iterations.

Display the chart for the last ? intervals

Specify the number of previous completed time intervals to be displayed in the chart, starting from the most recent.

Include the current (incomplete) interval

Check this if you want the interval of the current day to be displayed. Please keep in mind that the current interval is incomplete and the calculation of the current velocity is impacted accordingly.

Calculate average velocity based on last ? intervals

Specify the number of time intervals to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these intervals.

Calculate by

Specify on which criteria the calculation is to be performed. You can choose between:

• Story Points - the default value; use this if the work items are estimated in Story Points. If the work items are from team-managed spaces, select Story Point Estimate instead.

• Original Time Estimate - use this if you use time estimates; the calculation will be done in hours.

• Work Item Count - use this if you want the calculation to be done by number of work items.

• Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the work items.

Count also the sub-tasks and their estimate

Check this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.

"Done" means

Specify how the gadget should consider work items as done when determining the work completed.

The default option is Work item status has the category done, which means that the work item is considered done if it has reached a “done” category status (such as Resolved, Closed, Done or any other green-colored status of Jira).

Choose Work item is in last column of the selected board and select an agile board if you want to consider work items as done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column.

Choose Work item is in one of these statuses, and then select one or more workflow statuses, to consider work items as done when they reach one of these custom statuses.

Choose Work item reached one of these statuses, and then select one or more workflow statuses, to consider as “Done” those work items that reached one of the specified statuses at least once.

Show legend

Check this if you want the chart legend to be displayed.

Tilted labels for x-axis

Check this option to avoid overlapping labels on the x-axis.

Display horizontal gridlines

Check this option if you want the chart to display gridlines for the vertical axis.

Show data tab

Check this option if you want a data table to be displayed along with the chart. The Data tab displays all the time intervals with the work items that affected their velocity. The work items that had zeros on all the columns are not displayed.

Open data tab first

Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab.

Show backlog forecast

Check this option if you want the gadget to display a tab with the current backlog (unresolved work items from the selected board) displayed along with their ETA determined automatically based on the current velocity. Before checking this option, ensure that your backlog is properly ranked, with the most urgent work items at the top of the list.

Refresh cached data at next display

This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent.

Refresh interval

Choose how often the gadget will refresh automatically.

Automatically assign colors

Check this if you want the chart to automatically assign colors for the series.

Custom colors

Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color.

You can also use the Copy and Import buttons to copy and import the color configuration to gadgets of the same type.