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, but 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 then how to confirm that the field is mappable in Aha! after you have enabled it.

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 hand 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.

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 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.

Test the integration in Aha!

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

  1. In Aha!, go to Settings > Product and select your Jira integration.
  2. Click Load project data to force Aha! to update available fields.
  3. Open the Mappings tab and the field should now appear.
  4. Try sending a feature or release. The data that was previously not showing up should be there!

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