Jira field is not available in the integration mappings

A common question we receive about the Jira integration is, "Why is the _____ field not available to be mapped in the Jira integration?"

The answer is almost always because the field is not visible in the proper Jira Screens.

Screens in Jira define what fields are available when creating, editing, or viewing a Jira issue. Each of those actions can have a different screen assigned and therefore a field can be visible when viewing an issue but not actually be visible when creating or editing the issue.

This causes a problem (and a lot of confusion) because Aha! needs the field visible on Create and Edit to communicate through the API. However, you might assume that the field is visible because you can see it when you View the issue.

The Where is my field? option in Jira makes this easy to diagnose. This article will walk you through how to find your missing field when you Create and Edit an issue in Jira and how to confirm that the field is mappable in Aha! after you have enabled it.

Click any of the following links to skip ahead: 

Adjust the Create issue screen settings

  1. Log in as the same user you used to configure the Aha! > Jira integration.
  2. Click the button on the left side of your screen to Create an issue.
  3. Click the Configure fields dropdown menu, then click Where is my field?
    aha-jira-configure-fields-where-is-my-field-highlight.png
  4. Begin typing to find your field, then select it from the list of suggestions.
  5. The Where is my field? modal will show you information on your field. Scroll down to the Field Screen section to see information on your field's Screen settings and where to go to change the configuration.
    aha-jira-where-is-my-field-field-screen-detail-create-issue.png
  6. Follow the appropriate hyperlinks to modify the configuration of the field in question.

Top 

Adjust the Edit issue screen settings

  1. Log in as the same user you used to configure the Aha! > Jira integration.
  2. You need to edit an issue that already exists. Click Issues and filters, then click All issues.
  3. To limit your search to issues in your project, click Basic, then use the Project dropdown to select your project.
    aha-jira-project-dropdown-highlight.png
  4. Click on an issue's Key or Summary field to open it.
  5. Click the Admin dropdown menu, then select Where is my field?
    aha-jira-edit-issue-admin-highlight.png
  6. Begin typing to find your field, then select it from the list of suggestions.
  7. The Where is my field? modal will show you information on your field. Scroll down to the Field Screen section to see information on your field's Screen settings and where to go to change the configuration.
    aha-where-is-my-field-detail.png
  8. Follow the appropriate hyperlinks to modify the configuration of the field in question.

Top 

Test the integration in Aha!

The last step is to update Aha! with the newly available field.

  1. In Aha!, go to Settings ⚙️> Workspace and select your Jira integration. Click on the Mappings step.
  2. Click Reload configuration at the bottom of the screen to force Aha! to update available fields. Your current mappings will not be affected.
  3. The field should now appear as an option on the list of available field mappings.
  4. Try sending a feature or release to Jira. The data that was previously not showing up should be there.

Top 


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