How to Sync Custom Fields with Options in Jira On-premise

This article describes how to synchronize custom fields that have options as a value type.

Jira has different custom field types with options:

• Select list (Single choice)
• Radio buttons (list of radio buttons)
• Select list (Multiple choices)
• Checkboxes (multiple choices)

Below you can find some examples on how to handle the most common cases related to the custom fields with option values.

Select List (single choice)

Custom fields with types Select List(single choice) and Radio buttons(single choice) have values of type Option.

You can apply the received option in different ways on your side:

• set an option manually directly in the Sync Rules

  issue.customFields."Hobby".value = "Running"

• add the received value from the remote custom field into the local custom field
  

  If the received custom field does not have any values yet, you can still set a custom field with a default value as empty

  issue.customFields."Hobby".value = replica.customFields."Interest"?.value

• Set a default option in case there's no value received from the remote side

  issue.customFields."Hobby".value =	replica.customFields."Interest"?.value ?:  "Hobby"

• Map options between instances

  def hobbyMap = ["Futbol": "Soccer", "Beisbol": "Baseball"] // ["remote options" : "local option"]
  def remoteHobby = replica.customFields."Hobby"?.value?.value
  issue.customFields."Hobby".value = hobbyMap[remoteHobby] ?: remoteHobby

Select List (multiple choices)

Custom fields with types Select List(multiple choices) and Checkboxes(multiple choices) have values of type list of Options.

Below you can find some examples of how to handle custom field options in multi-value custom fields. 

• Set an option value manually into the local custom field
  

  issue.customFields."Multi Select Custom Field name".value = 
                  (issue.customFields."Multi Select Custom Field name".value ?: []) + 
                      nodeHelper.getOption(issue, "Multi Select Custom Field name", "MY STATIC OPTION")

• add the value from the remote custom field Departments into the local custom field Sub-divisions
  
  Leave an empty field in case there's no option, received from the remote side.

  issue.customFields."Sub-divisions".value = replica.customFields."Departments"?.value

• Set a default option in case there's no value received from the remote side 

  You need to ensure that the value is an array of options.

  issue.customFields."Hobby".value = replica.customFields."Interest"?.value ?: ["Running"]

• Map options in a select list

  def hobbyMap = ["Football": "Sports", "Baseball": "Basketball"]
  def remoteHobbies = replica.customFields."Hobby"?.value?.value
  issue.customFields."Hobby".value = remoteHobbies.collect{hobbyMap[it] ?: it}