Summary

Jira Align Features fail to sync to Jira Epics and report the below error in the audit logs.

• Failed to update JiraID: xxxxx - Response: 400 BadRequest Json: {"errorMessages":[],"errors":{"customfield_xxxxx": "Operation value must be a string"}}

Environment

Jira Align

Diagnosis

• Check the T-shirt custom field configuration in Jira > Issues > Custom Fields

• Check if the T-shirt custom field is configured in Admin > Jira Setup, T-shirt custom field

Cause

The Custom Field configuration for the T-Shirt in Jira is incorrect. A text field is being used and there is no indication of the values configured to sync. Due to this, Jira throws the error, as the data Jira Align sent to Jira, doesn't match what is expected.

Solution

The T-Shirt field needs to be a Single Select List in Jira, and not a text field (even though the tip when you hover the mouse over says otherwise).

The Jira Align  Help information (which is also available from the menu bar  in the Jira Settings page in Jira Align) states:

T-Shirt custom field. The key for the Jira select list (single choice) field used for the feature’s T-shirt size estimate. Use the format: customfield_123. Use the Sync direction menu to choose the direction of sync: either Bidirectional sync (default) or Jira to Jira Align sync. Select the Configure link to open a settings window where you can map t-shirt size values between Jira Align and Jira.

In addition to setting the correct custom field type in Jira:

• The T-Shirt field in Jira needs to be enabled on the screen(s) that  that will be using T-Shirts 
• The Jira Values set in Settings / Admin > Jira Setup > T-Shirt > Configure need to match with the Context >  Options set in the Jira T-Shirt field.
  • Text names must exactly match between those set in this Jira Align screen and those set in Jira.
  • The complete list of T-Shirts should also be the same between this Jira Align screen and those set in Jira.

Related Content:

Jira integration setup