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 Multi-level Cascading select is an object that represents multiple levels of parent and child options

• get("Your custom field name") or get("customfield_xxxxx") that returns an array of LazyLoadedOption

  • Example: 

    issue.get("MLCS field")

    returns ["A","A1","A2"] where A, A1 and A2 are the values in the three levels of the field.

  • Example: To get the first level option of the Multi-level cascading select field

    issue.get("MLCS field")?.first()

• getAsString("Your custom field name") or getAsString("customfield_xxxxx") that returns a String with comma-separated values of multiple levels of the field.

  • Example: Return the option value of the last level of a Multi-level cascading select field:

    issue.getAsString("MLCS field")

    returns A,A1,A2 where A, A1 and A2 are the values in the three levels of the field.

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

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

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

  • Example: Name of the first ChecklistItem of a checklist field

    issue.get("Checklist field name").first().name

  • Example: is a specific ChecklistItem selected?

    issue.get("Checklist field name")?.find{
      it.name == "test"
    }?.isChecked()

  • Example: All mandatory ChecklistItem

    issue.get("Checklist field name")?.findAll{
      it.mandatory == true
    }

  • Example: Print all the names of the ChecklistItems

    <% def count = 0
    issue.get("Checklist field name").each() {
      count++
      print "Checklist Item " + count + ": " + it.name + "\n"
    }
    %>

• getAsString("Your custom field name") or getAsString("customfield_xxxxx") that returns a String with comma separated ChecklistItem
  

  • Example: All Checklist item

    issue.getAsString("Checklist field name")

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

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

  • Example: Name of the first Insight object

    issue.get("custom field name").first().name

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:

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

  • Example: Name of the first Insight Readonly Object/s

    issue.get("custom field name").first().name

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

• get("Your custom field name") or get("customfield_xxxxx")that returns ObjectBean

  • Example:Name of the Insight Referenced Object (single)

    issue.get("custom field name").name

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

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

  • Example: Name of the Insight Referenced Object (multiple)

    issue.get("custom field name").first().name