This error message means that the components field is set as a required field in your Jira configuration. (It is not required by default.) You can configure Jira to not require the components when creating new issues or you can configure a mapping to a custom field.
Jira component or custom field mapping (one-way)
Aha! enables you to map custom fields from Aha! to components and other fields in Jira. In both cases, it is a one-way integration from Aha! to Jira. This means that changes in Jira will not be reflected back to Aha!
Since Jira restricts the values that these fields can take, you must ensure all of the following conditions are met:
- Configure the custom field in Aha! to only allow values that are valid for your Jira configuration.
- The field can be named anything, but its type must be Predefined tags field.
- The tag values must exactly correspond to the possible component values that are configured in Jira.
- All requirements of features will automatically be mapped to those custom fields.
- For each feature you want to send to Jira, make sure at least one component is chosen. If you do not choose a component that is required in Jira you may receive the following error: Remote error for ‘create_feature’: Data not accepted: components: Component/s is required.
Mapping non-component custom fields to Jira
The process for mapping custom Aha! fields to default or custom fields in Jira is the same as above, except you may use the other custom fields — not just the Predefined tags field. Ensure that the values in each field match those that are in Jira. For example, if you may only select one value in Jira, you will set up a custom field as Pre-defined choice list type.
Follow these steps to map custom fields in Aha! to Jira fields:
- Set up the custom fields in Aha!
- Go to your Integration configuration page in Aha! and click Test connection to trigger a refresh of available Jira fields to which you can map.
- Add a field mapping between the custom field you created and the component field in Jira.
- Test by sending a feature with the custom field values selected to Jira (via the Send dropdown).
Note (Jira sprints):
It is common to attempt to map a custom field in Aha! to the Jira Agile sprint field. However, the sprint field is key to the operation of Jira Agile. Changing the sprint affects a number of things. The Jira UI is able to display the sprint in a friendly way, but the API does not support translating the internal representation into a form that is useful to external systems. Unfortunately, this means that Aha! and other external systems cannot integrate.