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() }

      
      

Created

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

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

      
      

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

  • Example: Issue creation date

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

    
    

• getCreated() that returns a Timestamp:

  • Example: Format the created date:

    Code Block
    language groovy linenumbers true
    issue.getCreated().format("dd/MM/YYY")

    
    

To manipulate the date see here

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

      
      

Description

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

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

      
      

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

    • Example: Description of the issue:

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

      
      

  • getDescription() that returns a String:

    • Example: Description of the issue:

      Code Block
      language groovy linenumbers true
      issue.getDescription()

      
      

Due Date

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

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

      
      

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

    • Example: Due date of the issue:

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

      Code Block
      language groovy linenumbers true
      if(issue.getDueDate()) { issue.getDueDate() + 5 }

      
      

Environment

• 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

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

    
    

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

    • Example: Environment of the issue

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

      
      

  • getEnvironment() that returns a String:
    

    • Example: Environment of the issue

      Code Block
      language groovy linenumbers true
      issue.getEnvironment()

      
      

Epic

• 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

    Code Block
    language groovy linenumbers true
    issue.epic

    
    

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

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

    
    

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

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

    
    

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

      
      

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

      
      

Key

• Field name: Key

• Field ID: issuekey

• Description: The Key is a string that represents the key of the issue.

• Accessing the Key of the issue: You can access the Key of the issue using any of the following getters of the Issue interface:

  • get("issuekey") or get("Key") that returns a String

    • Example: Access the key of the current issue:

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

      
      

  • getAsString("Key") or getAsString("issuekey") that returns a String representing the key of the issue:

    • Example: Access the key of the current issue:

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

      
      

  • getKey() that returns a String

    • Example: Access the key of the issue's Epic:

      Code Block
      language groovy linenumbers true
      issue.getEpic()?.getKey()

      
      

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

      
      

Last Viewed

• Field Name: Last Viewed

• Field ID: lastViewed

• Description: The Last Viewed field is a string representation of a date-timestamp.

• Accessing the Last Viewed field: You can access the Last Viewed field using any of the following getters of the Issue interface:
  • get("lastViewed") or get("Last Viewed") that returns a Timestamp

    • Example: Last Viewed timestamp of the issue:

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

      
      

  • getAsString("lastViewed") or getAsString("Last Viewed") that returns a String representing the issue last viewed time.

    • Example: Last Viewed timestamp of the issue:

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

      
      

To manipulate the date see here

Original Estimate

• Field name: Original Estimate

• Field ID: timeoriginalestimate

• Description: The Original Estimate field is a duration string representing the original time estimate.

• Accessing the Original Estimate field: You can access the Original Estimate field using any of the following getters of the Issue interface:
  • get("timeoriginalestimate") or get("Original Estimate")that returns the original time estimate in seconds in Long format

    • Example: Original Estimate of the issue in seconds:

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

      
      

  • getAsString("Original Estimate") or getAsString("timeoriginalestimate") that returns String representing the original time estimate in seconds.

    • Example:Original Estimate of the issue in seconds:

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

      


  • getOriginalEstimate() that returns the original time estimate in seconds in Long format.

    • Example: Original Estimate of the issue in hours

      Code Block
      language groovy linenumbers true
      issue.getOriginalEstimate()/60/60

      


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

      
      

Progress

• Field name: Progress

• Field ID: progress

• Description: The Progress field is a field describing the progress on the issue.

• Accessing the Progress field: You can access the Progressfield using any of the following getters of the Issue interface:
  • get("progress") or get("Progress") that returns the percentage of progress on the issuein Long
    

    • Example: Percentage of progress on the issue:

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

      
      

  • getAsString("Progress") or getAsString("progress") that returns a String representing the percentage of progress on the issue

    • Example: Percentage of progress on the issue:

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

      
      

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

      
      

Remaining Estimate

• Field name: Remaining Estimate

• Field ID: timeestimate

• Description: The Remaining Estimate field is a number or a duration string representing the remaining time estimate in seconds.

• Accessing the Remaining Estimate field: You can access the Remaining Estimate field using any of the following getters of the Issue interface:
  • get("timeestimate") or get("Remaining Estimate") that returns the remaining time estimate in seconds in Long format

    • Example: Remaining Estimate of the issue in seconds:

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

      
      

  • getAsString("Remaining Estimate") or the getAsString("timeestimate") that returns a String representing remaining time estimate in seconds.
    

    • Example: Remaining Estimate of the issue in seconds:

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

      
      

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

      
      

Resolved

• Field name: Resolved

• Field ID: resolutiondate


• Description: The Resolved field is a Timestamp representing the resolution date.

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

    • Example: Time stamp of resolution:

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

      
      

  • getAsString("resolutiondate") or getAsString("resolutiondate") that returns a String representing the resolution date:
    

    • Example: Time stamp of resolution:

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

      
      

  • getResolutionDate() that returns a Timestamp:

    • Example:Time stamp of resolution:

      Code Block
      language groovy linenumbers true
      issue.getResolutionDate()

      
      

To manipulate the date see here

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  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() }

      
      

Summary

• Field name: Summary

• Field ID: summary


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

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

    • Example: Summary of the issue:

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

      
      

  • getAsString("Summary") or getAsString("summary") that returns a String:
    

    • Example: Summary of the issue:

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

      
      

  • getSummary() that returns a String
    

    • Example: Summary of the issue:

      Code Block
      language groovy linenumbers true
      issue.getSummary()

      
      

Time Spent

• Field name: Time Spent

• Field ID: timespent


• Description: The Time spent field is a number representing the time spent on the issue in seconds.

• Accessing the Time spent field: You can access the Time spent using any of the following getters of the Issue interface:
  • get("timespent") or get("Time Spent") that returns the time spent in seconds in a Long format

    • Example: Time spent on the issue in seconds:

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

      
      

• getAsString("Time Spent") or getAsString("timespent") that returns a String representing the time spent in seconds.

  • Example: Time spent on the issue in seconds:

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

    
    

• getTimeSpent() that returns the time spent in seconds in a Long format:

  • Example: Time spent on the issue in seconds:

    Code Block
    language groovy linenumbers true
    issue.getTimeSpent()

    
    

Updated

• Field name: Updated

• Field ID: updated


• Description: The Updated field is a Timestamp representing the issue updated date-time.

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

    • Example: Updated timestamp of the issue:

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

      
      

  • getAsString("Updated") or getAsString("updated") that returns a String representing the issue updated date/time.
    

    • Example: Updated timestamp of the issue:

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

      
      

  • getUpdated()that returns a Timestamp

    • Example: Updated time stamp of the issue:

      Code Block
      language groovy linenumbers true
      issue.getUpdated()

      
      

To manipulate the date see here

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() }

    
    

Work Ratio

• Field name: Work Ratio

• Key: workratio

• Description: The Work Ratio field is a number representing the ratio of work done on the issue.

• Accessing the Work Ratio field: You can access the Work ratio field using any of the following getters of the Issue interface:
  • get("workratio") or get("Work Ratio")that returns the percentage of work that has been logged against the issue vs the estimate you made for it in Long

    • Example: Work ratio of the issue

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

      
      

  • getAsString("Work Ratio") or getAsString("workratio") that returns a String representing the work that has been logged against the issue vs the estimate:

    • Example: Work ratio of the issue

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

      
      

∑ Original Estimate

• Field name: Σ Original Estimate

• Field ID: aggregatetimeoriginalestimate


• Description: The aggregate original estimate field is a number representing the total original estimate of the issue and its sub-tasks if the issue has any.

• Accessing the ∑ Original Estimate field: You can access the ∑ Original Estimate field using any of the following getters of the Issue interface:
  • get("aggregatetimeoriginalestimate") or get("∑ Original Estimate") that returns aggregate original estimate of seconds in Long:

    • Example: Aggregate original estimate of the issue in seconds:

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

      
      

  • getAsString("aggregatetimeoriginalestimate") or getAsString("∑ Original Estimate") that returns a String representing the aggregate original estimate in seconds:

    • Example: Aggregate original estimate of the issue in seconds:

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

      
      

∑ Remaining Estimate

• Field name: Σ Remaining Estimate

• Field ID: aggregatetimeestimate


• Description: The aggregate remaining Estimate field is a number representing the total remaining estimate of the issue and its sub-tasks if the issue has any.

• Accessing the ∑ Remaining Estimate field: You can access the ∑ Remaining Estimate field using any of the following getters of the Issue interface:
  • get("aggregatetimeestimate") or get("∑ Remaining Estimate") that returns aggregate remaining estimate in seconds in Long:

    • Example: Aggregate remaining estimate of the issue in seconds:

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

      
      

  • getAsString("aggregatetimeestimate") or getAsString("∑ Remaining Estimate") that returns a String representing the aggregate remaining estimate in seconds:

    • Example: Aggregate remaining estimate of the issue in seconds:

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

      
      

∑ Progress

• Field name: Σ Progress

• Field ID: aggregateprogress

• Description: The Aggregate Progress field is an object describing the aggregate progress on the issue.

• Accessing the ∑ Progress field: You can access the ∑ Progress field using any of the following getters of the Issue interface:
  • get("aggregateprogress") or get("∑ Progress") that returns aggregate percentage progress on the issue in Long format:
    

    • Example: Aggregate Progress on the issue:

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

      
      

  • getAsString("aggregateprogress") or getAsString("∑ Progress") that returns a String representing the aggregate remaining estimate in seconds:

    • Example: Aggregate progress on the issue:

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

      
      

∑ Time Spent

• Field name: Σ Time Spent

• Field ID: aggregatetimespent

• Description: The Aggregate time spent field is a number representing the total time spent on the issue and its sub-tasks if the issue has any.

• Accessing the ∑ Time spent field: You can access the ∑ Time spentfield using the
  • get("aggregatetimespent") or get("∑ Time spent") that returns aggregate remaining estimate in seconds in Long:
    

    • Example: Aggregate time spent on the issue in seconds:

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

      
      

  • getAsString("aggregatetimespent") or getAsString("∑ Time spent") that returns a String representing the aggregate remaining estimate in seconds:

    • Example: Aggregate time spent on the issue in seconds:

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