In this article, we will look into how to modify the welcome email that gets generated when the user account is created.
Table of Contents
Pre-requisites
Notifications should be enabled for the DEFAULT user category on the Security Console.
Predefined Notification Templates
There are seeded notifications provided by Oracle which sends the welcome email whenever a user is created. This table describes the predefined notification templates. Each template is associated with a predefined event.
For example, the Password Reset Template is associated with the password-reset event. You can see these notification templates and their associated events on the User Category: Notifications page of the Security Console for a user category.
Notification Template | Description |
---|---|
Password Expiry Warning Template | Warns the user that a password is expiring soon and provides instructions for resetting the password |
Password Expiration Template | Notifies the user that a password has expired and provides instructions for resetting the password |
Forgot User Name Template | Sends the user name to a user who requested the reminder |
Password Generated Template | Notifies the user that a password has been generated automatically and provides instructions for resetting the password |
Password Reset Template | Sends a reset-password link to a user who performed the Reset Password action on the My Account page |
Password Reset Confirmation Template | Notifies the user when a password has been reset |
Password Reset Manager Template | Sends a reset-password link to the manager of a user who performed the Reset Password action on the My Account page |
Password Reset Manager Confirmation Template | Notifies the user’s manager when a user’s password has been reset |
New Account Template | Notifies a user when a user account is created and provides a reset-password link |
New Account Manager Template | Notifies the user’s manager when a user account is created |
When you create a user category, it’s associated automatically with the predefined notification templates, which are all enabled.
You can’t edit the predefined templates. However, you can create templates and disable the predefined versions. Each predefined event can be associated with only one enabled notification template at a time.
Enabling and Disabling Notifications
For any notification to be sent to the users in a user category, notifications in general must be enabled for the user category. Ensure that the Enable notifications option on the User Category: Notifications page is selected. When notifications are enabled, you can disable specific templates. For example, if you disable the New Account Template, then users in the relevant user category aren’t notified when their accounts are created. Other notifications continue to be sent.
To disable a template:
- Click Edit on the User Category: Notifications page.
- In edit mode, click the template name.
- In the template dialog box, deselect the Enabled option.
- Click Save and Close.
Tokens that can be used in Notifications
We have pre-defined tokens that we can use on the notification templates to get them populated in runtime with the values from employee/application etc.
Token | Meaning | Events |
---|---|---|
userLoginId | User name | Forgot user namePassword expiredPassword reset confirmation |
firstName | User’s first name | All events |
lastName | User’s last name | All events |
managerFirstName | Manager’s first name | New account created – managerPassword reset confirmation – managerPassword reset – manager |
managerLastName | Manager’s last name | New account created – managerPassword reset confirmation – managerPassword reset – manager |
loginURL | URL where the user can sign in | Expiring external IDP signing certificatePassword expiredPassword expiry warning |
resetURL | URL where the user can reset his or her password | New account created – managerNew user createdPassword generatedPassword resetPassword reset – manager |
CRLFX | New line | All events |
SP4 | Four spaces | All events |
adminActivityUrl | URL where an administrator initiates an administration activity | Administration activity requested |
providerName | External identity provider | Expiring external IDP signing certificate |
signingCertDN | Signing certificate | Expiring external IDP signing certificate |
signingCertExpiration | Signing certificate expiration date | Expiring external IDP signing certificateExpiring service provider signing certificate |
encryptionCertExpiration | Encryption certificate expiration date | Expiring service provider encryption certificate |
adminFirstName | Administrator’s first name | Administration activity location based access disabled confirmationAdministration activity single sign-on disabled confirmation |
adminLastName | Administrator’s last name | Administration activity location based access disabled confirmationAdministration activity single sign-on disabled confirmation |
Modifying the Welcome Email for new user account
Here is how the seeded welcome email will look like:
Some observations from the above email:
- It doesn’t contain the branding of the client.
- It doesn’t contain the username that the candidate/employee needs to use.
- It doesn’t contain the login URL of the application.
To provide a seamless experience for the Candidate/Employee, it is better to add more information on the welcome email so that they don’t need to reach out to the system administrator or recruiter to get these details.
Current Template looks like:
Dear ${firstName} ${lastName},${CRLFX}${CRLFX}${SP4}Congratulations! Your Oracle Fusion Applications account has been successfully created.${CRLFX}${CRLFX}${SP4}Please follow the link below to reset your password.${CRLFX}${CRLFX}${SP4} ${resetUrl}${CRLFX}${CRLFX}${SP4}For any issues, contact your system administrator.${CRLFX}${CRLFX}Thank You,${CRLFX} Oracle Fusion Applications${CRLFX}${CRLFX}
At run time, these tokens ${firstName}, ${lastName}, ${resetUrl}, etc are replaced with actual values.
Now the modified template with the addition of username will look like:
Dear ${firstName} ${lastName},
${CRLFX}${CRLFX}${SP4}Congratulations! Your cloud account has been successfully created.
${CRLFX}${CRLFX}${SP4}Your User Name is ${userLoginId}
${CRLFX}${CRLFX}${SP4}Please follow the link below to reset your password.
${CRLFX}${CRLFX}${SP4} ${resetUrl}
${CRLFX}${CRLFX}${SP4}Please follow the link below to login post reset.
${CRLFX}${CRLFX}${SP4} https://abcd-test.fa.us6.oraclecloud.com/ ${CRLFX}${CRLFX}${SP4}
For any issues, contact system administrator.
${CRLFX}${CRLFX}Thank You!
There is a {loginURL} token but it doesn’t work with new user account creation event. And even if we hardcode the URL, it will be shown as text only and not as hyperlink.
We cannot add client logo on this notification but we can add the text wording with client name to show a personalized notification.
Steps to modify the notification:
Navigate to Tools > Security Console
Click on User Categories
Click on DEFAULT unless you have multiple User Categories.
Click on Add Template, select the event as “New user created” and paste the message.
Once we enable this template, the existing template will get disabled. At a time only one new user notification can be active.
Here is the sample welcome email with the modifications.
If you like the content, please follow us on LinkedIn, Facebook, and Twitter to get updated with the latest content.