Standard JIRA fields

• Field Name: Affects Version/s

• Field ID: versions

• Description: The Affects Version/s field is a collection of version objects. Each object represents a single version.

• Accessing the Affects Version/s field: You can access the Affects Version/s field using any of the following getters of the Issue interface:

  • get("versions") or get("Affects Version/s") that returns a Collection<Version>

    • Example: Name of the first Affects Version/s

      issue.get("versions")?.first()?.getName()

  • getAsString("versions") or getAsString("Affects Version/s") that returns a String with comma separated version names:

    • Example: Join all the Affects Version/s separated by a comma:

      issue.getAsString("versions")

  • getAffectedVersions() that returns a Collection<Version>

    • Example: Join all the Affects Version/s separated by a comma:

      issue.getAffectedVersions().join(",")

• Field name: Assignee

• Field ID: assignee

• Description: The Assignee field is an object that represents the user who this issue is assigned to.

• Accessing the Assignee field: You can access the Assigneefield using any of the following getters of the Issue interface:

  • get("assignee") or get("Assignee") that returns an ApplicationUser

    • Example: Username of the user the issue is assigned to:

      issue.get("assignee")?.getName()

• • getAsString("Assignee") or getAsString("assignee") that returns a String representing the username:

    • Example: Username of the user the issue is assigned to:

      issue.getAsString("assignee")

• • getAssigneeUser() that returns an ApplicationUser

    • Example: EmailAddress of the user the issue is assigned to:

      issue.getAssigneeUser()?.getEmailAddress()

• Field name: Attachments

• Field ID: attachment

• Description: Attachment is a collection of objects. Each object represents a single attachment.

• Accessing the Attachments field: You can access the Attachments field using any of the following getters of the Issue interface:

  • get("attachment") or get("Attachments") that returns a Collection<Attachment>

    • Example: Size of the last attachment added to the issue:

      issue.get("attachment")?.last()?.getFilesize()

  • getAsString("Attachments") or getAsString("attachment") that returns the comma-separated names of the attachments:

    • Example: Names of the attachments

      issue.getAsString("attachment")

       

  • getAttachments() that returns a Collection<Attachment>

    • Example: Name of the Author of the first attachment:

      if(issue.getAttachments() && issue.getAttachments().size() > 0) { issue.getAttachments().first().getAuthorObject()?.getName() }

• Field name: Comment

• Field ID: comment

• Description: The Comments field is a collection of objects. Each object represents one comment.

• Accessing the Comments field: You can access the Comments field using any of the following getters of the Issue interface:

  • get("comment") or get("Comments") that returns a List<Comment>

    • Example: Number of comments on the issue:

      issue.get("comment").size()

    • Example: Last Comment body:

      if(issue.get("comment")) { issue.get("comment").last().getBody() }

    • Example: Name of the author of the first comment on the issue:

      if(issue.get("comment")) { issue.get("comment").first().getAuthorFullName() }

  • getAsString("Comments") or getAsString("comment") that returns a String with comma separated bodies of the comments:

    • Example: All the comments on the issue separated by a comma:

      issue.getAsString("comment")

• Field name: Component/s

• Field ID: components

• Description: The Component/s field is a collection of objects. Each object represents one component.

• Accessing the Components field: You can access the Components field using any of the following getters of the Issue interface:

  • get("components") or get("Component/s") that returns a Collection<ProjectComponent>

    • Example: First component name:

      issue.get("components")?.first()?.getName()

  • getAsString("Component/s") or getAsString("components") that returns a String with comma separated component names:

    • Examples: All the components of the issue

      issue.getAsString("components")

       

  • getComponentObjects() that returns a Collection<ProjectComponent>

    • Example: Last component description:

      if(issue.getComponentObjects()) { issue.getComponentObjects().last().getDescription() }

• Field name: Created

• Field ID: created

• Description: The Created field is a Timestamp that represents the date-time of issue creation.

• Accessing the Created field: You can access the Created field using any of the following getters of the Issue interface:

  • get("created") or get("Created") that returns a Timestamp

    • Example: Created date of the issue:

      issue.get("created")

• • getAsString("Created") or getAsString("created") that returns a String representing the issue creation date/time

    • Example: Issue creation date

      issue.getAsString("created")

       

  • getCreated() that returns a Timestamp:

    • Example: Format the created date:

      issue.getCreated().format("dd/MM/YYY")

To manipulate the date see here

• Field name: Creator

• Field ID: creator

• Description: The Creator field is an object that represents the user who created this issue.

• Accessing the Creator field: You can access the Creator field using any of the following getters of the Issue interface:

  • get("creator") or get("Creator") that returns an ApplicationUser

    • Example: Username of the Creator of the issue:

      issue.get("creator").getName()

  • getAsString("Creator") or getAsString("creator") that returns the username in String:

    • Example: Username of the Creator of the issue:

      issue.getAsString("creator")

       

  • getCreator() that returns an ApplicationUser

    • Example: Displayname of the creator of the issue:

      issue.getCreator().getDisplayName()

• Field name: Description

• Field ID: description

• Description: The Description field is a string representation of a multi-line text describing the issue.

• Accessing the Description field: You can access the Description field using any of the following getters of the Issue interface:

  • get("description") or get("Description") that returns a String

    • Example: Description of the issue:

      issue.get("description")

  • getAsString("Description") or getAsString("description") that returns the Description in String

    • Example: Description of the issue:

      issue.getAsString("description")

  • getDescription() that returns a String:

    • Example: Description of the issue:

      issue.getDescription()

• Field name: Due Date

• Field ID: duedate

• Description: The Due Date field is Timestamp representing the due date of the issue.

• Accessing the Due date field: You can access the Due date field using any of the following getters of the Issue interface:

  • get("duedate") or get("Due Date") that returns a Timestamp:

    • Example: Due date of the issue:

      issue.get("duedate")

  • getAsString("duedate") or getAsString("Due Date") that returns a String representing the Due date

    • Example: Due date of the issue:

      issue.getAsString("duedate")

       

  • getDueDate() that returns a Timestamp:

    • Example: Duedate plus five days. Note: to find out more about date manipulation in Groovy, see here.

      if(issue.getDueDate()) { issue.getDueDate() + 5 }

• Field name: Environment

• Field ID: environment

• Description: The Environment field is a string representation of a multi-line text describing the environment of the issue.

• Accessing the Environment field: You can access the Environment field using any of the following getters of the Issue interface:

  • get("environment") or get("Environment") that returns a String:

  • • Example: Environment of the issue

      issue.get("Environment")

  • getAsString("Environment") or getAsString("environment") that returns a String representing the Environment:

    • Example: Environment of the issue

      issue.getAsString("Environment")

  • getEnvironment() that returns a String:

    • Example: Environment of the issue

      issue.getEnvironment()

• Field name: Epic

• Field ID: none

• Description: Represents the issue's in the current Epic.

• Accessing the Epic of an issue: You can access the Epic of an issue using the getEpic() that returns an Issue

  • Example: Get the Epic of the current issue

    issue.epic

  • Example: Get the status of the current issue's Epic

    issue.epic?.get("status")?.getName()

  • Example: Get the priority of the current issue's Epic

    issue.getEpic()?.get("priority")?.getName()

• Field name: Fix Version/s

• Field ID: fixVersions

• Description: The Fix Version/s field is a collection of objects. Each object represents a single version.

• Accessing the Fix Version/s field: You can access the Fix Version/s field using any of the following getters of the Issue interface:

  • get("fixVersions") or get("Fix Version/s") that returns a Collection<Version>

    • Example: First Fix Version/s name:

      issue.get("fixVersions")?.first()?.getName()

  • getAsString("Fix Version/s") or getAsString("fixversions") that returns a String with comma separated Fix Version/s names:

    • Example: Fix Version/s of the issue

      issue.getAsString("fixVersions")

  • getFixVersions() that returns a Collection<Version>

  • • Example: Join the names of the Fix Version/s, separated by commas:

      issue.getFixVersions().join(",")

• Field name: ID

• Field ID: none

• Description: The ID of the issue.

• Accessing the ID of an issue: You can access the ID of the issue using getId() that returns ID of the issue in a Long format.

  • Example: ID of the issue

    issue.getId()

• Field name: Issue Links

• Field ID: issuelinks

• Description: Issue links is a list of objects. Each object represents one issue link.

• Accessing the Issue links field: You can access the Issue links field using any of the following getters of the Issue interface:

  • get("issuelinks") or get("Linked Issues") that returns a List<IssueLink>

    • Example: Get the issue links of the current issue

      issue.get("issuelinks")

  • getInwardIssueLinks() that returns a List<IssueLink>