Programs Custom Fields
Easy Agile Programs has two custom fields - Program and Program Increment - that can be used for reporting purposes.
From version 3.4.0, the custom fields are added to every issue scheduled into a Program. Previous versions only added the custom fields for Scrum boards.
These fields will be shown on the ‘View Issue’ screen once an issue is scheduled into a Program. These fields are not available on the ‘Create Issue’ screen as they are read-only. Please click here for instructions on how to add the fields to your screens.
JQL Search
JQL search can be used to identify issues that have been scheduled into a Program and/or Program Increment.
"Program Increment" = "Program Increment Name" to pull a list of all the issues that have been scheduled in that Program Increment
"Program" = "Program Name" to pull a list of all the issues that have been scheduled in that Program
You can also use the custom fields together for more targeted JQL searching, or where there may be multiple Program Increments with the same name i.e Q1 FY20.
"Program"= "Program Name" AND "Program Increment"= "Program Increment Name"
Reporting
The Programs custom fields can be used by your reporting tools for tracking and visibility.
If you’re using eazyBI, please refer to our integration guidelines here.
Adding custom fields to screens
In order to expose this information in the Issue View, the Program and Program Increment custom fields will need to be placed on the View Issue screen for the appropriate Projects.
Please note, you will require Jira Administrative permission to add the fields to your screens.
Server/Data Center
Select 'Issues' from the Jira Administration dropdown | |
Select 'Custom Fields' under the 'Fields' heading | |
Locate the Program and Program Increment custom fields from the list of custom fields. Click on the 'Actions' icon and select 'Screens' from the dropdown | |
Select the screens you want the Program/Program Increment custom fields to be associated to |
Cloud Company-Managed Projects
Select 'Issues' from the Jira Administration dropdown | |
Select ‘Custom Fields’ under the Fields heading | |
Search for the ‘Program’ and ‘Program Increment’ custom fields by Easy Agile from the list | |
Click on the ‘…' button for both the Program and Program Increment fields and select 'Associate to Screens’ from the dropdown | |
Check the ‘Select’ box next to all of the screens being referenced by the boards included in a Program. Click ‘Update’ to apply |
Cloud Team-Managed Projects
Go to ‘Project settings’ in the left hand navigation | |
Select ‘Issue types’ from the left hand navigation | |
Click on small ‘X apps’ link on right hand panel | |
Toggle on ‘Easy Agile Programs for Jira’ | |
Navigate back to ‘Issue types' and you will now see ‘Program’ and 'Program Increment’ in the right hand panel. Drag these two fields into your preferred position on the issue layout | |
Click ‘Save changes’ - you will now see the custom fields appear on the team-managed issue types when they have been scheduled in a program increment. |
FAQs
How do I set the Program & Program Increment custom fields so they’re displayed on my issues?
The Program and Program Increment custom fields must be present on the 'View Issue' screen for the Projects referenced in your Program. Please click here for instructions on how to add the fields to your screens.
These fields will be shown on the ‘View Issue’ screen once an issue is scheduled into a Program. These fields are not available on the ‘Create Issue’ screen as they are read-only.
Why are the Program & Program Increment custom fields only visible on some of my issues in a Program?
From version 3.4.0, the custom fields are added to every issue scheduled into a Program. Previous versions only added the custom fields for issues scheduled for Scrum teams.
Ask your Jira Admin to upgrade to the latest version to have the custom fields added at the feature level as well as all issues scheduled on the Team Planning board (Scrum or Kanban).
If you’re on the latest version and not seeing the custom fields on your Jira issues then you may need to add the fields as described above.
How do I utilise the Program & Program Increment custom fields with my reporting tool?
The Programs custom fields can be used by your reporting tools for tracking and visibility.
If you’re using eazyBI, please refer to our integration guidelines here.
If you’re using an alternative tool and would like a smoother experience please reach out to us.
I am using shared sprints across more than one Program and the custom fields aren’t working as expected.
We recommend that you don’t use the same ‘shared sprints’ across Programs as our custom fields will not work as intended. When an issue is put in a sprint that’s associated with a Program we set the custom fields “Program” and “Program Increment” on the issue for visibility and reporting. When the same sprints are used across multiple Programs, the custom fields will be added for one Program/Program Increment only.