How to think about integrating Aha! with your development system

The majority of customers integrate Aha! with their development systems of choice. Aha! provides two-way integrations with a number of popular development systems, such as Jira, Rally, Visual Studio Team Services, and many more.

When considering an integration between Aha! and your development system, it is important to understand the intended workflow between the two systems.

Aha! is a planning tool. It is where product teams define strategy, organize their backlog, and prioritize work into releases to create their product roadmap. Development systems are for the execution of this work. They are where developers manage the task of implementing the planned features.

You plan before you work, and as such, Aha! is designed to come first in the process. Plan in Aha! and then utilize the integrations to send the planned work from Aha! to your development system for your team to build.

Integrations support the mapping of the following Aha! records to your integrated development system:

  • Initiatives
  • Master features
  • Features
  • Requirements
  • Releases

In addition to mapping the Aha! records to your development system, you also can determine how the fields within the records map to corresponding fields in your development system — including the direction of the mappings.

Once the work has been sent from Aha!, a two-way link is established, allowing updates on either end to flow back and forth. As part of the integration configuration, you have the option to specify if outgoing changes from Aha! send automatically or require review prior to approval.

The overall workflow allows your product team to work in Aha! and your development team to work in their tool of choice without requiring each team to go back and forth between systems.

How it works

First, you need to configure your integration. Each integration establishes a link between an Aha! product and a project space in your integrated system. You can also integrate a single Aha! product with the same system multiple times or integrate a single Aha! product with multiple different systems.

For details about configuration, refer to your system-specific support document by selecting it from our Integrations — Development 2.0 articles.

After you have an integration configured and enabled, you can send releases, master features, features, and requirements from Aha! to your integrated system. The option displays in each record, in the Send dropdown as shown below.

 

integration_send_menu.png

After you send the record from Aha! to your development system, the integration for that record becomes active, allowing changes to sync back and forth based on how you have the integration configured. You will notice an integration link appear on the record, making it clear in Aha! which records are integrated and which are not.

Future updates from Aha! to your development system can be handled in one of two ways.

  1. You can opt to have all changes post to the integration updates window where your Aha! users can review changes prior to committing them to your development system.
  2. Or you can automatically have changes in Aha! sent over, so that any time an integrated record changes, it automatically updates your development system.

Changes to integrated records coming from your development system into Aha! are handled separately. They are automatically imported as soon as the change happens. This is handled by adding an integration webhook in your development system.

Send_record_updates.png

In addition to sending outgoing changes and receiving updates to integrated records, you can import new records that originated in your development system. This occurs any time a record matching a type mapped through your integration is created in the development tool. The record will automatically populate as an import candidate on the Aha! side, where it can be reviewed and accepted for import.

import_integrated_records.png


Was this article helpful?
8 out of 8 found this helpful