T-Shirt sync fails between Jira Align and Jira
Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
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"}}
Diagnosis
For this article, we'll use a custom field named 'T-shirt.'
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, not a text field (even though the tip when you hover the mouse over it 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:
Was this helpful?