- Introduction
- Installation
- Getting Started
- Setup the Environment
- Setup the UKG Pro Connection
- Setup the Active Directory Connection
- Delegation of Control
- Setup Rules
- Link (Identity Match)
- Employee Filter
- Auto Provision
- Auto Provision Conditions
- User Logon Name
- User Logon Name Suffix
- Password
- Password Never Expires
- Setup Mappings
- Field Mappings
- Enable Account
- Container
- Network Access Permission
- Custom Attributes
- Group Mappings
- Remove from All Groups
- Working with Expressions
- String Expressions
- Bool Expressions
- Quick Expressions
- Working with Conditional Expressions
- Working with Constants
- Ignore Constant
- IsInsert Constant
- IsUpdate Constant
- IsDisable Constant
- Auto Constant
- Special Methods
- Supported Fields
- Person (UKG)
- Employment (UKG)
- Job (UKG)
- Location (UKG)
- Org Level 1 to 4 (UKG)
- Project (UKG)
- Platform Configuration (UKG)
- User (Active Directory)
- Sending Email to UKG Pro
- Global Catalog / Cross Domain Manager
- Get Business Rule Descriptions
- Notifications
- Detecting Changes
- Send Conditions
- SMTP Settings
- Scheduling
- Viewing the Logs
- Activate a License
- Security
- Introduction
- Installation
- Getting Started
- Setup the Environment
- Setup the UKG Pro Connection
- Setup the Active Directory Connection
- Delegation of Control
- Setup Rules
- Link (Identity Match)
- Employee Filter
- Auto Provision
- Auto Provision Conditions
- User Logon Name
- User Logon Name Suffix
- Password
- Password Never Expires
- Setup Mappings
- Field Mappings
- Enable Account
- Container
- Network Access Permission
- Custom Attributes
- Group Mappings
- Remove from All Groups
- Working with Expressions
- String Expressions
- Bool Expressions
- Quick Expressions
- Working with Conditional Expressions
- Working with Constants
- Ignore Constant
- IsInsert Constant
- IsUpdate Constant
- IsDisable Constant
- Auto Constant
- Special Methods
- Supported Fields
- Person (UKG)
- Employment (UKG)
- Job (UKG)
- Location (UKG)
- Org Level 1 to 4 (UKG)
- Project (UKG)
- Platform Configuration (UKG)
- User (Active Directory)
- Sending Email to UKG Pro
- Global Catalog / Cross Domain Manager
- Get Business Rule Descriptions
- Notifications
- Detecting Changes
- Send Conditions
- SMTP Settings
- Scheduling
- Viewing the Logs
- Activate a License
- Security
Detecting Changes
When sending a notification you may want to include the changes that occured to the employee in the email notification.
There are 4 different constants (each providing a different format) that store the employee changes that can be referenced in your expressions:
- Changes to Json
- Changes to CSV
- Changes to Text
- Changes to HTML
Any of these constants can be used when selecting a field and will appear within the Constants category.
Here is an example of referencing the ChangesToJson constant in the body of a notification. When the notification is sent, the body of the email notification will contain a Json representation of the changes that occured.
1. ChangesToJson
The ChangesToJson constant holds all the changes that occured to the employee record in a Json format and it can be referenced in your notification to send the changes as a Json string.
{
"EmployeeId": "D9XF12340070",
"CompanyId": "A1B2C",
"EmployeeNumber": "001234",
"CompanyCode": "ABC",
"Action": "Update",
"Changes": [
{
"Mapping": "Job Title",
"Type": "Attribute",
"Name": "title",
"NewValue": "Manager",
"OldValue": "Cashier",
"WhenChanged": "2023-01-07T16:44:45.9853634-04:00"
},{
"Mapping": "Department",
"Type": "Attribute",
"Name": "department",
"NewValue": "Marketing",
"OldValue": "Sales",
"WhenChanged": "2023-01-07T16:44:45.9853634-04:00"
}
]
}
2. ChangesToCSV
This ChangesToCSV constant holds all the changes that occured to the employee record in a CSV format and it can be referenced in your notification to send the changes as a comma-delimited string .
"D9XF12340070","A1B2C","001234","ABC","Update","Department","Attribute","department","Marketing","Sales","4/19/2023 10:01:14 PM"
"D9XF12340070","A1B2C","001234","ABC","Update","Job Title","Attribute","title","Manager","Cashier","4/19/2023 10:01:14 PM"
3. ChangesToText
The ChangesToText constant holds all the changes that occured to the employee record in a HTML format and the constant can be referenced in your notification to send the changes as a Json string.
Employee ID = D9XF12340070, Company ID = A1B2C, Employee Number = 001234, Company Code = ABC, Action = Update, Mapping = Job Title, Type = Attribute, Name = title, New Value = Manager, Old Value = Cashier, When Changed = 4/19/2023 10:08:46 PM
4. ChangesToHTML
The ChangesToHTML constant holds all the changes that occured to the employee record in a HTML format and it can be referenced in your notification to send the changes as a Json string.
<div>Employee ID</div>
<div>D9XF12340070</div>
</div>
<div>
<div>Company ID</div>
<div>A1B2C</div>
</div>
<div>
<div>Employee Number</div>
<div>001234</div>
</div>
<div>
<div>Company Code</div>
<div>ABC</div>
</div>
<div>
<div>Action</div>
<div>Update</div>
</div>
<div>
<div>Mapping</div>
<div>Department</div>
</div>
<div>
<div>Type</div>
<div>Attribute</div>
</div>
<div>
<div>Name</div>
<div>department</div>
</div>
<div>
<div>New Value</div>
<div>Marketing</div>
</div>
<div>
<div>Old Value</div>
<div>Sales</div>
</div>
<div>
<div>When Changed</div>
<div>4/19/2023 10:12:59 PM</div>
</div>
</br>
<div>
<div>Employee ID</div>
<div>D9XF12340070</div>
</div>
<div>
<div>Company ID</div>
<div>A1B2C</div>
</div>
<div>
<div>Employee Number</div>
<div>001234</div>
</div>
<div>
<div>Company Code</div>
<div>ABC</div>
</div>
<div>
<div>Action</div>
<div>Update</div>
</div>
<div>
<div>Mapping</div>
<div>Job Title</div>
</div>
<div>
<div>Type</div>
<div>Attribute</div>
</div>
<div>
<div>Name</div>
<div>title</div>
</div>
<div>
<div>New Value</div>
<div>Manager</div>
</div>
<div>
<div>Old Value</div>
<div>Cashier</div>
</div>
<div>
<div>When Changed</div>
<div>4/19/2023 10:12:59 PM</div>
</div>
</br>