A program provides you with an aggregated view to track status and progress across multiple plans. Programs let you see how deliverables and releases align across work streams, and aggregate scope data into high-level scope tables and schedule views.
Programs and plans in Portfolio for JIRAare different in the sense that they display information at different levels of granularity.
Plans let you aggregate issues, teams, and releases to calculate your project schedules. The information contained in plans can be too granular when you just want to keep track of work that's across multiple teams.
Programs, on the other hand, give you high-level visibility of long-term initiatives that are spread across multiple plans and teams. By configuring your program to use information contained in a single or multiple plans, your program then provides an overview of how individual teams are tracking towards your initiatives.
A program has the following views:
- Schedule view, which is an aggregated schedule of the issues in the plans existing in the program
At this point in the beta phase, you can only view one plan and its issues at a time by switching between plans from the Plan drop-down menu.
- Scope view, which is a table of issues with data that's aggregated from the individual plans in the program
If you're the program-level manager in your team, programs can help you:
- Get visibility across multiple work streams, and efficiently monitor progress for high-level deliverables at a glance
- Use a single source of truth, from which you can share and communicate a clear picture of where work is at, and how well teams are on track for releases
- Effectively bridge the gap between your company's high-level strategies and the actual execution of your development teams
Caveats when using programs
See Creating and deleting programs for more details on how to use programs.
For a program to display aggregated data from plans, make sure all changes are committed across both JIRA and Portfolio for JIRA.
For a program to display information, it must have at least one plan added to it.
During the beta phase, the plans in your program must also contain initiatives, to make the program display information.
Currently, the permissions related to a program are based on the permissions related to the plans in the program.
Creating and adding plans to a program
When adding plans to a program, you can only add plans where you have the Portfolio for JIRA User permission.
Viewing a program
To view the data of the plans in a program, you'll need the Portfolio for JIRA Viewer permission. You can view the program itself, but if you don't have this permission for a certain plan, then you won't be able to see the data of that plan.
Deleting a program
To delete a program, you'll need the Portfolio for JIRA User permission for all the plans in that program. Note that the plans in the program won't be deleted from Portfolio for JIRA — these will just be removed from the program, and will no longer belong to any program.
How to enable and disable programs
To use the feature during its beta phase, a user with the JIRA administrators global permission will need to configure an additional setting in your JIRA instance. This additional setting is what is known as a dark feature key in JIRA.
You'll also need the following information:
- The URL of your JIRA instance
- The dark feature key for programs, which is:
- By enabling programs, the feature will be available to everyone using your JIRA instance.
- Enabling programs doesn't have any impact on any data in your JIRA projects, or even on your instance database. It just surfaces additional data, in the form of scheduling information in Portfolio for JIRA.
- Similarly, disabling programs just removes scheduling information from Portfolio for JIRA, and doesn't impact any data in your instance.
- You can safely enable and disable programs multiple times during the beta phase, as needed.
- Do not disable any of the other dark features. These are required by your JIRA instance.
To enable programs
- Log in to your JIRA instance with the JIRA administrators global permission.
- In the URL field of your browser, enter the following URL:
You will need to replace YOUR_JIRA_INSTANCE_URL with the URL of your JIRA instance itself. For example, if the URL of your JIRA Software instance is jira.atlassian.com, then you should enter this URL:
The 'Site Wide Dark Features' page will display.
- In the 'Enable dark feature' field, enter
- Click Add. The dark feature key for programs will be displayed in the 'Site Wide Dark Features' page.
To disable programs
In the 'Site Wide Dark Features' page, find
com.atlassian.portfolio.programView, and click Disable right next to it.