Clear Collection Parameter Added to Employee Employment History
Applicable Product:
- Talent Management
Applicable Release:
- V23.07+
Summary: This enhancement allows the Employee Employment History Feed to default to delta changes instead of kill-and-fill.
Details:
The Employee Employment History Feed (EEH API 1.36.230700) has long been kill-and-fill, meaning that any existing data is erased and replaced with the new data in the feed. This meant that the entire history had to be sent each time the EEH was updated.
In the 23.07 update of PeopleFluent Talent Management, the EEH feed now defaults to a delta, which keeps the existing data and adds the new data to it. Mostly this is a great feature to default to but there are some instances where Customers might want to clear out past employment instances that are incorrect or not needed. This is where the ClearCollection parameter comes into play and will delete the existing Employment Instances if ClearCollection flag(Column BT in Data Mapping Guide for EEH feed) is true. If the flag is false, then API won't delete the existing Employment Instances.
Valid values: 0 or false, 1 or true
API will default to false.
As part of this enhancement, an existing system setting has a new option available.
The Employee Employment History API Position Matching Attributes setting uses attributes to denote the fields that the application uses to determine if a position in the feed matches a position in the existing data.
Clients can now use Manager as a matching criteria in this setting to track manager changes. So if the only difference in the feed is a different manager, the application will consider that as a new employment instance and create a new position with the new manager.
Keywords: ClearCollection flag EEH kill and fill kill-and-fill
Created: Erik Zilli