Summary
Email Templates allow you to configure commonly used emails with bookmarks so you can send standard emails from within your solution.
Navigate to System Setup → Company → System Email Templates:
AppBase has two built-in system email templates:
- ResetPassword
- InitiateChangeLogin
There is no option to create system email templates on the UI. They are created once when creating a tenant. But some system email template fields can be modified in UI(click Edit action). Edit Email Template page allows to modify following fields:
- Sender
- Subject
- Body
- Description
By default, system email template fields appear blank. If the fields have not been changed and remain empty, they always take their default values. Usually the default values are loaded from the configuration and may differ between templates. The default fields values for different templates and the custom values they can accept will be described below.
ResetPassword
This template is used to send an email with a password reset link. It is possible to initiate sending a letter using Reset Password button on the User Detail page or Forgot Password link on Login page.
Edit Email Template
Due to current implementation ResetPassword email template field always have default values loaded from configuration regardless of whether they have been changed on UI or not. Default field values are described in the table below:
Field Name | Default value | How to change value |
---|---|---|
Sender | <NoReplyEmail> placeholder value in the configuration | Cannot be changed in UI. If you need to change this value, change the value of the placeholder <NoReplyEmail> located in configuration file, make reconfiguration and restart AppBase. |
Subject | "AppBase password" | Cannot be changed and always has default configured value. |
Body | Loaded from a static file RepairPasswordEmailPattern.txt. Hi, {0}! where {0} is First Name, {1} is reset password link. | Cannot be changed in UI. If you need to change this value, change the RepairPasswordEmailPattern.txt static file content with following location: <AppBase instalation directory>/Applications/Templates/AutoProvisioning/RepairPasswordEmailPattern.txt. |
InitiateChangeLogin
This template is used to send an invitation email to the user after click Invite User on User Detail page.
Edit Email Template
InitiateChangeLogin email template field have default values loaded from configuration which can be changed to custom values. See more details in the table below:
Field Name | Default Value | How to change value |
---|---|---|
Sender | <NoReplyEmail> placeholder value in the configuration | Cannot be changed in UI. If you need to change this value, change the value of the placeholder <NoReplyEmail> located in in configuration file, make reconfiguration and restart AppBase. Please do not change the value of this field on the UI. This can lead to problems with sending invitation emails. If you need to change this value, change the placeholder value as described above. |
Subject | "Membership type change has been initiated" | Can be changed in UI to any plain text. |
Body | Loaded from a static file InitiateChangeUserTypeEmailPatternFile.txt:<p>Dear @@FIRSTNAME@@ @@LASTNAME@@</p><br />
| Cannot be changed in UI. If you need to change this value, change the RepairPasswordEmailPattern.txt static file content with following location: <AppBase instalation directory>/Applications/Templates/InitiateChangeUserTypeEmailPatternFile.txt. The email template body can contain both plain text and HTML-markup with placeholders (in the format @@PLACEHOLDERNAME@@). The placeholders values are specific for each user. More information about placeholders see below |
Email template body text contains following placeholders:
Name | Description | Example |
---|---|---|
@@FIRSTNAME@@ | It equals to user's first name and is specific for each user. | Nina |
@@LASTNAME@@ | It equals to user's last name and is specific for each user. | Nazarova |
@@LOGIN@@ | It equals to user's login and is specific for each user. | nnazarova |
@@INVITATIONCODE@@ | f82b4275c756403693d61941e99c11f3 | |
@@INVITATION_URL@@ | Invitation url depends on auth configuration type. Exists for SAML and OAuth, for other types is empty | For SAML: https://gateway-denys.eccentex.com/ecx.web/account/sso?tenantCode=60&authCode=604a06ac-243a-411d-a4b4-e74fb8399b4c For OAuth: https://gateway-denys.eccentex.com/ecx.web/account/oauth?tenantCode=tenant1&authcode=cf877839-77fe-4595-bdf0-582852b8b3cc |
@@SITEROOT@@ | Due to current implementation always is empty | |
@@EXPIRATIONDATE@@ | Invitation expiration date. Due to current implementation always is empty |
Examples
Template Body | Received Email View |
---|---|
<p>Dear @@FIRSTNAME@@ @@LASTNAME@@</p><br /> |