Notification

Connect to AD can notify 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 SMTP service is required).

Messages will remain in the system for 30 days, starting when they are successfully delivered. After that period, they will be deleted.

Each event type includes values for the basic parts of an email message, which 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 their assigned manager
  • Send a copy to the IT department
  • Reference the department they will be joining
  • Reference their manager's 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.EmailAddressAlternate

This states to send the notification to the employee's 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, not the primary one, 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.

7. Save the On Insert notification

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

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.