Page Comparison

Affects Version/s

• 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

      Code Block
      language groovy linenumbers true
      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:

      Code Block
      issue.getAsString("versions")

      


  • getAffectedVersions() that returns a Collection<Version>

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

      Code Block
      language groovy linenumbers true
      issue.getAffectedVersions().join(",")

      
      

Assignee

• 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:

      Code Block
      language groovy linenumbers true
      issue.get("assignee")?.getName()

      
      

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

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

      Code Block
      language groovy linenumbers true
      issue.getAsString("assignee")

      
      

• • getAssigneeUser() that returns an ApplicationUser

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

      Code Block
      language groovy linenumbers true
      issue.getAssigneeUser()?.getEmailAddress()

      
      

Attachments

• 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:

      Code Block
      language groovy linenumbers true
      issue.get("attachment")?.last()?.getFilesize()

      
      

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

    • Example: Names of the attachments

      Code Block
      language groovy linenumbers true
      issue.getAsString("attachment")

      


  • getAttachments() that returns a Collection<Attachment>

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

      Code Block
      language groovy linenumbers true
      if(issue.getAttachments() && issue.getAttachments().size() > 0) { issue.getAttachments().first().getAuthorObject()?.getName() }

      
      

Comments

• 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:

      Code Block
      language groovy linenumbers true
      issue.get("comment").size()

      
      

    • Example: Last Comment body:

      Code Block
      language groovy linenumbers true
      if(issue.get("comment")) { issue.get("comment").last().getBody() }

      
      

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

      Code Block
      language groovy linenumbers true
      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:

      Code Block
      language groovy linenumbers true
      issue.getAsString("comment")

      
      

Component/s

• 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:

      Code Block
      language groovy linenumbers true
      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

      Code Block
      language groovy linenumbers true
      issue.getAsString("components")

      
      

  • getComponentObjects() that returns a Collection<ProjectComponent>

    • Example:Last component description:

      Code Block
      language groovy linenumbers true
      if(issue.getComponentObjects()) { issue.getComponentObjects().last().getDescription() }

      
      

Creator

• 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:

      Code Block
      language groovy linenumbers true
      issue.get("creator").getName()

      
      

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

    • Example: Username of the Creator of the issue:

      Code Block
      language groovy linenumbers true
      issue.getAsString("creator")

      


  • getCreator() that returns an ApplicationUser

    • Example: Displayname of the creator of the issue:

      Code Block
      language groovy linenumbers true
      issue.getCreator().getDisplayName()

      
      

FixVersion/s

• 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:

      Code Block
      language groovy linenumbers true
      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

      Code Block
      language groovy linenumbers true
      issue.getAsString("fixVersions")

      
      

  • getFixVersions() that returns a Collection<Version>

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

      Code Block
      language groovy linenumbers true
      issue.getFixVersions().join(",")

      
      

ID

• 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

    Code Block
    language groovy linenumbers true
    issue.getId()

    
    

Issue links

• 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

      Code Block
      language groovy linenumbers true
      issue.get("issuelinks")

      
      

  • getInwardIssueLinks() that returns a List<IssueLink>
    

    • Example: Number of inward linked issues for the current issue

      Code Block
      language groovy linenumbers true
      issue.getInwardIssueLinks().size()

      
      

  • getOutwardIssueLinks() that returns a List<IssueLink>
    

  • Example: Destination issue of the first issue link to the current issue

    Code Block
    language groovy linenumbers true
    if(issue.getOutwardIssueLinks()) { issue.getOutwardIssueLinks().first().getDestinationObject() }

    
    

  • getLinkedIssues(String linkName) that returns a List<Issue>
    

    • Example: Get the issues linked to the current issue with the 'blocks' link type

      Code Block
      language groovy linenumbers true
      issue.getLinkedIssues('blocks')

      
      

    • Example: Get the status of all issues linked to the current issue with the 'is blocked by' link type

      Code Block
      language groovy linenumbers true
      Status = [] issue.getLinkedIssues('is blocked by').each{ Status += it.getStatus().getName() } return Status

      
      

Issue type

• Field name: Issue Type

• Field ID: issuetype


• Description: The Issue Type field is an object describing the issue type.

• Accessing the Issue type field: You can access the Issue type field using any of the following getters of the Issue interface:
  • get("issuetype") or get("Issue Type") that returns an Issuetype

    • Example: Name of the issue type:

      Code Block
      language groovy linenumbers true
      issue.get("issuetype").getName()

      
      

  • getAsString("Issue Type") or getAsString("issuetype") that returns a String representing the name of the Issue Type.

    • Example: Name of the issue type:

      Code Block
      language groovy linenumbers true
      issue.getAsString("issuetype")

      
      

  • getIssueTypeObject() that returns an Issuetype

    • Example: Set a text field to "This issue is a sub-task" if the issue is a sub-task:

      Code Block
      language groovy linenumbers true
      if(issue.getIssueTypeObject().getName()=="Sub-task") { "This is a sub-task" }

      
      

Labels

• Field name: Labels

• Field ID: labels

• Description: Labels is a Set of labels.

• Accessing the Labels field: You can access the Labels field using any of the following getters of the Issue interface:
  • get("labels") or get("Labels") that returns a Set<Label>

    • Example: Get the first label of the issue:

      Code Block
      language groovy linenumbers true
      if(issue.get("labels")) { issue.get("labels").first() }

      
      

  • getAsString("Labels") or getAsString("labels") that returns a String with comma separated label names:

    • Examples: Labels of the issue

      Code Block
      language groovy linenumbers true
      issue.getAsString("labels")

      
      

  • getLabels() that returns a Set<Label>

    • Example: Get the last label of the issue

      Code Block
      language groovy linenumbers true
      if(issue.getLabels()) { issue.getLabels().last() }

      
      

    • Example: All the labels of the issue separated by a comma:

      Code Block
      language groovy linenumbers true
      issue.getLabels().join(",")

      
      

Priority

• Field name: Priority

• Field ID: priority

• Description: The Priority field is an object describing the priority of the issue.

• Accessing the Priority field: You can access the Priority field using any of the following getters of the Issue interface:
  • get("priority") or get("Priority") that returns a Priority

    • Example: Name of the Priority of the issue:

      Code Block
      language groovy linenumbers true
      issue.get("priority").getName()

      
      

  • getAsString("Priority") or getAsString("priority") that returns a String representing the name of the Priority

    • Example:Name of the Priority of the issue:

      Code Block
      language groovy linenumbers true
      issue.getAsString("priority")

      
      

  • getPriorityObject() that returns a Priority

    • Example: ID of the Priority of the issue:

      Code Block
      language groovy linenumbers true
      issue.getPriority().getId()

      
      

Project

• Field name: Project

• Field ID: project

• Description: The Project field is an object describing the selected project.

• Accessing the Project field: You can access the Project field using any of the following getters of the Issue interface:
  • get("project") or get("Project") that returns a Project

    • Example: Name of the project the issue belongs to:

      Code Block
      language groovy linenumbers true
      issue.get("project")?.getName()

      
      

  • getAsString("Project") or getAsString("project") that returns a String representing the name of the project

    • Example: Name of the project

      Code Block
      language groovy linenumbers true
      issue.getAsString("project")

      
      

  • getProjectObject() that returns a Project

    • Example: Key of the project the issue belongs to:

      Code Block
      language groovy linenumbers true
      issue.getProjectObject().getKey()

      
      

Reporter

• Field name: Reporter

• Field ID: reporter


• Description: The Reporter field is an object that represents the user by whom the issue is reported.

• Accessing the Reporter field: You can access the Reporter field using any of the following getters of the Issue interface:
  • get("reporter") or get("Reporter") that returns an ApplicationUser

    • Example: Username of the reporter of the issue:

      Code Block
      language groovy linenumbers true
      issue.get("reporter").getName()

      
      

  • getAsString("Reporter") or getAsString("reporter") that returns the username inString:

    • Example:Username of the reporter of the issue:

      Code Block
      language groovy linenumbers true
      issue.getAsString("reporter")

      


  • getReporter()that returns an ApplicationUser

    • Example: Email address of the reporter:

      Code Block
      language groovy linenumbers true
      issue.getReporter().getEmailAddress()

      
      

Resolution

• Field name: Resolution

• Field ID: reporter


• Description: The Resolution field is an object describing the resolution of the issue.

• Accessing the Resolution field: You can access the Resolution field using any of the following getters of the Issue interface:
  • get("resolution") or get("Resolution") that returns a Resolution

    • Example: Name of the Resolution of the issue:

      Code Block
      language groovy linenumbers true
      issue.get("resolution")?.getName()

      
      

  • getAsString("Resolution") or getAsString("resolution") that returns a String representing the name of the Resolution of the issue
    

    • Example: Name of the Resolution of the issue:

      Code Block
      language groovy linenumbers true
      issue.getAsString("resolution")

      
      

  • getResolutionObject() that returns a Resolution

    • Example: Description of the resolution:

      Code Block
      language groovy linenumbers true
      issue.getResolutionObject()?.getDescription()

      
      

Security Level

• Field name: Security Level

• Field ID: security


• Description: The Security level field is an object describing the security level of the issue.

• Accessing the Security level field: You can access the Security level field using any of the following getters of the Issue interface:
  • get("security") or get("Security Level") that returns the IssueSecurityLevel

    • Example: ID of the security level of the issue:

      Code Block
      language groovy linenumbers true
      issue.get("security")

      
      

  • getAsString("Security Level") or getAsString("security") that returns a String representing the name of the security level:
    

    • Example: Name of the security level

      Code Block
      language groovy linenumbers true
      issue.getAsString("security")

      
      

  • getSecurityLevelId() that returns the security ID in Long:

    • Example: ID of the security level of the issue:

      Code Block
      language groovy linenumbers true
      issue.getSecurityLevelId()

      
      

Status

• Field name: Status

• Field ID: status


• Description: The Status field is an object describing the status of the issue.

• Accessing the Status field: You can access the Status field using any of the following getters of the Issue interface:
  • get("status") or get("Status") that returns a Status

    • Example: Name of the status of the issue:

      Code Block
      language groovy linenumbers true
      issue.get("status").getName()

      
      

  • getAsString("Status") or getAsString("status") that returns a String representing the name of the status the issue is in:
    

    • Example: Name of the status of the issue:

      Code Block
      language groovy linenumbers true
      issue.getAsString("status")

      
      

  • getStatusObject() that returns a Status:

    • Example: Name of the status category of the status:

      Code Block
      language groovy linenumbers true
      issue.getStatusObject().getId()

      
      

Stories

• Field name: Stories

• Field ID: none


• Description: Represents the issues in the current Epic.

• Accessing the issues in an Epic: You can access the issues in an Epic using the getStories() that returns a List<Issue>

  • Example: Get the issues of an Epic that are in Closed status:

    Code Block
    language groovy linenumbers true
    def stories = issue.getStories().findAll{ it.get("status").getName() == "Closed" } return stories

    
    

  • Example: Get the number of issues in the current Epic

    Code Block
    language groovy linenumbers true
    issue.getStories().size()

    
    

Subtasks

• Field name: Sub-Tasks

• Field ID: subtasks


• Description: Represents the subtasks of the current issue.

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

  • get("subtasks") or get("Sub-Tasks") that returns a List<Issue>

    • Example: First subtask of the parent:

      Code Block
      language groovy linenumbers true
      issue.get("subtasks")?.first()

      
      

  • getAsString("Sub-Tasks") or getAsString("subtasks") that returns a String with comma separated keys of the subtasks.
    

    • Example: Subtasks of the issue

      Code Block
      language groovy linenumbers true
      issue.getAsString("subtasks")

      
      

  • getSubTaskObjects() that returns a List<Issue>:

    • Example: Last subtask's status:

      Code Block
      language groovy linenumbers true
      if(issue.getSubTaskObjects()) { issue.getSubTaskObjects().last().getStatus().getName() }

      
      

Votes

• Field name: Votes

• Field ID:votes


• Description: The Votes field is a collection of users who voted for issue.

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

  • get("votes") or get("Votes") that returns a Collection<ApplicationUser>

    • Example: Did the reporter vote for the issue?

      Code Block
      language groovy linenumbers true
      issue.get("votes")?.find() { it.getName() == issue.get("reporter").getName() } != null

      
      

  • getAsString("votes") or getAsString("votes") that returns a String with comma separated voters names:
    

    • Example: Voters of the issue

      Code Block
      language groovy linenumbers true
      issue.getAsString("voters")

      
      

  • getVotes() that returns the number of votes in Long

    • Example: Number of votes on the issue:

      Code Block
      language groovy linenumbers true
      issue.getVotes()

      
      

Watchers

• Field name: Watchers

• Field ID: watches


• Description: The Watchers field is a collection of users watching the issue.

• Accessing the Watchers field: You can access the Watchers field using any of the following getters of the Issue interface:
  • get("watches") or get("Watchers") that returns a Collection<ApplicationUser>

    • Example: Username of the first user watching the issue:

      Code Block
      language groovy linenumbers true
      if(issue.get("watches")) { issue.get("watches").first().getName() }

      
      

  • getAsString("Watchers") or getAsString("watches") that returns a String with comma separated watchers names:
    

    • Example: Watchers of the issue

      Code Block
      language groovy linenumbers true
      issue.getAsString("watches")

      
      

  • getWatches() that returns the number of watchers in Long:

    • Example: Number of users watching the issue:

      Code Block
      language groovy linenumbers true
      issue.getWatches()

      
      

Work log

• Field name: Log Work

• Field ID: worklog

• Description: The Work log field is a list of worklogs logged on the issue.

• Accessing the Worklog: You can access the Log Work field using the get("worklog") or get("Log Work") that returns a List<Worklog>

  • Example: Time spent on the last work logged

    Code Block
    language groovy linenumbers true
    if(issue.get("Log Work")) { issue.get("Log Work").last().getTimeSpent() }