Difference between revisions of "Aha!"

From Hornbill
Jump to navigation Jump to search
(Created page with " <div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;"> __NOTOC__Home > Integration > [[Business Process Aut...")
 
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
This document can now be found at its new location in the [https://docs.hornbill.com/ibridge-packages/welcome Hornbill Document Library].
  
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
+
    [[file:hornbill-document-library.png|iBridge Package Reference|link=https://docs.hornbill.com/ibridge-packages/welcome]]
__NOTOC__[[Main Page|Home]] > [[Integration]] > [[Business Process Automation & Orchestration]] > [[Hornbill iBridge]] > Aha!
+
[[Category:HDOC]]
</div>
 
{|style="width: 100%"
 
|- valign="top"
 
|style="width:73%"|
 
[[File:Aha-logo.png|100px]]
 
<br>
 
==Introduction==
 
Aha! is a cloud-based roadmapping tool.
 
 
 
Create, update, and retrieve Ideas in Aha!.
 
 
 
Aha! is a [[Hornbill_iBridge#Premium_Integrations|Premium Integration]] [[File:Green_Dollar.png|12px|link=https://wiki.hornbill.com/index.php/Hornbill_iBridge#Premium_Integrations|Premium Integration]]
 
|style="width:5%"|
 
|
 
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 
 
 
== Related Articles ==
 
:* [[Hornbill iBridge]]
 
:* [[Hornbill_iBridge#Premium_Integrations|Premium Integrations]]
 
:* [[Hornbill_KeySafe|KeySafe]]
 
:* [[Integration Call]]
 
:* [[Business_Process_Designer|Business Process Designer]]
 
|}
 
 
 
==KeySafe Configuration==
 
[[File:Keysafe oauth2 aha.png|300px|right]]
 
In order to integrate with Aha!, you will first need to configure, and securely store the authentication credentials for the Aha! instance and Accounts you want to use with the Hornbill App.
 
 
 
Configure your '''Aha!''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''' in order to use the Aha! options.
 
 
 
In the admin console > System > Security > KeySafe
 
 
 
* Select on '''+''' and select '''oAuth 2.0 ''' option
 
* Give the Aha! KeySafe a Title (this is the name / identifier for the Aha! account as you will see it when using the Integration Call node in your business process)
 
* Optionally add a description
 
 
 
'''Configuration'''
 
 
 
:* '''Client Id''' - The Consumer Key from the connected app definition
 
:* '''Client Secret''' - The Consumer Secret from the connected app definition. Required unless the Require Secret for Web Server Flow setting is not enabled in the connected app definition.
 
:* '''oAuth Scope''' - Leave Blank
 
:* '''Authorise URL''' - The Application Authorize URL as supplied by Aha!
 
:* '''Access URL''' - The Application Access URL: '''https://yourinstancename.aha.io/oauth/token''' where '''yourinstancename''' should be replaced by your Aha! instance name
 
:* '''Response Type''' - Set this to '''code'''
 
:* '''Additional Params''' - Copy & paste this exact string to '''redirect_uri=https://admin.hornbill.com/oauthcallback.php'''
 
:* '''Grant Access''' - Set this to '''authorization_code'''
 
:* '''Refresh URL''' - Leave Blank
 
:* '''Refresh Grant Type''' - Leave Blank
 
:* '''Token''' - Leave Blank at this stage, it will be auto-populated later
 
:* '''API Endpoint''' - The Aha! API endpoint for your instance: '''https://yourinstancename.aha.io/api/v1''' where '''yourinstancename''' should be replaced by your Aha! instance name
 
 
 
* Select '''Create Key''' to save
 
* Select '''Connect'''
 
:* Login with your username and password and authorise the Hornbill App to use the Aha! account (ensure the user account has the appropriate rights to perform the Aha! actions).
 
:* When successful, this will auto-populate a valid oauth_token into the '''Token''' field
 
 
 
 
 
'''Managing Aha! Configurations'''
 
 
 
* Use KeySafe to create, store and enable integrations with multiple Aha! accounts for use in your business processes
 
* From the Keysafe List, select an Aha! account, and use the '''Trash Can''' to permanently delete it, or the '''Revoke Access''' option to remove access rights but retain the configuration and option to '''connect''' again later
 
:* Note, this will remove the rights of any existing Aha! Integration Calls in your business processes, which are using the now deleted Aha! Account, so you will need to edit your business processes accordingly.
 
 
 
==Business Process==
 
===Options (Methods)===
 
Once you have your Aha! Account Authorised, you're all set to use it with the '''[[Integration Call]]''' in your business processes. The following options are now available for you to use with Aha!:
 
 
 
* '''Create''' : Create new Ideas against products in your Aha! roadmap
 
* '''Get''' : Get details from Ideas against your Aha! products
 
* '''Update''' : Update Ideas in your Aha! products
 
 
 
Read more about using the '''[[Integration Call]]''' from the Related Articles section, and learn how to work with input and output parameters for each of the Aha! options.
 
 
[[Category:Integration]]
 

Latest revision as of 18:05, 10 April 2024

This document can now be found at its new location in the Hornbill Document Library.

   iBridge Package Reference