Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Versions Compared

Old Version 2

changes.mady.by.user Iheb Kharab

Saved on

compared with

New Version Current

changes.mady.by.user Thorsten Letschert

Saved on

Key

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


Panel

On this page

Table of Contents
exclude(On this page|Filter by field value|Remaining estimate).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

The Send an email This post function allows you to easily send an email with custom Subject and Bodycustom subject and body, setting recipients by means for fields, custom fields, groups, project roles, or simply fixed email addresses.

You can send with your emails optionally choose to include all or some of the attachments in the issue attachments. 

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


Configuration

UI Expand
titleFrom

Select the email address the email

UI Text Box
typenote

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

From*

When selected,
Info
iconfalse

Select the mail address the mail 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 manually
Expand
titlemore info...
Enter a valid
mail
email address
* must be entered.
.



UI Expand
titleSending mode
*
Info
iconfalse

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

Default
Option
Personalized
Description
Expand
title
DefaultChoose this option if all recipient should receive the same content.
Personalized
more info...

When selected, a dedicated

mail

email will be sent out to each recipient.

Priority*

UI Text Box
typeinfo

The list of all recipients will be undisclosed.




UI Expand
titlePriority

Select

Info
iconfalse
Choose

the priority of the outgoing email

between

. The available options are High, Default, or Low.

To*


When chosen, enter valid
UI Expand
titleTO
Info
iconfalse

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

Expand
titlemore info...

Enter one or multiple email addresses as a comma

-

separated list.



UI Expand
titleCcCC

Select additional CC recipients.

The options you can choose from are identical to the options provided aboveDefine and configure the recipients in CC of the email.


UI Expand
titleBcc

Define and configure the recipients in Bcc of the email.

BCC

Select additional BCC recipients.

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


UI Expand
titleEmail content

Subject

Info
iconfalse

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

Email format*

false

 

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

Info
icon

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

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

Body

Info
iconfalse

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

Expression parser functions can also be used by writing them within three curly braces
UI Text Box
typetip
  • You can try your expression by clicking on the play button on the top right of the JQL expression box.

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

    .

    Attachments

    *When

    Info
    iconfalse

    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 attachments
    Select this option if you only want to include the files attached to the issue during the current transition.


    UI Text Box
    typeinfo

    If

    Expand
    titlemore info...

    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
    TO recipients as watchers
    - Add to recipients

    Choose this option if you want to add the recipients specified in the TO parameter as watchers of the current issue, if

    those

    they are valid Jira users.

    Add
    Cc
    CC recipients as watchers
    - Add Cc recipients

    Choose this option if you want to add the recipients specified in the CC parameter as watchers of the current issue,

    is those

    if they are valid Jira users.

    Temporary
    Temporarily store email information
    - Store email information in the temporary fields

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



    Enter a condition (Logical / boolean condition) using the JWT expression parser - full feature list syntax.

    You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

    The post function will only be executed if the condition is met (returns true).
    UI Expand
    iconfalse
    titleConditional execution
    Note

    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



    Image AddedUse 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