Email This Issue
π Marketplace
β Support
β€οΈ Feedback
π META-INF Apps
Searchβ¦
Email This Issue - for Jira Cloud
β¬
Overview
Email This Issue - for Jira Cloud
Features
How Email This Issue Works
Comparing Email This Issue and Jira Cloud
π€
Outgoing Emails
Outgoing emails overview
Manual emails
Email notification schemes and email notifications
Workflow post functions
Advanced email configuration
Customizing email templates
Canned Responses (default messages)
Scope evaluation
π₯
Incoming Emails (Mail Handlers)
Incoming emails overview
Adding/editing a mail handler
Global Sender Address Filters
π€
Administration
Outgoing Mail Connections
Alerting via Webhooks
Mail Queue
Email Audit Log
Permissions
Recipient Restrictions
Incoming Mail Connections
Incoming Mail Queue
Incoming Mail Log
OAuth2 Credentials
β
FAQ
No recipients error in outgoing emails
How-to add custom macro to email Template?
Why cannot I select custom event types in notification?
How to configure the Email This Issue addon user in Jira Cloud?
I get an error: Could not create request on behalf of the sender
Why is the Incoming Mail Queue size limited?
Outgoing mail not sent - Read timeout error
πͺ
General
Release Notes
API
API for Velocity Context Objects - 1.7
API for Velocity Context Objects
Addon Pages
Security Advisories
Appendix
Powered By
GitBook
API for Velocity Context Objects - 1.7
Velocity Context offers many objects for templates. Find the list of variables with explanations here:
Customizable Email Templates
.
Below is the detailed description of object attributes. You can render the attributes in the templates in the format of
$!variable.attribute
β
User
β
β
Issue
β
β
Attributes
β
β
Methods
β
β
IssueEvent
β
β
Comment
β
β
Changelog
β
β
ChangelogItem
β
β
Worklog
β
β
EmailCommand
β
β
Template Support
β
β
Project
β
β
IssueType
β
β
Status
β
β
Priority
β
β
Resolution
β
β
Timetracking
β
β
Attachment
β
β
Component
β
β
Version
β
β
CustomFieldValue
β
β
CustomField
β
β
FieldValue<T>
β
User
Attribute Name
Type
Description
β
String
Internal key of the user it is unique to the users.
β
String
Loginname of the user
β
String
Email address of the user
β
String
Display name of the user
β
boolean
true if the user account is active in Jira
β
String
URLs to user avatars in different sizes.
Issue
Attributes
Attribute Name
Type
Description
id
number
Internal ID of the issue
key
String
Unique Issue Key
summary
String
Issue summary
description
FieldValue<String>
Issue Description field with raw value and rendered format
environment
FieldValue<String>
Issue Environment field with raw value and rendered format
project
Project
Project of the issue
issueType
IssueType
Type of the issue
status
Status
Issue status
resolution
Resolution
Resolution of the issue
priority
Priority
Priority of the issue
timetracking
Timetracking
Timetracking details of the issue
creator
User
Creator of the issue. The Creater may be different from the Reporter as privileged users may create issues on behalf of others.
reporter
User
The user set as Reporter in the issue.
assignee
User
Current assignee.
created
FieldValue<Date>
Issue Created date field value with raw value and rendered format.
updated
FieldValue<Date>
Issue Updated date field value with raw value and rendered format.
resolutionDate
FieldValue<Date>
Issue Resolution date field value with raw value and rendered format.
dueDate
FieldValue<Date>
Issue Due Date field value with raw value and rendered format.
customFields
Collection<CustomFieldValue>
β
Methods
Signature
Return type
Parameters
Description
Example
getCustomFieldValue(customFieldKey)
CustomFieldValue
customFieldKey: key of the custom field
Returns a
API for Velocity Context Objects
- CustomFieldValue object representing the value of the custom field addressed by the key
$!issue.getCustomFieldValue('customfield_10116')
IssueEvent
Attribute Name
Type
Description
eventType
β
The type of the triggered event.(eg. issue created, issue commented, ...)
issue
β
API for Velocity Context Objects#Issue
β
The Issue which the event was fired on.
changelog
β
API for Velocity Context Objects#Changelog
β
β
worklog
β
API for Velocity Context Objects#Worklog
β
β
comment
β
API for Velocity Context Objects#Comment
β
β
timestamp
Date
The time when the issue was triggered
user
β
API for Velocity Context Objects#User
β
The user who triggered the event (added the comment, updated the issue, ...)
Comment
Attribute Name
Type
Description
id
Number
Internal ID of the comment
author
User
Author of the comment
updateAuthor
User
Update author of the comment
body
FieldValue<String>
Comment body
created
FieldValue<Date>
Creation date
updated
FieldValue<Date>
Update date
limitedVisibility
boolean
β
internalServiceDeskComment
boolean
β
publicServiceDeskComment
boolean
β
Changelog
Attribute Name
Type
Description
items
List<
API for Velocity Context Objects#ChangelogItem
>
A list of Changelog items
ChangelogItem
Attribute Name
Type
Description
created
β
β
field
β
β
fieldId
β
β
fieldType
β
β
from
β
β
fromString
β
β
to
β
β
toString
β
β
Worklog
Attribute Name
Type
Description
author
β
API for Velocity Context Objects#User
β
Author of the worklog
comment
β
FieldValue
<String>
The comment added to the worklog
created
β
FieldValue
<Date>
The date when the worklog was created
issueId
long
Id of the issue
started
β
FieldValue
<Date>
β
timeSpent
String
β
timeSpentSeconds
long
β
visibilityType
String
β
visibilityValue
String
β
updateAuthor
β
API for Velocity Context Objects#User
β
β
updated
β
FieldValue
<Date>
β
EmailCommand
Attribute Name
Type
Description
Template Support
Attribute Name
Type
Description
β
boolean
Returns true if the given user is an agent on the project, otherwise false.
Project
Attribute Name
Type
Description
IssueType
Status
Priority
Resolution
Timetracking
Attachment
Component
Version
CustomFieldValue
Attribute Name
Type
Description
customField
API for Velocity Context Objects#CustomField
Reference to the CustomField
renderedValue
String
The value in html as visible in Jira
value
β
Contains the raw value of the field.
Type is the type of declared in Jira. One of
Date
String
User
Collection<User>
CustomField
Attribute Name
Type
Description
customId
Long
β
β
String
key of the custom field. This is the primary identifier used by Email This Issue. (eg. in macro parameters)
The format is customfield_$id.
itemType
String
β
type
String
β
FieldValue<T>
Attribute Name
Type
Description
rawValue
T
Contains the raw value of the field.
Type is the type of declared in Jira. One of
Date
String
User
Collection<User>
renderedValue
String
The value in html as visible in Jira
General - Previous
API
Next
API for Velocity Context Objects
Last modified
6mo ago
Copy link
Outline
User
Issue
Attributes
Methods
IssueEvent
Comment
Changelog
ChangelogItem
Worklog
EmailCommand
Template Support
Project
IssueType
Status
Priority
Resolution
Timetracking
Attachment
Component
Version
CustomFieldValue
CustomField
FieldValue<T>