Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

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

Image RemovedConfiguration

UI Expand
titleFrom

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

    UI Text Box
    typenote

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

    UI Expand
    titleSending mode

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

  • Default
  • Personalized

    UI Text Box
    typeinfo

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

    UI Expand
    titlePriority

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

    UI Expand
    titleTo

    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

    UI Text Box
    typenote

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

    UI Expand
    titleCc

    Define and configure the recipients in CC of the email.

    The same options like above are available.

    UI Expand
    titleBcc

    Define and configure the recipients in Bcc of the email.

    The same options like above are available.

    UI Expand
    titleEmail content
    UI Expand
    titleSubject

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

    UI Expand
    titleEmail format

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

    UI Expand
    titleBody

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

    UI Text Box
    typetip
    • 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()}}}.
    UI Expand
    titleAttachments

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

  • None
  • All issue attachments

  • All transition attachments

    UI Text Box
    typeinfo

    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.

    UI Expand
    titleAdditional 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)
    UI Expand
    iconfalse
    titleConditional execution
    include

    DECADIS:_snip_condExecution_ServerDECADIS:_snip_condExecution_ServerImage Removed


    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
    title
    To
    TO

    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
    title
    Cc
    CC

    Select additional CC recipients.

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


    UI Expand
    title
    Bcc
    BCC

    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

    temporary

    the Temporary text fields (1-5). The information will be stored as follows:

    • Temporary text field 1: From
    • Temporary text field 2:
    To
    • TO
    • Temporary text field 3:
    Cc
    • 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



    Image ModifiedUse cases and examples

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


    Excerpt Include
    DECADIS:Contact support
    DECADIS:Contact support
    nopaneltrue


    Page properties
    hiddentrue


    Tech review

    Status
    colourYellowGreen
    titleReady for reviewdone

    Style guide

    Status
    colourYellowGreen
    titleReady for reviewdone

    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