Add and localize a new e-mail template

Info

Only four types of notification templates can be added:

To a client: When deliverables from one task are sent to the Client
To a user:
- When nobody has approved an availability request
To a vendor:
- When job is started
- When job is started with previous job partially finished.

Only those notification templates can be set as default or non-default. All other notification templates are always the default ones.

The listed templates can be assigned to clients, users, and vendors in the following areas:

User, client, and vendor-related - in Configuration menu > Projects and Quotes > Workflow Definitions (Classic) > Notifications tab.
Client-related - in Client’s profile > Main Data tab > Templates subtab.
Vendor-related - in Vendor’s profile > Main Data tab > Templates subtab.

To create a new template that will be used in your e-mails, perform the following steps:

Go to the Configuration menu → Templates → Notifications → Templates tab.
Click the Add button on top of the Templates table. You will be directed to the Add E-mail/Text Message Template page.
Select the desired template’s Type.
The When external process action is completed template is deprecated.
Select the template’s Theme. To learn more about notification template themes, see theAdd a custom theme for e-mails section below.
Decide whether this template should be Active and thus selectable.
Decide whether this template should be a Default one.

Info
The default templates cannot be deleted.
Provide the template’s Name.
Edit the standard template in the E-mail section using the available formatting options.
Image Modified
To add XTRF tags, click the icons.
Images can be added to the templates through links only. For details, see the How to insert an image into an e-mail notification template guide.
To add a footer, use the ${FOOTER} tag. The footer can be configured in the Create a custom footer for e-mails section below.
(Optional) Click the Source button to edit the HTML code directly.
Image Removed
Image Added
Keep
Please keep in mind that pasting the copied text in the default editor will also paste the text styling, which may cause problems for some values (e.g., when checking if the text is equal to other text or when entering Custom Fields "Key" names).
Click the Save button.
(Optional) In the E-mail Preview section on the right, you can check how the notifications will be displayed when the new template is applied. To do so, locate and select any job or task number in the search-as-you-type Job / Task field.
Image Modified
(Optional) Add localized notification templates:
Image Modified
From the Add Localization drop-down list, select the desired language and click the icon.
Provide the necessary changes to the template.
Click the Save button.
Info
To restore the content of the notification template, click the Restore E-mail and text message button at the bottom of the page. To restore the content of several templates, use the Multiple change option in the Configuration menu → Templates → Notifications → Templates tab.
XTRF has several templates already localized for several languages. To check and activate those notifications, open a template and uncheck the Show active only box on the language pane on the left. Then select the desired language and check the Active Language Version box. To activate several languages at once, use the Multiple change option in the Configuration menu → Templates → Notifications → Templates tab. To delete a language version, click the Delete Language Version at the bottom of the template page.
Note
IMPORTANT!
The Default language of the templates and themes is the language of your Home Portal. You don’t need to activate the localized version of this language, and we recommend against such activating, as it may result in confusing templates.
Add a custom e-mail theme
Go to the Configuration menu → Templates → Notifications → Themes tab.
Click the Add button on top of the Themes table. You will be directed to the Add E-mail Theme page.
Decide whether this theme should be a Default one.
Provide a Name for the new theme.
In the E-mail Content section, add the necessary elements using the available formatting options.
(Optional)Click the icon to add XTRF tags.
Images can be added to the themes through links only. For details, see the How to insert an image into an e-mail notification template guide.
In the Theme style section, define the styles of the elements using the CSS language.
Click the Save button.
(Optional) To delete a theme, restore its original content, or restore the theme style, click the corresponding buttons at the bottom of the page.
Info
Notification themes can be localized in the same way as the notification templates (see the
Add a custom e-mail footer
Go to the Configuration menu → Templates → Notifications → Footer tab.
Click the Edit button. You will be directed to the Expression - Common E-mail Footer page.
Image RemovedImage Added
Select the desired language version on the left and provide the content of the footer on the right.
(Optional)Click the icon to add XTRF tags.
Images can be added to the footers through links only. For details, see the How to insert an image into an e-mail notification template guide.
Click the Save button at the bottom of the page.
(Optional) To restore the original footer content, click the Restore button at the bottom of the page.