Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

User created custom fields

This page explains how to access the value of User-created custom fields of different field types using Groovy.  You can access them using the getters of the Issue interface. However, accessing custom fields using the native Jira API can be much more complex, depending on the type of the custom field being accessed. Instead, it is easier to access the fields using the methods provided by JMWE. To understand how to write values into the writable custom fields see Raw value/text input for fields and Groovy expression input for fields

'xxxxx' in the custom fields detailed below is the ID of the custom field. Click here to know how to find the ID of custom fields.

In this page:

Standard Jira custom fields

Select list

Checkboxes / Multi-select list

  • Description: A Field of the type Checkboxes/Multi-select list, is an array of objects. Each selected option is an object in itself.

  • Accessing a field of Checkboxes/Multi-select list type: You can access a custom field of Checkboxes/Multi-select type using any of the following getters of the Issue interface:

Radio buttons / Single-select list

Cascading

  • Description: A field of Cascading type is a Map with the Key as String and Value as the Option

  • Accessing a field of Cascading type: You can access a custom field of Cascading type using any of the following getters of the Issue interface:
    • get("Your custom field name") or get("customfield_xxxxx") that returns a Map<StringOption>
      • Example: Parent of the cascading field

        issue.get("Cascade")?.get(null)?.getValue()


      • Example: Return parent and child of the cascading field as Strings separated by a comma:

        if (issue.get("Cascading type field name"))
        {
          if(issue.get("Cascading type field name").get("1"))
          {
            return issue.get("Cascading type field name").get(null).getValue() + "," + issue.get("Cascading type field name").get("1") 
          }
          return issue.get("Cascading type field name").get(null).getValue()
        }
    • getAsString("Your custom field name") or getAsString("customfield_xxxxx") that returns a String with the parent and child value separated by a comma

      • Example: Return parent and child of the cascading field as Strings separated by a comma:

        issue.getAsString("Cascading type field name")

Multi-level Cascading select

  • Description: A field of Multi-level Cascading select is an object that represents multiple levels of parent and child options

  • Accessing a field of Multi-level Cascading select type: You can access a custom field of Multi level Cascading select type using any of the following getters of the Issue interface. Each level is a LazyLoadedOption. You can access the field using:

Groups

Single-Group Picker

  • Description: A field of Single-group picker type is an object that represents a group.

  • Accessing a field of Single-Group picker type: You can access a custom field of Single-group picker type using any of the following getters of the Issue interface:


Multi-Group Picker

  • Description: A field of Multi-group picker is an array of objects. Each group is an object in itself.

  • Access a field of Multi-group picker typeYou can access a custom field of Multi-group picker type using any of the following getters of the Issue interface:

Users

Single-User picker

Multi-user picker

  • Description: A field of multi-user picker type is an array of objects. Each user is an object in itself.

  • Accessing a field of Multi-user picker typeYou can access a custom field of Multi-user picker type using any of the following getters of the Issue interface:

Watchers field type

  • Description: A field of the Watchers type is an array of objects. Each user is an object in itself.

  • Accessing a field of Watchers field typeYou can access a custom field of Watchers field type using any of the following getters of the Issue interface:

Versions

Single-version picker

Multi-version picker

  • Description: A field of Multi-version picker type is an array of objects. Each version is an object in itself.

  • Accessing a field of Multi-version picker typeYou can access a custom field of Multi-version picker type using any of the following getters of the Issue interface:

Text

Single-line text field type

Multi-line text field type

Read-only text field type

Date/Time picker

Date picker

Date time picker

Others

Numeric field

Project picker type


URL field type

Add-on provided custom fields

Checklist for Jira

Checklist

  • Description: A Field of the type Checklist, is an array of Check list items. Each selected ChecklistItem is an object in itself.

  • Accessing a field of Checklist type: You can access a custom field of Checklist type using any of the following getters of the Issue interface:

Insight custom fields

Insight Object/s

  • Description: A recommended Insight field of the type Insight Object/s that supports both single and multiple values.

  • Accessing a field of Insight object/s type: You can access a custom field of Insight object/s type using any of the following getters of the Issue interface:

Insight Readonly Object/s

  • Description: A field of the type Insight Readonly Object/s that displays Insight Object/s.

  • Accessing a field of Insight Readonly Object/s: You can access a custom field of the Insight Readonly Object/s type using any of the following getters of the Issue interface:

Insight Referenced Object (single)

  • Description: A field of the type Insight Referenced Object (single) that connects Insight Object/s referenced from another Insight Custom Field.

  • Accessing a field of Insight Referenced Object (single): You can access a custom field of the Insight Referenced Object (single) type using any of the following getters of the Issue interface:

Insight Referenced Object (multiple)

  • Description: A field of the type Insight Referenced Object (multiple) that connects Insight Objects referenced from another Insight Custom Field.

  • Accessing a field of Insight Referenced Object (multiple): You can access a custom field of the Insight Referenced Object (multiple) type using any of the following getters of the Issue interface: