Great Gadgets for Jira & Confluence
Breadcrumbs

Cumulative Flow Diagram (CFD) Gadget


Overview

This gadget displays the cumulative flow diagram (CFD) for the work items in an agile board or filter. It is a stacked area chart that shows the number of tasks in each column of the board or in each status category over time. When you view the data for a particular day, you will know how many work items were present in each column at the end of that day. You can choose to display the chart by Work Item Count, Story Points, Original Time Estimate, or any other numerical custom field.

The cumulative flow diagram is one of the most advanced analytics in Agile project management. Use this gadget to determine how stable your flow is and to understand where you need to focus on making your process more predictable. It gives you quantitative and qualitative insight into past and existing problems.

Cumulative Flow Diagram Chart Gadget.png

The gadget can be configured to display the chart as percentage of total:

Cumulative Flow Diagram Chart Gadget - percent of total.png

Depending on how it was configured, the chart displays multiple series (or "bands"):

Done - The total number of done work items. Depending on the gadget settings, "done" means all the work items with status category "done" (the green-colored statuses from Jira) or the items in the last column of the selected board.
In Progress - The total number of "In progress" work items. Depending on the gadget settings, "in progress" means all the work items with the status category "in progress" (the blue-colored statuses from Jira) or the work items in the middle column(s) of the selected board.
To Do - The total number of work items in "to do". Depending on the gadget settings, "To Do" means all the work items with the status category "To Do" (the gray-colored statuses from Jira) or the work items in the first column of the selected board.
Also, if so configured, the gadget can display bands that correspond to the columns of a selected agile board. In this case, the series names will be the same as the column names.

Configuration

The settings of this gadget are divided in multiple tabs:

  • Data tab - contains the required settings of the gadget, such as title or data source

  • More Settings tab - contains the optional settings

  • Colors tab - lets you customize the color of the lines displayed in the chart

Data tab

On this tab you can configure the required settings of the gadget.

CFD gadget configuration in Jira - data tab.png

Setting

Description

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 containing the work items that you want to track. 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.

Calculate by

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

  • Work Item Count - the default value; use this if you want the chart to be made by the number of work items.

  • Story Points - use this if you want the chart to be made by summing up the Story Points of the work items in each band. If the work items are from team-managed spaces, select Story Point Estimate instead.

  • Original Time Estimate - use this if you want the chart to be made by summing up the Original Time Estimate of the work items in each band; the values will be displayed in hours.

  • Other numerical custom field defined in your Jira instance.

Include the sub-tasks

Check this option if you want the sub-tasks from the selected board or filter to be included in the calculation.

Time interval

Represents the time interval displayed by the gadget.

You can choose from multiple options:

Custom dates - choose this option if you want to manually enter a Start date and an End date.

A number of days back - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day.

Dates of a project release - Choose this option if you want the gadget to use the start and end dates of an existing space release (added on the Releases page of a Jira space). Make sure the selected release has a Start date and End date set. Any subsequent changes to the release dates made on the space's Releases page will be automatically reflected in the gadget, without the need to reconfigure it.

Dates of a sprint - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you’ll need to select the board the sprint belongs to. If you choose the Latest sprint (auto), the date range will automatically match the most recent sprint. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it.

You can also check the Continue to display data after end date option in the More Settings tab if you want the chart to still display data even if the end date has passed.

Intervals of

Indicates the length of the intervals displayed on the horizontal axis.

Chart bands are based on

Specify by which criteria the bands displayed in the chart are determined. You can choose between:
The work item status categories - the default value. When using this option, the chart displays 3 bands:

  • Done - counts all the work items with the status category "done" (the green-colored statuses from Jira)

  • In progress - counts all the work items with the status category "in progress" (the blue-colored statuses from Jira)

  • New - counts all the work items with the status category "new" (the gray-colored statuses from Jira)

The work item statuses - when using this option, each workflow status that is mapped on the columns of the selected board has a corresponding band in the chart. If a filter is selected, the chart displays a band for each of the workflow statuses reached by the work items from the filter.

The columns of the selected board - when using this option, each column of the board has a corresponding band in the chart, displaying the number of work items in that column.
The category of the columns in the selected board - When using this option, the chart displays 3 bands:

  • Done - counts all the work items in the last column of the selected board.

  • In progress - counts all the work items in the middle column(s) of the selected board.

  • New - counts all the work items in the first column of the selected board.

The work item types - when using this option, each work item type has a corresponding band in the chart, displaying the number of work items with that type.

The values of this field - when using this option, each value of the specified has a corresponding band in the chart, displaying the number of work items having that value.

More Settings tab

On this tab you can configure the optional settings of the gadget.

CFD gadget configuration in Jira - more settings tab.png

Setting

Description

Show legend

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

Show as percentage of total

Check this option if you want the chart to display percentages of total instead of the calculated values.

Continue to display data after end date

Check this option if you want the chart to still display data even if the end date passed.

The vertical axis always starts at 0

Check this option if you want the vertical axis to always start at 0.

Exclude these bands

Check this option if you want to chart to exclude certain bands. Type the band names separated with a comma.

Display bands in this custom order

Check this option if you want the chart to display bands in a custom order. Type the band names separated with a comma. Bands that are not specified will be still be shown after the ones you added.

Hide weekends

Check this option if you want the chart not to show weekend days (Saturday and Sunday).

Display horizontal gridlines

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

Show the entire time interval

Check this option if you want the chart to display the entire time interval.

Enable scroll zoom

Check this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart.

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.

Colors tab

On this tab you can customize the color of the lines displayed in the chart.

CFD gadget configuration in Jira - colors tab.png

Setting

Description

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.

By default, only the common series are listed, but you can use the Add (+) button to add additional series to the table.

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


The following blog articles provide more information on how to use this gadget.