Notifications

Connect to AD can send a notification when an Active Directory user is created, updated or disabled.

The notification section allows you to configure the settings for each event type:

1. When a user is inserted
2. When a user is updated
3. When a user is disabled
You have full control over when a notification is sent and also the the contents of the notification.

All notifications are delivered via email (an external SMTP service is required for email delivery)

Each event type includes values for the basic parts of an email message. All of these basic parts are fully configurable via expressions and conditions.

  • From (Sender) - The sender's email address.
  • To (Recipient) - The email addresses of people who will receive the email
  • CC (Carbon Copy) - The email addresses of people who will receive the email, but who are not expected to reply
  • Subject - A short description of the message topic. 
  • Body - The contents of the message.
  • Body Type - The content-type of the body (plain or html)

 

Here is an example of a common use-case and how to implement it:

Please note that this use case is specific to user inserts only. You can setup a different notification for updates or disables.

When a new user is inserted into Active Directory, Send an email notification to the users personal email address and include the following:

  • The notification email must be sent from specific email address
  • The notification must be sent to their personal email address (as stored in UKG) and not their work email address
  • Send a copy to their assigned manager
  • Send a copy to the IT department
  • Reference the department they will be joining
  • Reference their managers name
  • Provide default network credentials (include their user name and default  password)

 

1.  Switch on notifications for inserts

 

2. Modify the From expression, set it to:

"new-hire@example.com"
 

This states that the insert notification will be sent from from the new-hire@example.com email address.

 

3. Modify the To expression, set it to

Person.EmailAddressAlternate
 

This states to send the notification to the employees personal email address as it is stored in UKG. Note that we reference the alternate email address because it stores their personal email address field, and not the primary email address field, which is reserved for their work email address.

 

4. Modify the CC expression, set it to:

Employment.SupervisorEmailAddress + ";information-technology@example.com"

This states to send a copy of the notification to their manager, as well as the IT department (information-technology@example.com).

 

5. Modify the Subject expression, set it to:

'Welcome to the ' + OrgLevel1.Description + ' department.'

This references the department they will be joining in the subject line.

 

5. Modify the Body expression, set it to:

'Please reach out to your manger ' + Employment.SupervisorFirstName + " " + Employment.SupervisorLastName + ' for any questions (included on this email).' + Environment.NewLine + "Your network credentials are: " + Environment.NewLine + "User name: " + User.UserLogonName + Environment.NewLine + "Password: " + User.password

 

This references their manager and also provides their network credentials (user name and default password).

 

6. Modify the Body Type expression, set it to:

'plain'

 This states that the body content type is plain, and not html.