User created custom fields

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<Option>

  • Example: First selected option value of a checkbox field

    issue.get("<Checkboxes field name>")?.first()?.getValue()

  • Example: is a specific option selected?

    issue.get("<Checkboxes field name>")?.find() { it.getValue() == "An option" } != null

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String with comma separated Option values
  

  • Example: Options selected

    issue.getAsString("<Checkboxes field name>")

    
    

Description: A field of Radio buttons/Single-select list type is an object that represents an option.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a String

  • Example: is a specific option selected?

    issue.get("<Radio button field name>") == "An option"

  • Example: Option value of the Single-select list

    issue.get("<Single-select list field name>")

    
    

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the value of the Option
  

  • Example: Option selected

    issue.getAsString("<Single-select list field name>")

    
    

• getRawValue("<Your custom field name>") or getRawValue("customfield_xxxxx") that returns a Option
  

  • Example: Option selected

    issue.getRawValue("<Single-select list field name>")

    
    

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Map<String, Option>

  • 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>")

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<Group>

  • Example: Name of the first selected group

    issue.get("<Single-group picker name>")?.first()?.getName()

  • Example: Is a specific group selected?

    issue.get("<Single-group picker name>")?.find() { it.getName() == "Group name" } != null

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the group name:

  • Example: Name of the selected group

    issue.getAsString("<Single-group picker name>")

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<Group>

  • Example: Name of the first selected group

    issue.get("<Multi-group picker name>")?.first()?.getName()

• • Example: Is a specific group selected?

    issue.get("<Multi-group picker name>")?.find() { it.getName() == "Group name" } != null

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String with comma separated Group names
  

  • Example: Groups selected

    issue.getAsString("<Multi-group picker name>")

    
    

Description: A field of Single-user picker is an object that represents a user.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns an ApplicationUser

  • Example: Email Address of the user selected in the field

    issue.get("<Single-user picker field name>")?.getEmailAddress()

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the username

  • Example: User selected in the field

    issue.getAsString("<Single-user picker field name>")

    
    

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<ApplicationUser>
  

  • Example: Is the reporter of the issue selected?

    issue.get("<Multi-user picker field name>")?.find() { it.getName() == issue.get("reporter").getName() } != null

  • Example: Email address of all the selected users:

    def EmailId = []
    issue.get("MUP")?.findAll() { 
        EmailId.push(it.getEmailAddress())
    }
    return EmailId

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String with comma separated Usernames.

  • Example: All the selected users:

    issue.getAsString("<Multi-user picker field name>")

    
    

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<ApplicationUser>

  • Example: Number of Watchers in the custom field

    issue.get("<Your custom field name>").size()

  • Example: All the Watchers in the custom field except the Reporter

    issue.get("<Your custom field name>")?.findAll { it.getName() != issue.get("reporter").getName() }

    
    

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String with comma separated Usernames.

  • Example: All Watchers in the custom field

    issue.getAsString("<Your custom Watchers field name>")

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<Version>

  • Example: Release date of the selected version:

    issue.get("<Single-Version picker field name>")?.last()?.getReleaseDate()

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the name of the version:

  • Example: Release date of the selected version:

    issue.getAsString("<Single-Version picker field name>")

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Collection<Version>

  • Example: Are the selected versions same as the Affects Version/s?

    issue.get("<Multi-Version picker field name>") == issue.get("versions")

• • Example: Release date of the last versions

    issue.get("<Multi-Version picker field name>")?.last()?.getReleaseDate()

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String with comma separated Version names

  • Example: Selected versions:

    issue.getAsString("<Multi-Version picker field name>")

    
    

Description: A field of Single-line text type is a string that represents a single-line text.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a String

  • Example: Text of the field

    issue.get("<Single-line text field name>")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the text:

  • Example: Text of the field

    issue.getAsString("<Single-line text field name>")

    
    

Description: A field of Multi-line text type is a string that represents a multi-line text.

• Example: Text of the field

  issue.get("<Multi-line text field name>")

getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the text:

• Example: Text of the field

  issue.getAsString("<Multi-line text field name>")

  
  

Description: A field of Read-only text type is a string that represents a read-only text.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a String

  • Example: Text of the field

    issue.get("<Read-only text field name>")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the text:

  • Example: Text of the field

    issue.get("<Read-only text field name>")

Description: A field of Date picker type is a Timestamp (Date) object.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Timestamp

  • Example: The value of the Date picker type field

    issue.get("<Date picker field name>")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the date:

  • Example: The value of the Date picker type field

    issue.getAsString("<Date picker field name>")

    To manipulate the date see here

Description: A field of Date time picker type is a Timestamp (Date) object.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Timestamp

  • Example: return the date without the time value (or rather at 00:00:00)

    issue.get("<Date picker field name>").clearTime()

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the date-time:

  • Example: Date time picker value

    issue.getAsString("<Date picker field name>")

    To manipulate the date see here

Description: A field of Numeric type is a number.

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Double

  • Example: Value of the numeric field

    issue.get("<Numeric field name>")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the Number

  • Example: Value of the numeric field

    issue.getAsString("<Numeric field name>")

Description: A field of Project picker type is an object describing a project.

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

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a Project
  

  • Example: Is the project same as the project the current issue belongs to?

    issue.get("<Project picker type field name>") == issue.get("project")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the key of the project:

  • Example: Name of the project picked:

    issue.getAsString("<Project picker type field name>")

Description: A field of URL type is a string representation of an URL

• get("<Your custom field name>") or get("customfield_xxxxx") that returns a String

  • Example: URL value

    issue.get("<URL type field name>")

• getAsString("<Your custom field name>") or getAsString("customfield_xxxxx") that returns a String representing the URL

  • Example: URL value

    issue.get("<URL type field name>")