This is a KBA to clarify the expected behaviour of both User Connectors and to differentiate how each connector updates the HRBP (HR Business Partner) field in a user record.
Learning Management System (LMS)
Reproducing the Issue
- Change the HRBP field in the user_data.txt or user_manager_data.txt files
- Run both SF User Connector and User Connector (using separate files)
- Each connectors updates HRBP differently
The SF User Connector and the standard User Connector update the HRBP field of the user record slightly differently. It is therefore important to use the correct connector for the desired update.
Here are the expected behaviours of both User Connectors:
The User Connector will only add to (or remove) the user's existing HRBP. Via the user_manager_data.txt you can remove an existing HRBP and/or add a new one. However, if you attempt to add a new HRBP without removing the old one first, it will add a new HRBP and keep the old one also. So it accumulates and does not overwrite.
SF User Connector
The SF User Connector overwrites the HRBP with the user referenced in the user_data.txt file. This file can either be generated automatically via a scheduled job from BizX (where the HRBP field gets changed manually on the BizX side) or this file can be manually built and placed on the SFTP ready for the SF Connector to pick it up. So this connector overwrites the existing HRBP and replaces with HRBP field found in the user_data.txt file.
To ensure that SF User Connector behaves/updates as outlined above (HRBP and Alternate Supervisors in BizX overwrite these fields in LMS) it is important to include the following property in the connector config:
Without this property you will experience issues with updating as expected.
If you want to overwrite an existing HRBP of a user with a new one, then it best practice to use the SF User Connector. If you want to add more than one HRBP (or Alternate Supervisor), or remove an existing one, then it is better to use the standard User Connector and update via the user_manager_data.txt input file.
- User Connector
- SF User Connector
- Updating HRBP
- User Connector standard behaviour