Notification

Connect to AD can send a notification when an Active Directory user is created, updated or disabled. You have full control over when a notification is sent and also 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.

  • Send Condition - The condition for sending the notification.
  • 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 an On Insert use-case and how to implement it:

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

  • The notification email must be sent from a 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 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.  Add an On Insert notification

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.SecondaryEmailAddress

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:

"information-technology@example.com"

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

5. Modify the Subject expression, set it to:

'Welcome to the ' + CostCentre1.Level1 + ' 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 for any questions.' + 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.

7. Save the On Insert notification

This setup should now result in an email notification being sent when a user is inserted in Active Directory.

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.