Email templates
For certaing situations Datastorms communicates with email to end users. This way end users are invoked to take action or to inform them about things happening. Default email templates are provided, but it is possible to modify these.
You must have the Organisation Security Admin role to perform this action.
Kind of email templates
For the communication with the end user there are multiple email templates in use:
| Template | Usage |
|---|---|
| Forgot password | When user clicks on password forgotten. |
| Inivitation | When user is created and invited for first-time access to Datastorms. |
| Password change | Message the user his password is modified. |
| Two factor code email | Send temporary two factor code by email. |
| Change of email address | Message the user his email address is modified. This email is send to his old email address. |
| Untrusted device | Message the user his account is used from an untrusted device. Without approval of this device, the end user cannot login. |
Datastorms always provides default email texts in English. However, it is possible to modify the templates.
Placeholders for email
Datastorms can add variable data to the email text by means of Placeholders. A placeholder is used with mustach-brackets around it. Example:
Dear {UserFirstName} {UserLastName},
Default a placeholder is available for every email template. Only a few exceptions exist. Below the placeholders are explained and the exceptions are mentioned.
UserFirstName
First name of the user as set in the user administration.
UserLastName
Last name of the user as set in the user administration.
ButtonResetPassword
This placeholder only works with the Forgot password email template.
This placelholder will add a button to the email stating "Reset password". When the end user clicks on this button, he is send to a special link for resetting his password.
The reset password link expires in 15 minutes.
Logo
Add the logo as set on the first tab of email-templates. Default a Datastorms logo will be used.
URL
The URL to the Datastorms environment. For instance example.datastorms.eu.
OrganisationName
The name of the organisation as set in the general settings.
ButtonInvitation
This placeholder only works with the Invitation email template.
This placelholder will add a button to the email stating "Activate account". Clicking the button opens the invitation link in a web browser.
ButtonApproveOrDecline
This placeholder only works with the Untrusted devices email template.
This placelholder will add a button to the email stating "Approve/decline device". Clicking the button opens a link in a web browser where more details can be found about the unkown device. In case this is the device of the end user, he can approve the device. Else he can decline it.
DateOfLastLoginWithDevice
This placeholder only works with the Untrusted devices email template.
To show the last login datetime of the untrusted device.
Code
This placeholder only works with the Two factor code email template.
Add the two factor authentication code to the email.
The two factor code expires in 15 minutes.
OldEmailAddress
This placeholder only works with the Change of email address email template.
Show the old user email adress in the email. The end user cannot use from now on this email address to login in Datastorms.
NewEmailAddress
This placeholder only works with the Change of email address email template.
Show the new user email adress in the email. The end user must use from now on this email address to login in Datastorms.
OS
This placeholder only works with the Untrusted devices email template.
Show the OS-version of the device which tried to login to Datastorms and was blocked because untrusted.