Aha! Roadmaps | Sync sprints with Azure DevOps
The Aha! Roadmaps Azure DevOps integration gives you insight into the progress of your releases once you send them over to your engineering team. Typically, though, there is another level of detail. The engineering team breaks out the release-level iteration into child sprints in Azure DevOps and assigns features (or epics) to them.
You can track the progress of your features and epics at the sprint level by creating a custom field in Aha! Roadmaps and mapping it to the appropriate iteration level in Azure DevOps.
If you choose to sync iterations as releases, all levels of iterations will display. This means that parent and children, including sprints, will show up as releases in Aha! Roadmaps. If you want to link individual Azure DevOps and Aha! Roadmaps record types to each other, you maybe interested in creating record links.
Click any of the following links to skip ahead:
Create a custom sprint field
To do this, you will need two things. First, create an integration with Azure DevOps. This is a workspace-level integration, so you will need to be an owner of your product or workspace to create or edit the integration.
Second, you will need to create a custom field to map to the Azure DevOps sprint field. You will need to be an administrator with customization privileges to create a new custom field and add it to a feature layout, though owners can apply a custom layout that includes the new custom field to features in their workspace.
Note: We recommend selecting an Editable choice list as your custom field, since that will allow the integration to choose from a list of existing choices or create a new one if necessary.
Sync sprints with mapped fields
Once you have a custom field created, and that field has been applied to the feature or epic layout that your workspace uses, you are ready to map it to an Azure DevOps field. You will need to have your Aha! releases mapped to an Azure DevOps iteration, so that features in those releases can display the Azure DevOps sprint from a child iteration level.
Navigate to Settings ⚙️ Workspace Integrations and click on the Azure DevOps integration you wish to use.
Click to the Mappings step.
Map Releases to Iteration.
Under Features, click Field mapping.
On the left, select your custom field.
On the right, select the Iteration level where you have sprints in your Azure DevOps environment. Usually, this is Iteration Level 3.
In the middle, you will notice that the sync arrows are now set to one-way, from Azure DevOps to Aha!
Click Save and continue.
Associate existing features with Azure DevOps sprints
If you have existing features in releases in Aha!, you can use your mapped fields to display the sprint from Azure DevOps. This can happen automatically if you have enabled Automatic sending and Automatic import in the Enable step of your Azure DevOps integration, but let's walk through it manually to show you the functionality.
Open the drawer for a feature.
Under Integrations in the Overview tab, click Send to Azure DevOps.
The feature will flow from Aha! to Azure DevOps, where it will be created as a task, epic, or feature, depending on how you configured the integration.
In Azure DevOps:
Open the new item.
Change the item's iteration path to include a child sprint.
The task is now associated with the Azure DevOps sprint, and back in Aha!, you will see your sprint custom field populated with the name of the Azure DevOps sprint.
Pull new features and sprints into Aha! Roadmaps
If you need to import new features from a sprint in Azure DevOps, the integration will also sync those features with their parent release.
In Azure DevOps:
Create a task.
Assign it to a given sprint.
When Aha! next imports data, Aha! Roadmaps will recognize that the feature is part of a child sprint in an existing release.