| Table of Contents |
|---|
Summary
Jira users, groups and non-Jira user email addresses can be dynamically added as recipients of Issue, Ad Hoc or Post Function notifications using Velocity scripts. The main use case for this feature is when you depend on the event's context (containing issue data) to conditionally add extra notification recipients. This allows you to do things such as notify managers when the issue's priority is Critical.
...
Recipients scripts can be added to Ad-hoc and Post Function Notifications as TO, CC or BCC. Each script resolves the recipients for each type. For example, a recipient added via the CC script will receive the email as a CC recipient.
Velocity contexts and notification mechanisms remain the same in all three notification types (Issue, Ad-hoc and Post-function notifications).
...
The following examples can be used in Issue, Ad-hoc and Post-function notifications:
| Code Block | ||
|---|---|---|
| ||
##Use values from a given select custom field
#foreach ($item in $context.issue.fields.customfield_10265)
$recipientUtils.addEmailRecipients($item.value.asText())
#end
##If the event is an issue created event, notify a non-Jira email address
#if ($context.webhookEvent.textValue() == "jira:issue_created")
$recipientUtils.addEmailRecipients("scripted@example.com")
#end
##If issue priority is blocker and type is bug, notify Jira user johnfixall
#if ($context.issue.fields.priority.name.textValue() == "Blocker" && $context.issue.fields.issuetype.name.textValue() == "Bug")
$recipientUtils.addUserRecipients("557058:a8d85d49-2566-47f4-9f31-861930631857")
#end
##If issue is of project SD, notify email users devLead@mycompany.com and testLeader@mycompany.com
#if ($context.issue.fields.project.key.textValue() == "SD")
$recipientUtils.addEmailRecipients("devLeader@mycompany.com,testLeader@mycompany.com")
#end
##If issue priority is Major, notify support level 3 group
#if ($context.issue.fields.priority.name.textValue() == "Major")
$recipientUtils.addGroupRecipients("support-level-three")
#end
##If issue priority is Minor, notify support level 1 and level 2 groups
#if ($context.issue.fields.priority.name.textValue() == "Minor")
$recipientUtils.addGroupRecipients("support-level-one,support-level-two")
#end
##If operation was made by CEO user or issue reporter's CEO user, notify management
#if ($context.user.key.textValue() == "ceo" || $context.issue.fields.reporter.key.textValue() == "ceo" )
$recipientUtils.addGroupRecipients("management")
#end |
| Note |
|---|
Adding a group by script ( |
| Info |
|---|
In order to know the account id of a particular user, you can use the User Finder tool in JEMH Cloud → Tools → Cloud > Tools > User Finder. Copy and paste the account id into the script when adding users programmatically. |
...
You can see these events and the processing outcome by going to JEMHC configuration → > Auditing → > Events.
...
After being processed, an event will have a report showing the recipients resolved, notifications sent and the any problems or warnings found. Use these reports to validate the recipients the script has resolved. The below is an example of an Event Report taken from JEMHC → > Auditing → > Events. As you can see, one of the notification recipients has "(Script)" after their address, which signifies that this recipient was added due to the use of a velocity script.
...
| Warning |
|---|
Re-running an event will resend the emails. To avoid spamming your users, use a test mail server like mailtrap or disable the mail server by going to Notifications Messaging → Message Outbound. |
Related articles
...