You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

The Send an email 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 customer, or any user you can think of.

Configuration

From

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

  • Based on the outgoing email configuration
  • Based on the project configuration
  • Selected user
  • User in field
  • Email address in field
  • Set email manually

    When selected, a valid email address* must be entered.

Sending mode

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

  • Default
  • Personalized

    When selected, a dedicated email will be sent out to each recipient. The recipient won't see any other recipients' email addresses.

Priority

Choose the priority of the email between High, Default, or Low.

To

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

  • Add field containing users
  • Add field containing email addresses
  • Add project roles
  • Add groups
  • Set recipients manually

    When selected, enter valid email addresses as a comma-separated list.

Cc

Define and configure the recipients in CC of the email.

The same options like above are available.

Bcc

Define and configure the recipients in Bcc of the email.

The same options like above are available.

Email content
Subject

Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.

Email format

Select the format of the email, either Text or HTML.

Body

Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.

  • You can try your expression by clicking on the run button on the top right of the expression box.
  • Expression parser functions can also be used by writing them within three curly braces e.g. {{{subtasks()}}}.
Attachments

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

  • None
  • All issue attachments

  • All transition attachments

    When one of the last two options is selected, you can filter the files by size, type, and name. Files that do not match the filters will be skipped.

Additional options
  • Add to recipients as watchers - Add to recipients as watchers of the current issue, if those are valid Jira users.
  • Add Cc recipients as watchers - Add Cc recipients as watchers of the current issue, is those are valid Jira users.
  • Temporary store email information - Store email information in the temporary fields 1-5.
    • 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)
Conditional execution

You can optionally specify a logical expression to define the circumstances (or conditions) under which the post function should be executed.

The result of the logical expression must return a boolean value of either:

  • true → the post function will be executed
  • false → the post function will not be executed

Using the conditional operator, even complex or multi-layered conditions can be constructed.

Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode

Configuration

From

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.

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

The list of all recipients will be undisclosed.

Priority

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

To

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

OptionDescription

Add field containing users

Select the field containing individual users

You can either select a user-related field (user picker custom fields, assignee etc.) or select a temporary field containing users. 

Add field containing email addressesSelect the field containing the email addresses. 
Add project rolesSelect a specific Jira user.
Add groups

Select the field containing the user.

Text fields must return a user name.

Set recipients manually

Select the field containing the email address.

When selected, enter valid email addresses as a comma-separated list.

  • Add field containing users
  • Add field containing email addresses
  • Add project roles
  • Add groups
  • Set recipients manually

    When selected, enter valid email addresses as a comma-separated list.

Cc

Define and configure the recipients in CC of the email.

The same options like above are available.

Bcc

Define and configure the recipients in Bcc of the email.

The same options like above are available.

Email content
Subject

Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.

Email format

Select the format of the email, either Text or HTML.

Body

Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.

  • You can try your expression by clicking on the run button on the top right of the expression box.
  • Expression parser functions can also be used by writing them within three curly braces e.g. {{{subtasks()}}}.
Attachments

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

  • None
  • All issue attachments

  • All transition attachments

    When one of the last two options is selected, you can filter the files by size, type, and name. Files that do not match the filters will be skipped.

Additional options
  • Add to recipients as watchers - Add to recipients as watchers of the current issue, if those are valid Jira users.
  • Add Cc recipients as watchers - Add Cc recipients as watchers of the current issue, is those are valid Jira users.
  • Temporary store email information - Store email information in the temporary fields 1-5.
    • 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)
Conditional execution

You can optionally specify a logical expression to define the circumstances (or conditions) under which the post function should be executed.

The result of the logical expression must return a boolean value of either:

  • true → the post function will be executed
  • false → the post function will not be executed

Using the conditional operator, even complex or multi-layered conditions can be constructed.

Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode


Use cases and examples


If you still have questions, feel free to refer to our support team.