All eazyBI for Jira eazyBI for Confluence Private eazyBI

Jira Software custom fields
eazyBI for Jira

Jira Software custom fields import

If you use Software projects in Jira then the following additional custom field types are available in the Jira import custom fields selection:

Epic Link custom field import creates additional Epic Link dimension where all the epics having at least one linked issue imported into this account are listedEpic Link dimension can be used to get totals of issues or story points per selected epics, data from sub-tasks are not included in those totals then.

In addition, in the Issue dimension, Epic hierarchy is created (you can import Epic Link only as a property, the hierarchy still will be build). Using this hierarchy, totals of issues per selected epic, including from the issue sub-tasks, are calculated in the report.

Importing Epic Link as a property, three issue properties are created:

  1. Issue Epic Link: issue epic link key.
  2. Issue Epic Name: for epic issues, the issue Epic Name. 
  3. Issue Epic Status: for epic issues, the issue Epic Status.

Epic Name

This field is hidden from the custom field list.

Epic name is a field only for epic issues and it is automatically imported as issue property "Issue Epic Name" when custom field "Epic Link" is selected for data import.

However, you may import Epic Name also as a separate dimension using advanced settings. Please follow the instructions here on how to add advanced settings. When settings are in place, import data (the field will be hidden from the custom field list, therefore is no need to select it separately).

Flagged

Issue Flag is available for import as a property and a dimension. The value Impediment is used for flagged issues and (none) for not-flagged issues. You can also import changes to this field to track when the issues were flagged.

Rank

Rank could be imported only as property, to show the issue current rank in the backlog.

Sprint

Sprint dimension contains sprints grouped by boards (default hierarchy) or by Sprint status (Status hierarchy). When Sprint is imported as a dimension, a set of measures is created to analyze sprint scope (based on Story Points if imported or issue counts). Using eazyBI standard measures with Sprint dimension, take into account how they are counted to the sprints!

Properties Issue Sprint and Issue Sprint Status show a name and a status of issue current sprint. An issue always has only one current sprint and it could be one of the following:

  • Sprint from the Jira field "Active sprint" (the ongoing sprint the issue is added to),
  • Sprint in which the issue was resolved (resolution date within the sprint); usually, the last from the "Completed sprints" field.
  • (none) for issues that were not resolved (set resolution date) in neither of "Completed sprints" and currently are not included in any active or future sprints.

Property Issue Sprints show a comma-separated list of Sprint names that are assigned to an issue field "Sprint" in Jira.

There is an option to create custom hierarchies in the Sprint dimension with the Add custom hierarchy. It is possible to create a hierarchy based on custom Sprint properties imported with additional data import.

Story Points

Story points assigned to the issue, imported as a measure, also value change information could be imported. As a result, a set of measures are created based on Story points information, as well as in a combination with Sprint information.

Story points estimated

Story points assigned to the issue in the team-managed project, imported as a measure, also value change information could be imported. As a result, a set of measures are created based on Story points information, as well as in a combination with Sprint information.

This option is available and marked when the team-managed project is detected in the project list.

Story Points total measures 

When Story Points are imported as a measure, a set of total measures are created, similarly to other numeric custom fields.

Story Points created

Story Points resolved

Story Points due

Total story points from all created issues, resolved issues, or unresolved issues; see measure description Jira Core measures and dimensions.

Those measures are based on the current issue story point value and could be used to analyze data by issue current statuses, priorities, projects, etc.

You can also break down those metrics by Sprints but take into account that all those values would be counted by the issue current sprint, thus, recommended to use only for data analyze in ongoing (active) sprints or for resolved issues only. For Story points analyze in completed sprints, consider using sprint scope measures.

Issues with Story points created

Issues with Story Points resolved 

Issues with Story Points due

Hidden measures that could be used in the calculated measures.

Total count of created, resolved, or unresolved issues that have value for Story Points: 

Story Points with due date

Total story points from issues with a due date in the selected period.  This measure is also based on the current issue story point value.

Story Points closed

Total story points from closed issues. This measure is also based on the current issue story point value.

Story Points history

Historical total of Story Points of issues in the selected sprint. Used with Time dimension, shows the number of Story points at the end of a selected time period.

This measure is based on issue change history.

Story Points change

Story points increased or decreased compared to the previous period. It is calculated as a sum of hidden measures Story Points added and Story Points removed.

This measure is based on issue change history.

Story Points added

Hidden measure that could be used in the calculated measures.

Total of story points increased for all recorded activities (sprint status change, status transition, change of assignee, etc.) during the selected period. It is recommended to use this measure together with other dimensions that would describe the activity.

This measure is based on issue change history.

Story Points removed

Hidden measure that could be used in the calculated measures.

Total of story points decreased for all recorded activities (sprint status change, status transition, change of assignee, etc.) during the selected period. It is recommended to use this measure together with other dimensions that would describe the activity.

This measure is based on issue change history.

Sprint scope measures

Importing Sprint as a dimension, the additional set of measures designed for Sprint scope analysis are created (find them in Analyze tab, Measures / Predefined / Software). To get the complete set of sprint scope change measures, you must import Issue change history. Also, if your Sprint scope is evaluated in story points, then import Story Points custom field as a measure with value changes. 

Sprint scope measures are based on issues changelog information about sprint changes. In Jira, sub-task issues do not have such information; sub-tasks are always counted by their parent issue's last sprint.

To avoid misleading data, exclude sub-task issues from sprint scope reports at all (e.g., add, in the report, filter by "Issue type" dimension standard issue types).

Sprint start date

Sprint start date reflects planned start date of the sprint, and actual start date for completed and started sprints (on eazyBI Jira Cloud app)
As soon as the sprint starts in Jira Cloud, the sprint attribute "start date" is rewritten with the actual start date. Therefore, the property "Sprint start date" in eazyBI returns the actual start date if sprint is started or already completed. Don't be surprised if property Sprint start date matches the property Sprint actual start date.

Sprint end date

Sprint end date reflects planned end date of the sprint.

Sprint actual start date

Sprint actual start date reflects date and time when sprint was activated. Sprint measures representing committed scope takes into accounts this date.

Sprint actual end date

Sprint actual end date reflects date and time when sprint was completed.

Sprint goal

Sprint goal is a sprint property and would be displayed in reports only for sprint-level members from the Sprint dimension. Sprint goal changes for active and ongoing sprints will be imported during incremental import. Sprint goal for completed sprints would require full data reimport on the data cube.

Sprint closed?

Sprint property that shows 'No' if a sprint is open and 'Yes' if closed.

Time within Sprint

Measure that shows if the selected time period is within a sprint time period (from the sprint actual start date to the planned sprint end date or today if sprint was not completed in time for active sprint, or till actual end date for completed sprints). Measure shows value 1 if the current Time dimension period (typically, days on rows) is within a selected Sprint (typically on pages). This measure can be used to filter dates just for the selected sprint in burn-down and burn-up charts.

Last closed sprint by board

Measure ranks all closed sprints by their start date within a board. The measure shows value 1 for the latest sprint that has been closed and then increases to the older closed sprints. You can use the measure and set how many closed sprints of the board you would like to see in a report.

Sprint Story Points committed

Total of Story Points from issues assigned to a selected sprint at the time when the sprint was started. Story points are counted from issues, whether there were completed or not at the start of the sprint. Actions happened after the sprint was started (issues added, removed, story point changes etc) are not taken into account when the committed points are calculated.

Sprint Story Points added

Total of Story Points for issues that have been moved to (added) or from (removed) a selected sprint while the sprint was active. eazyBI captures the story point value at the moment of movement.

Measure can be used with the Time dimension at the Day level to see sprint scope changes.

Sprint Story Points removed

Sprint Story Points change

Total of Story Points changed for issues in a selected sprint while the sprint was active. Can be used with the Time dimension.

Sprint Story Points at closing

Total of Story Points from sprint issues at the moment when the sprint was closed.

Sprint Story Points completed

Total of Story Points from sprint issues that were completed when the sprint was closed.

Issue story points are treated as completed if the issue was in one of the status category Done statuses at sprint completion moment. The board configuration (a column mapping to statuses) is not taken into account for this measure.

Sprint Story Points completed of committed

Total of story points from sprint issues that were committed when the sprint started and completed at the moment when the sprint was closed. eazyBI captures the story point value at the moment of Sprint completion. See also definitions for measures "Sprint Story Points committed" and "Sprint Story Points completed".

Sprint Story Points completed of added

Total of story points from sprint issues there were added to sprint while sprint was active and completed at the moment when the sprint was closed. eazyBI captures the story point value at the moment of Sprint completion. See also definitions for measures "Sprint Story Points committed" and "Sprint Story Points completed".

Sprint Story Points committed completion %

The percentage is calculated as sprint story points completed of committed divided by sprints story points committed. This shows how many planned story points are actually done at the end of the sprint.

Sprint Story Points not completed

Total of Story Points from issues that were in the sprint, when the sprint was closed, and which were not completed.

Sprint Story Points commitment changes 

Difference between the total of Story Points at the end of a sprint and Story Points at the start of the Sprint.

Sprint Story Points remaining

Shows remaining Story points for the selected Sprint. For completed Sprints, will return the number of Story Points not completed within the Sprint.

Sprint Story Points remaining measure is available on Cloud and from eazyBI version 6.6.

Sprint issues committed

Count of issues assigned to a selected sprint at the moment when the sprint was started. 

Sprint issues added

Count of issues that have been moved to or from a selected sprint while the sprint was active. It can be used with the Time dimension.

Sprint issues removed

Sprint issues at closing 

Count of sprint issues at the moment when the sprint was closed.

Sprint issues completed

Count of sprint completed issues at the moment when the sprint was closed. The issue is treated as completed if it was in one of the status category Done statuses at the sprint completion moment. The board configuration (a column mapping to statuses) is not taken into account for this measure.

Sprint issues completed of committed

Count of sprint issues there were committed when the sprint started and completed at the moment when the sprint was closed. See also definitions for measures "Sprint issues committed" and "Sprint issues completed".

Sprint issues completed of added

Count of sprint issues there were added to sprint while sprint was active and completed at the moment when the sprint was closed. See also definitions for measures "Sprint issues added" and "Sprint issues completed".

Sprint issues not completed

Count of not completed sprint issues at the moment when the sprint was completed.

Sprint remaining estimated hours added

Total of remaining estimated hours for all issues that have been added to/removed from (at any moment) the selected sprint. The remaining estimated hours are captured at the moment when the issue was added to/removed from the sprint.

Sprint remaining estimated hours removed

Cumulative Story Points resolved

Cumulative sum by Time dimension of Story Points resolved. Used with the Time dimension Day level, it shows up the burn-up of resolved story points.

Story Points remaining

The remaining story points by the Time dimension are calculated as the total Story Points scope (Story Points history measure) minus Cumulative Story Points resolved measure. Used with Time dimension, shows remaining Story points at the end of a selected time period.

Use measure Sprint Story Points remaining to view Story Points from not completed issues at the end of Sprint.

Linear trend Story Points remaining

Shows a trend for remaining story points using default calculation Add standard calculations - Linear trend

Sprint Story Points guideline

Sprint Story Points guideline shows ideal Story Points resolution guidelines in working days for a selected sprint. It can be used with the Time dimension at the Day level.

Running Story Points velocity for 5 closed sprints

 Calculates the average of resolved Story Points for the current sprint and 4 previous closed sprints of the same board.

 

Last closed sprints by boards 

Ranks all closed sprint by their start date descendingly within the same board. Use the measure as a filter in a report to specify how many latest closed sprints of the board you would like to see in a report. 

All Closed Sprints

Calculated member in the Sprint dimension. It aggregates all closed sprints across all boards ordered by sprint start dates.

Measures for team-managed projects

When you have team-managed projects, make sure to select field Story points estimate for data import. During data import, eazyBI will create a set of story points total and Sprint scope measures.

When Story points estimate are imported as a measure, a set of total measures are created, similar to other numeric custom fields. Those measures are available in the predefined measurement section Agile (team-managed). Note there is still section Agile that holds common metrics and properties for team-managed and other projects, like Sprint properties and measures related to issue count.

Story points estimate created, Story points estimate resolved, Story points estimate due to get total story points from, respectively, all issues, resolved issues or unresolved issues. Story points estimate with due date counts story points from issues with a due date. All those measures are based on the current issue story point value and could be used to analyze data by issue current statuses, priorities, projects, etc. You can also break down those metrics by Sprints but take into account that all those values would be counted by the issue current sprint.

In addition, you may import the following Story point estimate measures:

Story points estimate closed

If closing statuses are defined in the account, then Story points estimate closed measure is also created to get total story points from closed issues. This measure represents the current issue story point value and could be used to analyze data by issue current statuses, priorities, projects, etc.

Make sure to select the closing statuses of all selected team-managed projects.

Story points estimate changes

Story point estimate value change (increased or decreased value compared to the previous period) in the selected Time dimension period.

Make sure to select value change for field Story point estimate in import options to get this measure.

Story point estimate history

Historical total of Story point estimate of issues in the selected sprint. Used with Time dimension, shows the number of Story point estimate at the end of a selected time period.

Make sure to select value change for field Story point estimate in import options to get this measure.

Cumulative Story point estimate resolved

Cumulative sum by Time dimension of Story point estimate resolved. Used with the Time dimension Day level, it shows up the burn-up of resolved story points.

Story point estimate remaining

The remaining story points by the Time dimension are calculated as the total Story point estimate scope (Story point estimate history measure) minus Cumulative Story point estimate resolved measure. Used with Time dimension, shows remaining Story points at the end of a selected time period.

For sprint scope analysis, use specifically designed measures in the table below:

Sprint Story point estimate committed

Total of Story point estimate from issues assigned to a selected sprint at the time when the sprint was started. Story points are counted from issues, whether there were completed or not at the start of the sprint. Actions that happened after the sprint was started (issues added, removed, story point changes, etc) are not taken into account when the committed points are calculated.

The measure is calculated only in a single sprint level; for totals, a calculated measure should be created.

Sprint Story point estimate added

Total of Story point estimate for issues that have been moved to (added) or from (removed) a selected sprint while the sprint was active. It can be used with the Time dimension at the Day level to see sprint scope changes. 

Sprint Story point estimate removed

Sprint Story point estimate change

Total of Story point estimate changed for issues in a selected sprint while the sprint was active. It can be used with the Time dimension.

Sprint Story point estimate at closing

Total of Story point estimate from sprint issues at the moment when the sprint was closed.

Sprint Story point estimate completed

Total of Story point estimate from sprint issues that were completed when the sprint was closed.

Issue story points are treated as completed if the issue was in one of the status category Done statuses at sprint completion moment. The board configuration (a column mapping to statuses) is not taken into account for this measure.

Sprint Story point estimate not completed

Total of Story point estimate from issues that were in the sprint, when the sprint was closed, and which were not completed.

Sprint Story point estimate commitment changes

Difference between the total of Story point estimate at the end of a sprint and Story point estimate at the start of the Sprint.

Sprint Story point estimate remaining trend

Shows a trend for remaining story points. Used with the Time dimension Day level, it shows the burn-down trend.

Sprint Story point estimate guideline

Shows ideal Story point estimate resolution guidelines in working days for a selected sprint. It can be used with the Time dimension at the Day level.

Running Story point estimate velocity for 5 closed sprints

Calculates the average of resolved Story point estimate for the current sprint and 4 previous closed Sprints within the same board.

Other measures used with Sprints

Besides specifically designed Sprint scope measures, you may use other eazyBI measures together with Sprint. Then consider the behavior of the measures when they are used in the report (or in calculated measures) together with Sprint dimension:

  • almost all basic (non-historical) measures count issues against the issue current sprint (see how the issue current sprint is detected in custom field Sprint description). 
  • all historical measures (transitions) takes into account both, status and sprint historical values for the issue at the selected time period.

In the following table, there is a more detailed description of how the most popular metrics work with the Sprint dimension. 

Issues created, Issues due, Issues closed, Issues resolved

<Custom field> created / due / closed / resolved

Measures Issues created (and all similar) shows how many issues (all, unresolved, closed accordingly to the measure) are currently assigned to the sprint. The same is true for total values from numerical custom measures: they calculate the totals from issues currently assigned to the sprint.

If the sprint has been completed, then only issues resolved during that sprint would still be counted to the sprint. And vice versa: if the issue was not resolved during the sprint, even if it was in that sprint, it won't be counted against.

Original estimated hours

Original estimated hours are counted only against the issue's current sprint.

Hours spent

Hours spent show logged hours during a selected sprint.

Hours should be logged in the following period of a sprint to consider them as logged during the sprint (exact date and time is taken into account):

  • from the date when the issue was added to the sprint;
  • to the date when the issue was removed from sprint, or sprint completion date (if the issue was not resolved during the sprint); for issues resolved during the sprint, all hours logged after the sprint is closed also are counted.

eazyBI looks for issue work log entries with "Date started" within the described time period and then sums up all time spent from those work logs.

For subtasks, the time period is calculated based on their parent issue data.

Issues history

<Custom field> history

Issue history counts issues assigned to a sprint at the end of the selected time period. <Custom field> history counts a total of the custom field value from the sprint issues at the end of the selected time period.

Those measures use issue change history data.

Additional Sprint dimensions

The following additional hidden dimensions are created when Sprint and Issue change history is imported. They are used in calculated measure formulas to track count of issues and totals of Story Points when a sprint status is changed.

Sprint Status
(hidden)

Sprint Status dimension with values:

(none)Backlog
FuturePlanned future sprint
ActiveActive sprint
ClosedClosed sprint

Issue Sprint Status Change
(hidden)

Shows Issue and Sprint status transitions:

(none) => FutureAn issue was added to a future sprint
(none) => ActiveAn issue was added to an active sprint
Future => (none)An issue was removed from a future sprint
Active => (none)An issue was removed from an active sprint
Future => ActiveA sprint was started and an issue was committed to it
Active => ClosedAn issue was in a sprint when it was closed
Closed => (none)An issue was moved to the backlog after a sprint was closed

Sprint Incoming State
(hidden)

Shows how the issue was added to an Active sprint and keeps this state while in the active sprint.

(none)An issue is not in an active sprint
CommittedAn issue was committed in a sprint
AddedAn issue was added to already active sprint

Sample reports

If you selected the Import sample reports option, then additional sample reports are created in the Samples Jira Software folder. Please try these reports to see which measures would be useful for your specific needs. If you would like to customize some reports then save them and change the name (as the default sample reports are overwritten during each Jira import). You may read step-by-step descriptions of how those reports are built: Samples Jira Software