Aha! Roadmaps is designed to help teams manage all their day-to-day activities. When thinking about integrating Aha! Roadmaps and Jira, the recommendation is that Aha! Roadmaps comes first in the process. You plan features and releases in Aha! Roadmaps and then send the planned work to your development team in Jira. The integration keeps the data in both systems in sync.
With the Aha! Roadmaps integration with Jira, teams in Aha! Roadmaps are able to take their planning a step further and sync sprints between Aha! Roadmaps and Jira. This is great for teams practicing scrum that wish to visualize what overall release a feature will be delivered in as well as which sprint the feature will actually be developed in.
How it works
The integration with the Jira sprint fields allows Aha! Roadmaps users to map a custom field in Aha! Roadmaps to sprint fields in Jira. To configure the integration mapping, follow these steps:
Create a custom field to capture sprint information in Aha! Roadmaps using a tags field or editable choice list. You will need to be an Aha! Roadmaps account administrator with customization permissions to perform this step.
Go to Settings → Workspace and edit your integration configuration. You will need to be a workspace owner to perform this step.
On the Select Jira project page, you will need to select a Jira board you wish to map to. This will be the board that sprints created in Aha! Roadmaps and sent to Jira will be created in.
Sprints from other boards within Jira can still sync to Aha! Roadmaps from Jira.
With the board selected, update your integration field mappings to link the new custom sprint field with either the Sprint or the Active sprint fields in Jira. If you are updating an existing integration, you will also want to use the Update records functionality to sync the sprint information into Aha! Roadmaps after completing the field mapping.
The integration can be configured as a two-way field mapping, where changes to the sprint in Jira will sync back to Aha! Roadmaps and changes to the sprint in Aha! Roadmaps will sync back to Jira.
If your development team controls which sprint a feature is in, we recommend you set the field mapping to be a one-way, Jira-to-Aha!-Roadmaps mapping to prevent any accidents happening where someone in Aha! Roadmaps changes the sprint value.
If the field mapping is set to be two way, entering the name of a sprint in Aha! Roadmaps that does not exist in Jira will result in a new sprint being created on the Jira board that you connect to through your integration configuration. Similarly, if a sprint name is entered in Aha! Roadmaps and a sprint already exists with that name, the record will be placed into the existing sprint instead of creating a new sprint with a duplicate name.