Fix error "Field cannot be set. It is not on the appropriate screen, or unknown" on Jira Align Connector

Summary

This error is a variation of the most common error that the connector generates.

The difference here is that the fault is not with Jira permissions but with the JA Connector settings. It usually affects Stories and not other work items.

If you are seeing the error above (where 'xxx' is the customfield id), instead of a blank value in between the ', please refer to the article Error "Field 'xxx' cannot be set. It is not on the appropriate screen, or unknown" on Jira Align Connector

Diagnosis

The error can be seen on the audit log of Stories, or on the Admin > Jira Settings > Manage Projects > View Logs.

Cause

Cause 1

This is usually caused by a problem in Jira Settings > Jira Setup: Story Creation Requires Team configuration, where it is set as YES, but no team is configured on the Organization field. So the connector tries to send the Team value, but there is nothing to be sent, which results in the empty value on the JSON.

Like, in the example above, the connector is trying to send the following value for Team:

The Organization Field can be found on Jira Settings > Jira Setup: Organization. When clicking on the configure that appears in the field, you can edit the details for each project.

Cause 2

Another possible cause, but rarer, is the lack of configuration of the Jira Settings > Jira Setup: Story Points.

Solution

The possible solution is to turn OFF the configuration Story Creation Requires Team, or if it is needed, configure the Teams under the Organization field.