How the Jira Align "Does story creation in Jira require a team assignment" setting work when creating a Jira Story
Summary
In Jira Align > Settings/Administration > Jira Setup there is a setting called Does story creation in Jira require a team assignment? This setting modifies the way the Jira Connector creates the Jira Story, depending on whether the option is set to YES/NO.
If the Team field is marked as required in Jira and the above setting is set to NO, then the creation of the Story will fail. There will be log errors during synchronization.
Environment
Jira Align
Solution
When creating a new story the Jira Connector makes two API calls
The first API call creates the Jira story with the initial, required data (and will fail if any required data is not included in the call)
The second API call updates the created story with optional data (and will fail if the first API call fails)
Depending on how "Does story creation in Jira require a team assignment" is set determines what the team value is sent during the first API call or the second API call.
Option: YES/NO | Effect on the first API call |
|---|---|
| As well as setting the values for the default required fields, the first API call sets the Team field to the value of determined by the configured team mappings where:
|
| The first API call ONLY sets default required fields and does not include any information about the team assignment, which is included in the second API call instead |
What this means is, if the Team field is marked as required in Jira and the setting "Does story creation in Jira require a team assignment" is set as NO on Jira Align, then the creation of the Jira Story will fail with the error “Unable to create issue […] - Team is required", as the first API call will fail due to the team value not being sent (even though the Team value is configured in Jira Align).
If the Team Field is set to required in Jira, then this setting must to be set as YES in Jira Align
If the Team Filed is not required in Jira, then the option can be set as NO in Jira Align.