You can add, edit or test an email template using the tempate toolbar , or navigate to the /comms/templates URL to access all the email templates.
The template editor
The template editor opens when you add or edit a template. You edit the following information required for a complete template.
- The name of the template. It must be unique amongst all the templates for the same application;
- The application which the template belongs. The application cannot be changed for saved templates;
- The type of template:
- Default: this type of template is editable using the HTML editor. It supports simple data binding using {xxx} syntax;
- Razor: select this template type to create a template and implement programming logic to generate output. The composed the template must conform to the Microsft Razor page syntax. The reference of the razor syntax can be found here: https://docs.microsoft.com/en-us/aspnet/core/mvc/views/razor?view=aspnetcore-3.0
Discover the data available for binding
The template takes a set of data as input when it is rendered. However, the structure and fields of the input data set depends on the application that renders the template. You can use the following steps to discover what is available for binding in the particular operation:
- Create a template and select the "Default" template type;
- Add {*} to the template body and save the template;
- Navigate to the application's template configuration page, e.g. OneList notification channels, RoleManager email settings, and select the newly created template for the operation;
- Click the Test Mail button on the template toolbar;
- The the full data set is displayed as JSON.
- Use the JSON as the reference for creating the data bindings in your template.