...
...
Warning |
---|
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here ! |
Configure the Mail Sender
Excerpt |
---|
The mail sender configuration refers the mail templates directory and templates localization. |
When accessing Mail Sender Configuration link, you will see the following screen:
Note |
---|
On the cloud version, the only options for the "Send mail via" are the Null sender and the Direct Sender, custom": |
Email Templates
Emails may be sent in multiple languages based on the sender's language or on the receiver's language. The emails templates are placed on disk, in a directory specified by you and must follow the steps below to get picked correctly by the SIL engineEngine™.
Let's see an example to understand how it works. Resolution of the file mytemplate.tpl for a given language (let's use French/France) is performed like this:
...
Within the templates any standard or custom field defined in the issue that called the routine can be referenced using the notation $field$. In fact starting with version 4.0 we expanded this notation and created a meta language named STL (not from Standard, but SILSIL™). This language allows embedding snippets of SIL SIL™ within the template. So, for instance, you can output multiple rows in a html table. You can read more about STL in a dedicated chapter.
Tip | ||
---|---|---|
| ||
You can create, edit, delete email templates using the built-in editor. |
Email Sender
There are 4 email senders available:
Mail Sender | Description | When to use |
---|---|---|
Container Sender | Uses Jira to send mails; mails are enqueued in the standard Jira queue and the call returns immediately | In most cases, this is what you should use. It offers good performance and it relies on the standard Jira mechanism. |
Direct sender, custom | Connects to the SMTP server and sends the mail. You need to specify the mail server parameters | You need to configure another mail server for the mails and you want to wait for the send confirmation to arrive before continuing your |
SIL™ program | ||
Direct sender, defaults | Same as above, but takes the configuration from Jira SMTP server | You just want to wait for the send confirmation to arrive before continuing your |
SIL™ program. | ||
Null sender | Logs messages to be sent in the Jira log | Debug and Development |
Note that a mail that has been successfully sent does not mean that the recipient got the mail. It can be rejected for multiple reasons. SMTP does not guarantee delivery!
...
These parameters are standard, and you can select between the 'smtp' and 'smtps' protocols, specify the SMTP host server and port, as well as the authentication tokens (username / password). If you are unsure what to fill in in this form, ask your network administrator to provide details of your company mail setup.
See also
...