Versions Compared

Key

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

...

Setting

Description

Gadget Title

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

Data

Choose the board or the Jira issue filter containing the issues for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check Include the sub-tasks if you want the sub-tasks from the selected board or filter to be included in the calculation.

Split range criteria

Choose how to define the segmented columns (bins). If you choose Attempt to split in ? equal intervals, the gadget will try to divide the range in equal intervals, although it is not always possible to split in the number of intervals that you specified. So the number that you enter is actually a "desired" number. If you choose Split by using these custom thresholds, the range will be divided according to the entered thresholds. In this case, you must manually introduce the thresholds separated by a comma (for example: 100, 200, 300, 400, 500).

Cycle starts

Indicates what to consider as the start event of a cycle.

You can choose between:

  • When the issue was created

  • When the issue entered a status that has category "New" - the cycle starts when the issue is transitioned to any workflow status of category "New". This includes those gray-colored statuses from Jira, like New, Backlog or To Do.

  • When the issue entered a status that has category "In Progress" - the cycle starts when the issue is transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like In Work, In Progress or In Testing.

  • When the issue entered this status - cycle started starts when the issue was transitioned to the specified workflow status.

Choose also how to handle the case when there are multiple transitions to the start status or to the status category by setting If multiple entries in the start status, consider the ? entry to first or last. See the example below.

Example
You configured the gadget to start the cycle When the issue entered a status that has category "In Progress" and to end the cycle When the issue entered a status that has category "Done" and there was a Jira issue that had multiple entries in the "In Progress" status before being moved to "Done". How should the cycle time be calculated, from the first or from the last transition in the "In Progress" status?

Workflow with multiple entries in In Progress status

If you set If multiple entries in the start status, consider the first entry, the cycle will start when the issue was transitioned to the "In Progress" status for the first time.

Cycle time starting from the first transition to In Progress

If you set If multiple entries in the start status, consider the last entry, the cycle will start when the issue was transitioned to the "In Progress" status for the last time.

Cycle time starting from the last transition to In Progress

Cycle ends

Indicates what to consider as the end event of a cycle.

You can choose between:

  • When the issue entered a status that has category "Done" - the cycle ends when the issue was transitioned to any workflow status of category "Done". This includes those green-colored statuses from Jira, like Done, Resolved or Closed.

  • When the issue entered a status that has category "In Progress" - the cycle ends when the issue was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like In Work, In Progress or In Testing.

  • When the issue entered this status - the cycle ends when the issue was transitioned to the specified workflow status.

You can also choose how to handle the case when there are multiple transitions to the end status by setting If multiple entries in the end status, consider the ? entry to first or last. See the example below.

Example
You configured the gadget to start the cycle When the issue entered a status that has category "New" and to end the cycle When the issue entered a status that has category "Done" and there is a Jira issue that had multiple entries in the "Done". How should the cycle time be calculated, till the first or till the last transition in the "Done" status?

Workflow with multiple entries in the Done status

If you set If multiple entries in the end status, consider the first entry, the cycle will end when the issue was transitioned in the "Done" status for the first time.

Cycle time ending in the first transition to Done

If you set If multiple entries in the end status, consider the last entry, the cycle will end when the issue was transitioned in the "Done" status for the last time.

Cycle time ending in the last transition to Done

Multiple cycles

Decide how the gadget should handle those Jira issues that have multiple cycles. This situation occurs if the issue was transitioned multiple times through the start and the finish statuses of the cycle.

Example
You configured the gadget to start the cycle When the issue entered a status that has category "In Progress" and to end the cycle When the issue entered a status that has category "Done" and there was a Jira issue that was moved from "In Progress" to "Done" multiple times, so it had multiple cycles. What cycle do you want to be displayed?

An issue with multiple cycles

You can choose between:

  • Display all cycles - all the cycles will be displayed with their own dot in the plotting chart and their own entry in the data table.

  • Display only the first cycle - only the first cycle of the issue will be displayed, with all the others being ignored

  • Display only the last cycle - only the last cycle of the issue will be displayed, with all the others being ignored

  • Display as one cycle from the start time of the first cycle to the finish time of the last cycle - a single cycle will be displayed, having as the start time the moment when the first cycle started and as the finish time the moment when the last cycle ended. See the picture below.

An issue with a cumulative cycle.

Time interval:

Specify the time interval for which to display data. You can specify a fixed time interval or a number of days back relative to the current date, with the current day being included.

...