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