Note: To keep from overloading third-party APIs, changes to the text editor and mockups are delayed by at least five minutes, waiting for five minutes after the most recent change.

Note: This article refers to features. Depending on your workspace type, you may see “activities" in your workspace.

Aha! Roadmaps | Move records with Jira or Rally

Two-way integrations between Aha! Roadmaps and your development system keep engineering teams aligned with your team. When you send a record from Aha! Roadmaps to your development system, updates begin to flow back and forth as your latest improvement passes through each stage of development.

However, as your work evolves, you will likely need to move records. For example:

  • A user story may need to move from one development project to another.

  • An epic, feature, or requirement may need to move from one workspace to another.

  • Parent and child records may be sent to the development system before or after one another, then moved to a new project.

In this article, we will discuss the most common reasons you will need to move records, and how that affects two-way integrations between Aha! Roadmaps and your development system, and particularly epics, features, and requirements linked with Jira or Rally.

Click any of the following links to skip ahead:

Prerequisites

All of the following prerequisites must be met to move epics, features, and requirements between workspaces in Aha! Roadmaps or projects in your development system:

  • You must be using the same development system server for all projects.

  • You must have an integration set up on each workspace in Aha! Roadmaps for every project in your development system that may contain records which are linked.

  • You must be using the same integration template for each integration that you set up, and have it enabled on the record mappings step of each integration that you set up.

  • For Jira integrations, you must be using the same webhook for each integration.

  • You must be using Aha! Roadmaps integrations 2.0 with Jira or Rally.

Top

Move a linked Aha! Roadmaps record between development system projects

Scenario: A user moves a record in the development system which is linked to an Aha! Roadmaps record from one project to another.

Example: You have a workspace in Aha! Roadmaps called Workspace A. This workspace is integrated with Project 1 and Project 2 in your development system. Your team creates a feature in Aha! Roadmaps and sends the feature to Project 1. Your team starts grooming the feature. During the grooming, it is determined which team will work on the feature. The record is moved to Project 2 in the development system.

Resolution: The link between Aha! Roadmaps and the development system remains intact for this record and the mapping will adjust using the integrations that are set up for Workspace A.

Top

Move child records from the development system to a different development system project than their parent

Scenario: A user sends a parent record with child records from Aha! Roadmaps to the development system, then moves the child records to other projects.

Example: You have a workspace in Aha! Roadmaps called Workspace A. This workspace is integrated with Project 1 and Project 2 in your development system. Your team creates an epic with a handful of child features in Aha! Roadmaps and sends it to Project 1 to be groomed and assigned to a development team. The features are moved to Project 2 in the development system.

Resolution: The link between Aha! Roadmaps and the development system remains intact for these records and the mapping will adjust using the integrations that are set up for Workspace A.

Top

Move child records from Aha! Roadmaps to a different development system project than their parent

Scenario: A user sends a record to the development system and creates or moves child records to a different project

Example: You have a workspace in Aha! Roadmaps called Workspace A. This workspace is integrated with Project 1 and Project 2 in your development system. Your team creates a feature in Aha! Roadmaps and sends it to your development system. Your team then breaks out the work by adding or moving requirements to Project 2.

Resolution: These child records can be imported into Aha! Roadmaps, their links will stay intact, and the mappings will adjust to use the integrations that are set up for Workspace A.

Note: Aha! Roadmaps will automatically import child records if the Automatically import new records option is selected on the Settings ⚙️ → Workspace → Integrations → (Select an integration) → Enable step.

Top

Move an integrated Aha! Roadmaps record between workspaces

Scenario: A user moves an Aha! Roadmaps record which is integrated with your development system from one Aha! Roadmaps workspace to another.

Example: You have a workspace in Aha! Roadmaps called Workspace A. This workspace is integrated with Project 1 in your development system. Your team creates a feature in Aha! Roadmaps and sends it to your development system for grooming. During the grooming, it is determined that the feature needs to be moved to Workspace B. You move the record to Workspace B.

Resolution: The link between Aha! Roadmaps and the development system remains intact for this record and the mapping will adjust to use the integration that is set up for Workspace B.

Top

Send Aha! Roadmaps child records to the development system before sending the parent record

Scenario: A user sends child records to the development system, then at a later time, sends a parent record that is linked to the child records.

Example: You have a workspace in Aha! Roadmaps called Workspace A. This workspace is integrated with Project 1 in your development system. The team creates features in Aha! Roadmaps and sends them to the development system. After these features have been sent, you determine that the features actually align to an epic which has not yet been created. You create the epic in Aha! Roadmaps, link it to the features in Aha! Roadmaps, and then send the epic to the development system.

Resolution: The records in the development system will be updated to reflect the new parent record. If at any point the parent or child records are moved to a different project, the link between Aha! Roadmaps and the development system will remain intact and the mappings will adjust according to the integrations that are set up for Workspace A.

Top

If you get stuck, please reach out to our Customer Success team. Our team is made up entirely of product experts and responds fast.

Aha! Roadmaps
    Strategic roadmaps
    Integrations
      Aha! Ideas
      Aha! Develop
      Announcements
      © 2021 Aha! Labs Inc.All rights reserved