Create Mail Template [2.0.x]
When creating a template, please consider following the advice described on Incoming Emails Support [2.4.x] page (point 3), by adding a tip to a created template that email must be replied to an address the same, as you set in an email handler.
In order to create mail template perform Create mail template action by following the below presented steps.
1) Please left click on "Projects" and from the drop-down menu select a project that you wish to work in:
2) Click "Add-ons" to uncloak "Mail Templates" option and then access it. Next simply click on "Create" button:
3) The Create Email Task wizard opens:
Description of fields:
Issue type - This field defines for which issue, mail template will be in use. Each issue can be of different issue type. In turn each issue type can have different set of fields and therefore we have to make a distinction between mail templates. Mail Template dedicated for example for a „Bug” issue type can be invalid for another issue type such as „Improvement”. While creating mail template user can insert some variables relevant for selected issue type which represents OOTB issue fields. Another issue type may lack of some of those fields – that is why we define mail template only for one particular issue type.
Name - This field is obligatory. Here you can enter anything that will be helpful for you to recognize particular mail template. This field doesn’t have to be unique across all projects and even in the same project. Internally each mail template is in fact represented by its unique ID (not by its name).
Subject - This field becomes subject of the mail. You can type here anything you want in form of plain text as well as insert some variables which will be replaced by real values during mail template rendering. Variable list can be discussed later.
Content - This field becomes body of the mail. Similarly as for subject field you can type here any message and additionally insert some variables which will be replaced by real values while rendering mail template.
Format as - Possibility to select if the email is to be sent in HTML or Plain Text format. For full incorporation of rich text editor possibilities HTML is recommended.
To - Possible to be filled after clicking on "Manage" button. You can type here user emails, logins (unique user names), groups, fields (drop-down menu with possibility to choose fields present for particular issue type that was selected at the beginning of the previous screen). You are provided with auto assistant during typing for your convenience. This field will be auto-mapped with „To” field of your mail client as well as the recipient. All users selected in this field will be considered as recipients of the mail rendered based on an mail template.
CC - Carbon Copy. Similarly as for previously described field, this element also has also been provided with an auto assistance feature, but the aim of this field is slightly different. It represents users which you want to include in mail recipients but original message is targeted to someone else. In other words it's for someone information only, so no steps are required of a CC recipient.
BCC - Blind Carbon Copy. Similarly as for previously described field, this element also has also been provided with an auto assistance feature, but the aim of this field is slightly different. It represents users which you want to include in mail recipients but original message is targeted to someone else. In other words it's for someone information only, so no steps are required of a BCC recipient. This field is totally invisible in the recipients' email message, so people are not aware that a person from BCC received it.
Reply To - "Reply to" is the email address to which replies should be sent. It can be Default or Custom. When the Reply to is set to Default, the "Reply to" field in email is set to an email address of a sender. By selecting custom you get an immediate possibility to enter new email address.
Preview - before creating please make sure that all is filled as desired.
Create - final step - after pressing it, mail template is created.
For further information please check Mail Templates' Fields [2.0.x]
Feel free to tell us what topic should be covered: mailtask@psc-software.atlassian.net