Skip to main content
Skip table of contents

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.