Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
sizemedium
typeinfo

This post function allows you to easily send an email with custom subject and body, setting recipients by means for fieldscustom fieldsgroupsproject roles, or simply fixed email addresses.

You can optionally choose to include all or some of the issue attachments.

You could use this post function to easily email a customized issue report to the assignee, reporter, service desk customerproject customer, or any user you can think of.


Configuration

UI Expand
titleFrom

Select the email address the email will be sent from. The following options are available:

OptionDescription

Based on the outgoing mail configuration

The default user specified in you outgoing mail server configuration will be used.
Based on the project configurationThe user specified in your project notifications.
Selected userSelect a specific Jira user.
User in field

Select the field containing the user.

UI Text Box
typeinfo

Text fields must return a user name.


Email address in field

Select the field containing the email address.
Set email manuallyEnter a valid email address.



UI Expand
titleSending mode

Select how the email will be sent. The following two options are available:

OptionDescription
DefaultChoose this option if all recipient should receive the same content.
Personalized

When selected, a dedicated email will be sent out to each recipient.

UI Text Box
typeinfo

The list of all recipients will be undisclosed.




UI Expand
titlePriority

Select the priority of the outgoing email. The available options are High, Default, or Low.


UI Expand
titleTO

Define and configure the recipients of the email. The following options are available:

OptionDescription

Add field containing users

Select one or multiple fields containing users or groups. 

UI Text Box
typeinfo

Text fields or Temporary text fields must return a user name or a comma separated list of user names.


Add field containing email addressesSelect one or multiple fields containing a single email address or a comma separated list of email addresses.
Add project rolesSelect one or multiple project roles. The email will be sent out to all members that have access to the issue.
Add groups

Select one or multiple groups. The email will be sent out to all members that have access to the issue.

Set recipients manually

Enter one or multiple email addresses as a comma separated list.



UI Expand
titleCC

Select additional CC recipients.

The options you can choose from are identical to the options provided above.


UI Expand
titleBCC

Select additional BCC recipients.

The options you can choose from are identical to the options provided above.


UI Expand
titleEmail content

Subject

Enter plain text and optionally use field codes to insert field values. 

UI Text Box
typetip

The expression has to be written in Mixed mode which supports the usage of parser functions between three curly braces, e.g. {{{subtasks()}}}


Email format

Select the format of the email. The available options are Text or HTML.

If you select HTML, an HTML preview of the email body will be displayed automatically.

Body

Enter plain text and optionally use field codes to insert field values. 

UI Text Box
typetip

The expression has to be written in Mixed mode which supports the usage of parser functions between three curly braces, e.g. {{{subtasks()}}}

Attachments

Select the files to attach to the email. The following options are available:

OptionDescription
None

Attachments will not be added to the outgoing email.

All issue attachments

When selected, all files attached to the issue will be included in the outgoing email

All transition attachmentsSelect this option if you only want to include the files attached to the issue during the current transition.


UI Text Box
typeinfo

If one of the last two options is selected, you can additionally filter the files by size, type, and name.

Files that do not match the filters will be skipped.



UI Expand
titleAdditional options

The following additional options are available:

OptionDescription
Add TO recipients as watchers

Choose this option if you want to add the recipients specified in the TO parameter as watchers of the current issue, if they are valid Jira users.

Add CC recipients as watchers

Choose this option if you want to add the recipients specified in the CC parameter as watchers of the current issue, if they are valid Jira users.

Temporarily store email information

Choose this option if you want to temporarily (for the duration of the transition) store the specified parameters in the Temporary text fields (1-5). The information will be stored as follows:

  • Temporary text field 1: From
  • Temporary text field 2: TO
  • Temporary text field 3: CC
  • Temporary text field 4: Email subject
  • Temporary text field 5: Email body (text format)
Exclude default prefix from email's subject

Choose this option to remove the email prefix that has been set in the Outgoing mail configuration (e.g. JIRA).



UI Expand
iconfalse
titleConditional execution

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server


UI Text Box
typenote

This post function needs to be executed before firing an event of a transition



Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and ancestor = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged


Page properties
hiddentrue


Short descriptionSend an email with custom content.
Label

Status
colourRed
titlestaff pick