How to modify the Welcome Email Notification for new users?

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:

1. Click Edit on the User Category: Notifications page.
2. In edit mode, click the template name.
3. In the template dialog box, deselect the Enabled option.
4. 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.