Aha! to OnePlan Integration - Integration Setup

  • Updated

How to Use OnePlan with Aha! 

This integration focuses on synchronizing data between OnePlan and Aha!.  Initiatives and Workspaces in Aha! can be imported into OnePlan as plan level items, whereas Epics and Features can be brought into OnePlans’ Work Plan – Backlogs section as items. Epics can also be imported as plans in OnePlan.

Integration Setup

OnePlan Setup - Create an Authentication Key

Create an authentication key for this integration in OnePlan. For the steps to create a key, see How to Create and Rotate Authentication Keys in OnePlan. When you create the key, select the following settings:

Global Scopes — None required. Leave OData and Backup cleared.

Data Type Permissions
Configuration Read, Update
Plans Read, Create, Update
Workplan All (Read, Create, Update, Delete)
Resources Read, Create
Resource Plans Read
Financials Read
Integrations All (Read, Create, Update, Delete)

Note: Selecting Update or Delete also selects Read. The Integrations permissions allow OneConnect to add and remove the integration in OnePlan when it is installed or uninstalled. Grant only the permissions listed so the key has the minimum access the integration needs.

After you create the key, save the OnePlan group name and the authentication key in a secure location. You enter both in OneConnect during setup. The key cannot be viewed again after you leave the page.

Note: It is recommended to generate a new authentication key for every integration and to give each key a descriptive name that identifies its integration. This practice enhances security, simplifies management, and makes tracking and troubleshooting easier.

OneConnect Setup Process

To complete the OneConnect setup, you need to have Administrator or Editor privileges in the OneConnect group you wish to set the integration up in.

  1. Go to https://my.oneconnect.ai (or https://eu.oneconnect.ai for European customers utilizing eu.oneplan.ai)
  2. Click on the Add Integration button.
  3. Navigate to Aha! to OnePlan.
  4. Click Configure.

    Select Aha integraion in OneConnect.png

OnePlan Connector

  1. Group Name
    • Input the name of the OnePlan Group name you intend to integrate with.
  2. Authentication Key
    • Paste the generated OnePlan Authentication Key obtained from OnePlan.
      Aha Integration OnePlan Section.png
  3. Additional Options
    • Expand the section for additional configuration options.
  4. (Optional) Alternate OnePlan Environment URL
  5. (Optional) OnePlan Default Plan Type
    • Specify a default plan type if the integration doesn't automatically provide a plan type for plan-level work items in OnePlan. Enter a single value for this purpose.
  6. Test Connection
    • Click Test to verify the correctness of the connection settings to OnePlan. 
    • A notification indicating Connected Successfully should appear in the top-right corner of the browser upon successful testing.
  7. Save Changes
    • After verifying the connection, click Save to retain the configured settings.

Aha! Section

  1. Aha! URL
  2. Aha! API Key
    • Enter the key to the organization that will be integrating into OnePlan. A single value should be entered.
      Aha Integration Aha Section.png
  3. Aha! Plan Entity Type(s) (Comma Separated)
    • Enter the type(s) of Aha! entities you would like to be brought in as Plans in OnePlan. Workspaces, Initiatives, and Epics are the only supported entities for Plans.
  4. Aha! Backlog Entity Type(s) (Comma Separated)
    • Enter the type(s) of Aha! entities you would like to be brought in as backlog level items in OnePlan. Epics and Features are the only supported entities for the Backlog. Aha Integraion Aha Advanced Settings.png
  5. Aha! Feature Template (Key)
    • Enter the key to a Feature in Aha!
  6. Aha! Epic Template (Key)
    • Enter the key to a Epic in Aha!
  7. Aha! Workspace Template (Key)
    • Enter the key to a Workspace in Aha!
  8. Aha! Initiative Template (Key)
    • Enter the key to a Initiative in Aha!

Note

All Template Keys will be used as their respective entity templates. If no Template Key is entered, no fields can be mapped.

Note

OnePlan recommends creating separate items of each entity that is to be brought into OnePlan in Aha! to use as your template keys.

Generate an Aha! API Key

  1. Log into Aha!.
  2. Go to Settings (gear icon in top right) > Personal.
  3. Click Developer (Left Column).
  4. Click Generate API key.
  5. Give the API key a Name.
  6. Click Generate API key in the pop-up window.

Locate Aha! Entity Keys 

Features and Epics

  1. Click on a feature/epic to open its details.
  2. At the top next to the title of feature/epic is the key.
    Aha Integration Keys for Entities 1.png
  3. The key can also be found in the board view above the name of the feature/epic.
    Aha Integration Keys for Entities 2.png

Initiatives

  1. Click on an Initiative.
  2. At the top above the name of the initiative is the key.
    Aha Integration Keys for Entities 3.png

Workspace

  1. Click on Setting > Personal.
  2. Click on Workspaces.
  3. To the left of the name of your workspaces in parentheses is the key.

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.