In larger organizations it's unlikely that product managers and others who are setting up the integration with JIRA will also have JIRA admin privileges. If you configure the integration without an admin account you will get the following error:
"You do not have the JIRA Administrator permission required to perform this action"
This article explains how to integrate even if you are not an admin.
The administrator privilege in JIRA is required to create a new custom field called "Aha! Reference". If a JIRA administrator manually creates the field first, then the Aha! user can get by with fewer privileges during the integration installation. Since custom fields are global in JIRA, the administrator only needs to create this once.
The JIRA administrator should follow these instructions:
- Create a new custom field in your JIRA instance.
- The custom field must be a URL type and be named exactly "Aha! Reference" Aha! will use this field to store the link back to the related feature for each issue.
- The field should be added to the default screen.
Now, when a product owner creates an integration in Aha!, Aha! will recognize this field when clicking "Load project data" and won’t try (and fail) to recreate it.
Please note that if creation of JIRA FixVersions is limited to JIRA administrators only, you will also need to ensure your Aha! integration does not try to send releases. In your integration, select "Don't send releases" in this case.