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 | 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 listed. Epic 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:
|
---|---|
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:
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 createdStory Points resolvedStory 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 createdIssues with Story Points resolvedIssues 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) |
---|---|
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):
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 | Sprint Status dimension with values:
| ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Issue Sprint Status Change | Shows Issue and Sprint status transitions:
| ||||||||||||||
Sprint Incoming State | Shows how the issue was added to an Active sprint and keeps this state while in the 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