Notification Templates
What are Notification Templates?
Notification templates are used to create automatic emails that are sent to system users and New Hires after certain actions occur. System Administrators, Process Administrators, and Content Administrators can modify these templates by changing the subject and/or content of the email message. However, Content Administrators can only create or modify the content itself; they will need assistance from a System Administrator or Process Administrator to implement the modified content within the process.
How do you create a new Notification Template?
Follow the steps below to create a new Notification Template and add it to the onboarding process. To create a Notification Template, either create a new Content Revision or use an existing one.
Click the menu icon on the top left corner of the page and select the "Create Revision" option from the navigation menu. Another way is, click the "Add/Update Revision" link on the quick links bar.
Click "Add a New Value".
Enter the information on the Manage Revision page, select "Content" as the Type, and then click "Reserve".
Click the "Configure" button to add the content.
Under Content Metrics, click the "Add" link for Notification Templates.
Enter the details for fields 1 through 3.
Item | Item Name | Description |
---|---|---|
Description |
| |
Priority |
| |
Sender |
| |
Subject |
| |
Content |
|
Click on "Add/Edit Subject".
Enter the subject line and insert binds if necessary. Place your cursor where you would like to add the bind, and click "Insert Binds".
Click the 'Look Up' button and select the bind variable.
The Lookup binds page open as below. You can select the variable by expanding the tree structure or using "Search Binds" lookup.
When "Search Binds" lookup is clicked, the search fields display to search for the variable.
Select any operator and enter the text that needs to be searched in the search field. You can use Variable ID or Description fields for searching.
In this case, "Description" field is used for searching the variable "First Name". Bind variable matching the search criteria are shown. Click the bind that you would like to include in the text.
Another option is to navigate through the tree structure to find the bind. Click on "Display as Tree" button to return to the tree structure.
Search for the variable in the tree structure, and click on the variable link.
After the bind is added to the pop-up page, click "OK".
The bind will be inserted in the subject as shown below. When you click on 'Highlight Binds', you will see all the binds included in the text highlighted in yellow. Continue with any additional changes in the text and then click on "OK". This will add the subject on the Notification Template page.
Now, add the email content by clicking the "Add/Edit Content" link.
Enter the email message content, using the available options to customize the design, including binds, and then click "OK".
Add/Edit Content Page |
---|
Review the information, change anything that needs to be edited and then save.
Notification Template Page |
---|
Click the "Return to Manage Revision" button.
Content Revision Page |
---|
Apply the revision. This notification can be added to the onboarding process through the "Configure Events and Notifications" section of a Process Revision. Please refer to the following sections for more details.
Manage Revision Page |
---|
How do you modify an existing Notification Template?
To modify an existing Notification Template, create a new Content Revision or select an "In progress" Content Revision. On the Content Revision page, click the "Review/Update" link for Notification Templates.
Select the template that you want to modify.
The above notification template is used to send an email to the HR Admin when the candidate submits his/her onboarding information for review.
The content of the above notification template can be seen in this sample email.
When you select the notification template to modify, the content opens as shown below. If you have selected a delivered notification template to modify, then the description automatically populates with suffix "[Revised]".
If you are modifying the template that is not delivered (created through revision), then you need to manually add "[Revised]" to the description to differentiate it from the main template. This will avoid duplicate content names appearing in the Notification Templates lookup and makes it easy to identify the modified template.
Note: After adding the suffix, if the description exceeds 120 characters then the extra characters get truncated.
Check the description of the modifying template in the following example. Since we are modifying the delivered template, the suffix "[Revised]" is automatically added by the system in the template description.
Make changes to the template subject and/or content as necessary. Click the "Add/Edit Subject" link to modify the subject.
Edit notification subject as you want and click OK.
Click the "Add/Edit Content" link to modify the email content.
After adding/modifying the text, click "OK".
On the Notification Template page, click "Save" to apply the changes.
On the Content Revision page, click the "Return to Manage Revision" button to return to the revision main page.
Click the "Apply" button to apply the changes.
The sample email after the template change is given below:
Which Notification Templates included in the standard product can be modified?
The table below lists some of the delivered Notification Templates that can be modified.
Notification Template | Description | How Used |
---|---|---|
INV_ACCT_CREATE_EMAIL_USERID | Account creation email with User ID | Email sent to a user with authentication User ID |
INV_ACCT_CREATE_EMAIL_USERPSWD | Account creation email with password | Email sent to a user with Password |
SM_CO_USR_LAUNCH_RICH_TMPL | User Self Registration | Email that is sent to a System Administrator or any other Administrative or Business User after being invited (rich text). |
SM_CO_USR_SELFREG_TEMPLATE | User Self Registration | Same as the previous, but without rich text. This is not in use when delivered. |
SM_CO_NTF_SELFREG_SUCCESS_TA | Notification about successfully self registering | Email sent to a System Administrator after self registering. |
SM_CO_USR_RESEND_RICH_TMPL | User Resend Self Registration | Email sent to a User when the invitation is re-sent (rich text). |
SM_CO_USR_RESEND_SELFREG_TMPL | User Resend Self Registration | Same as the previous, but without rich text. |
SM_CO_NOTIFY_SELF_REG_SUCCESS | Notification about successfully self registering | Email sent to a User or New Hire after self registering. |
SM_CO_NOTIFY_NEW_ROLE | New role assigned | Email sent to a User when a new role is assigned to the User. |
SM_CO_NOTIFY_ROLE_UNASGN | Role Unassigned | Email sent to a User when a new role is unassigned to the User. |
SM_CO_NOTIFY_CHANGE_ROLE | Role changed | Email sent to a User when their role is changed. |
SM_CO_INV_LAUNCH_RICH_TMPL | Self Registration details | Email sent to a New Hire when an invitation is launched (rich text). |
SM_CO_INV_SELFREG_TMPL | Self Registration details | Same as the previous, but without rich text. |
SM_CO_INV_RESEND_RICH_TMPL | Resend: Self Registration details | Email sent to a New Hire when an invitation is re-sent. |
SM_CO_INV_RESEND_SELFREG_TMP | Resend: Self Registration details | Same as the previous, but without rich text. |
SM_CO_INV_FORCE_COMPLETE | Force Complete | Email sent to New Hire when their onboarding process is forced to completion. |
SM_CO_INV_RESTART_ACTIVITY | On restart of an activity | Email sent to a New Hire when their onboarding activity is restarted. |
SM_CO_INV_RESTART_PROCESS_ADM | Process restart notification to the HR Admin | Email sent to the HR Admin/Specialist when process is restarted for a New Hire. |
SM_CO_INV_RESTART_PROCESS | Process restart notification to the New Hire | Email sent to a New Hire when process is restarted for their process. |
SM_CO_INV_TERMINATE_PROCESS | Terminate Process | Email sent to New Hire when their onboarding process is terminated. |
SM_CO_NOTIFY_ACC_UNLOCK | Notification about account unlock | Email sent to a User or New Hire when their account has been unlocked by an administrator. |
SM_CO_NOTIFY_ACC_LOCK | Notification about account lockout | Email sent to a User or New Hire when their account has been locked due to too many unsuccessful login attempts. |
SM_CO_NOTIFY_EPIN_RST | Notification about ePIN reset. | Email sent to a User or New Hire when an administrator has requested that they change their e-Pin. |
SM_CO_NOTIFY_ACCOUNT_CHANGE | Notify Account Change | Email sent to a User or New Hire when they have changed their account information. |
SM_CO_NOTIFY_CHLNG_QNS_CHNG | Notification about change in challenge questions | Email sent to a User or New Hire when they have changed their challenge questions. |
PRESCREEN_SUBMITTED_NOTIFY_HR | PreScreen Submitted - Notification to HR | Email sent to an HR administrator when a New Hire has submitted their pre-screen information. |
SM_OB_AWAITING_HR_COMPLETE | Onboarding Awaiting HR Complete | Email sent to a New Hire when HR has completed their review of pre-screening information. |
SM_OB_SUBMIT_FOR_REVIEW | Confirm on Submit for Review | Email sent to a New Hire when they have submitted their onboarding information for review. |
SUBMIT_TO_HR_NOTIFY | Submit to HR Notify | Email sent to an HR administrator when a New Hire has submitted their onboarding information for review. |
SM_I9_EV_NOTIFY_EMPLOYER | Notifying to Employer | Email sent to employer to Update SSN given by the New Hire and proceed with releasing Form I9 for E-Verification |
SM_OB_CAND_PACKET_REMINDER | Candidate Packet Reminder to Invitation Creator | Email sent to invitation creator regarding candidates who have not submitted their packet |
SM_OB_SUBMIT_TO_HR_REMINDER | Reminder about Submit to HR not done | Email sent to New Hires whose Submit to HR is not done and start date within 3 days |
SM_I9_REMOTEI9_ASSIGNMENT_TMPL | Notify assigned Section 2 activity | Email sent to a Remote I-9 User when Section 2 is assigned to them. |
SM_I9_REMOTEI9_UNDO_TMPL | Notify undo of assigned Section 2 activity | Email sent to a Remote I-9 User when an assigned Section 2 activity is cancelled. |
SM_I9_REMOTEI9_COMPLETION_TMPL | Notify completion of Section 2 activity | Email sent to the I-9 & E-Verify Admins on the completion of Section 2 activity by a Remote User. |
SM_I9_REMOTEI9_PUSHBACK_TMPL | Notify send back of Section 2 activity | Email sent to a Remote I-9 User when the Section 2 activity is sent back to them. |
SM_I9_RI9_S3_ASSIGNMENT_TMPL | Notify assigned Section 3 activity | Email sent to a Remote I-9 User when the Section 3 activity is assigned to them. |
SM_I9_RI9_S3_UNDO_TMPL | Notify undo of assigned Section 3 activity | Email sent to a Remote I-9 User when an assigned Section 3 activity is cancelled. |
SM_I9_RI9_S3_COMPLETION_TMPL | Notify completion of Section 3 activity | Email sent to the I-9 & E-Verify Admins on the completion of Section 3 activity by a Remote User. |
SM_I9_RI9_S3_PUSHBACK_TMPL | Notify send back of Section 3 activity | Email sent to a Remote I-9 User when the Section 3 activity is sent back to them. |
SM_CO_REL_INV_LAUNCH_RICH_TMPL | Related invitation launch | Email sent to a Proxy User with Self Registration details after an invitation is being launched (rich text). |
SM_CO_REL_INV_RESEND_RICH_TMPL | Resend related invitation | Email sent to a Proxy User when the invitation is re-sent (rich text). |
How do you change the emails that are related to Resend, Re-Launch, and Launch?
To modify the email sent after each of these actions is completed, access the Authentication Events setup through an Attribute Revision. Please refer to this page to create/modify an Attribute Revision.
On the Attribute Revision page, select the "Authentication Events" option.
You will see a list of Events along with the notifications configured for each event. These are explained in the chart below.
Given below are the standard Notification Events related to New Hire's invitation. Upon completion of an action/event the corresponding email will be sent to the user.
Notification Event Name | Description |
---|---|
On Invitation Relaunch | When an HR Specialist or Recruiter completes the Resend Login action before the New Hire makes a User ID and password |
On Invitation Resend | When an HR Specialist or Recruiter completes the Resend Login action after the New Hire makes a User ID and password |
On Invitation Launch | When an HR Specialist or Recruiter Launches the New Hire's invitation |
On User Launch | When a System Administrator launches the Business User's invitation |
On User Relaunch | When a System Administrator completes the Resend Registration action before the Business User creates a User ID and password (to do this, a Business User must have their Invitation Launched) |
On User Resend Invite | When a System Administrator completes the Resend Registration action after the Business User creates a User ID and password (to do this, a Business User must have their Invitation Launched) |
Restart of invitee's first activity | When the HR Admin restarts invitee's process and Electronic Disclosure restarts |
Process Restart | Notification to both Admin and Invitee when the invitee's process restarted |
On Related Invitation Launch | When invitation is launched for inviting a proxy user |
On Related Invitation Resend | When invitation is relaunched for inviting a proxy user |
To modify the email sent for a particular event, click the lookup icon next to the event's email that you want to change.
A sample notification for the invitation relaunch is given below:
When you click on the lookup icon, it shows all the templates including all delivered and those that you have created. Modified templates can be identified by the suffix "[Revised]" in their description.
Choose the template you want to use for the corresponding action/event.
For example, let's use a new notification that has been created.
Now the new template is updated to the Event. Scroll down the page, and click "Save".
Event Actions Page |
---|
Click the "Return to Manage Revision" button to return to the revision main page.
Process Revision Page |
---|
Apply the revision to notice the changes.
Manage Revision Page |
---|
The template you added will appear in the event of an invitation relaunch. You can verify this for an invitation by following these steps:
Log in as an HR Specialist and click the Keyword Search icon. Search for the invitation. Ensure the selected invitation has been launched but not completed with self-registration. In the invitation actions, select "Resend Welcome Email."
This action can also be performed through the Invitation Console actions. For more details, please click here.
Click "Yes" on the message to confirm the action.
Close the confirmation message.
The sample of the updated notification looks like below:
How do you change the emails that are related to the onboarding activities?
To change which email is sent after an action is completed in the onboarding process, you need to create a process revision.
On the Process Revision page, click "Configure Events & Notifications".
The Events & Notifications page will be displayed as below.
The fields presented on this page is explained below in detail:
Field | Behavior |
---|---|
View All |
|
First Previous Next Last |
|
Add Event |
|
Delete Event |
|
Field | Behavior |
---|---|
Event |
|
Action ID |
|
Field | Behavior |
---|---|
Notify |
|
Role Type |
|
Notification Template |
|
Add |
|
Delete |
|
Select the appropriate notification template that is to be sent for the event and action configured in the process.
Note: The modified notification templates will have a suffix "[Revised]" in their description.
Click "Save" after the changes are made.
Click the "Return to Manage Revision" button to return to the revision main page.
Apply the revision to notice the changes.
Manage Revision Page |
---|
Modifying existing event emails
Click "View All" to figure out which emails are being sent and when they are sent.
After assessing that you want to modify one of them, change the fields accordingly (check the different customization options above), and then save the changes.
As you can see in the following example, a modified notification template is configured for the HR Specialist for the Action ID "Submit to HR" on action complete.
On the Process Revision page. click the "Return to Manage Revision" button to return to the revision main page.
Apply the revision to notice the changes take effect.
Manage Revision Page |
---|
Adding a new event email
Click the "Add Event" button on the Events and Notifications page.
A blank event will appear and the number between previous and next increases by one.
Fill out the fields accordingly, choose an appropriate notification template (check the different customization options above), and then click "Save".
On the Process Revision page, click the "Return to Manage Revision" button to return to the revision main page.
Process Revision Page |
---|
Apply the revision to the notice the changes take effect.
Manage Revision Page |
---|
How do you configure Notification Template for an attribute?
The Smart Onboarding application supports configuring different invitation email notifications for the following attributes.
Attributes: |
---|
Department |
Location |
Business Unit |
Company |
Job Code |
Important Note: If you want to use this feature in your organization, please reach out to us to set this up. This setup can be done for invitation email notifications such as launch/relaunch/resend.
After the setup is completed on our end, you can proceed with the configuration. Before configuring the notification for an attribute, make sure that the notification template has already been created through a Content Revision. Then, configure the notification template on the Manage Attribute page for the selected attribute and create the New Hire invitation by selecting that attribute. Based on the setup, the email notification will be sent out upon launch, relaunch, or resend
Important Considerations:
- Attribute-level notifications apply only to launch, relaunch, or resend events. They will not work for other events.
- When attribute-level notifications are enabled, standard email notifications are ignored. Ensure notifications are configured for all attributes of that attribute type. If an attribute is missing this configuration, emails will not be sent for that attribute.
- If multiple attributes have notification templates assigned and multiple/all such attributes are selected in the New Hire invitation, only the notification for the first attribute in the setup order will be sent.
- Example: If attributes in the setup order are Department, Location, Business Unit, Company, and Job Code, and notifications are configured for Department and Job Code, only the Department notification will be sent if both attributes are selected in the New Hire invitation.
- If no attributes with configured notifications are selected, no emails will be sent.
- Parent attribute notifications do not apply to child or sibling nodes. Notifications must be configured individually for each child or sibling node.
The steps for configuring notifications for different attributes are provided below:
In this example the standard notification templates for launch/relaunch have been modified using Content Revision and configured them for the Department and Job Code attributes.
You can either create a new Notification Template or modify an existing one based on your requirements. If you need more details on creating/modifying Notification Templates, please click here.
Example 1:
Revised 'Self Registration details' notification to configure for Department |
---|
Example 2:
Revised 'Relaunched: Self Registration details' to configure for Job Code |
---|
Once the templates are saved, they show up in the Content Revision Summary as given below. Return to the Manage Revision page and apply the revision.
Apply Revision |
---|
Now, configure these notifications to the corresponding attributes in the Attribute Revision.
In the Attribute Revision, select the Department attribute and click "Manage Attributes". Here 'Human Resource' Department is considered for configuring the notification.
On the "Revision Attributes" page, click the lookup icon for 'Candidate Email NotificationID'.
Select the notification that you have created for the Department.
The selected template shows on the Revision Attributes page. Click the "Save" button.
Similarly, configure Notification Template for the Job Code attribute.
On the Attribute Information page, click the lookup icon for 'Candidate Email NotificationID'.
Select the notification that you have already created.
The selected Notification Template ID populates on the Revision Attributes page as shown below. Click the 'Save' button.
Return to the Manage Revisions page and apply the revision.
On invitation launch/relaunch/resend, these notifications will be sent out for invitations with attributes specified as above.
Examples:
Two separate invitations have been created with Department = Human Resource and Job Code = Chief Operating Officer.
Example 1:
Invitation with Department = Human Resource |
---|
When the above invitation is launched, the revised 'Self Registration details' notification that is configured for Department = 'Human Resource' will be sent out to the candidate.
Launch Invitation via the Invitation Console actions:
Invitation launch via Invitation Console actions |
---|
Launch Invitation via Keyword Search Invitations related actions: |
---|
Sample notification sent out to the candidate on invitation launch is given below:
Example 2:
Invitation with Job Code = Chief Operating Officer |
---|
The revised 'Relaunched: Self Registration details' notification that is configured for Job Code = 'Chief Operating Officer' triggers when this invitation is relaunched.
Relaunch Invitation via Invitation Console actions: |
---|
Relaunch Invitation via Keyword Search Invitations related actions:
Given below is the sample notification sent out to the candidate when the invitation is relaunched:
Note: If Notification Templates are configured for multiple attributes and are given in the invitation, then the first attribute notification will trigger as per the setup.
For instance, if notifications are configured for both Department and Job Code and are selected in an invitation, then the Department notification will be sent to the candidate.
Configuring different notifications for child/sibling attributes:
In this case, "Department" attribute is selected. For Departments "Benefits" and "Payroll", let us configure different notification templates.
Click the "Attribute ID" for Benefits and select the "Manage Attributes" options.
On the Manage Attributes page, click the lookup icon for Candidate Email NotificationID and select the notification template created for the "Benefits" Department.
Notification Template Lookup |
---|
The sample notification template created for the Benefits Department is shown below:
The notification template selected will populate on the Manage Attributes page. Click the "Save" button.
Similarly, configure different email notification for the Payroll Department. Click the Attribute ID for Payroll department and select the "Manage Attributes" option.
On the Manage Attributes page, click the lookup icon for Candidate Email NotificationID and select the notification template created for the "Payroll" Department.
Notification Template Lookup |
---|
The sample notification template created for the Payroll Department is shown below:
The notification template selected will populate on the Manage Attributes page. Click the "Save" button.
On the Attribute Revision page, click the "Return to Manage Revision" button and apply the Attribute Revision.
The changes will be effective after the Attribute Revision is applied.
Now, create New Hire invitations with "Benefits" and "Payroll" Departments and launch the invitations.
New Hire invitation with Department = "Benefits" |
---|
New Hire invitation with Department = "Payroll" |
---|
New Hires will receive different welcome emails based on the configurations set by Departments.
New Hire welcome email for Department = "Benefits" |
---|
New Hire welcome email for Department = "Payroll" |
---|
Related content
© Smart ERP Solutions, Inc.