2784719 - Formal Name Display Logic on ESS portlet, New hire Page & EC import

Formal Name is displayed wrong on the Personal Information or wrong values are passed to Offboarding on termination

• SAP SuccessFactors HCM Suite
• SAP SuccessFactors Employee Central

Pre-requisites

1. Enable Name Format functionality. There are two methods,
   • provisioning<Company Settings<check "Enable Name Format — requires “Employee Central V2 (i.e., Event Reason Derivation)”, “Enable Generic Objects”, “Effective Dated Data Platform”, “Employee Profile data audit” and “Enable the Attachment Manager”" 
   • login instance and go to  "Manage Employee Central Settings", turn on "Enable Name Format"
2. Under Manage Business configuration> Personal Information, enable the formal-name, set the visibility to be "both" and give all the permissions for RBP
3. If set the visibility to be "view", give the view permission only, then it just can't be changed from UI.  

System determines the formal Name of the employee based on the Logic Defined below.

First option:

• If target user doesn’t have job info, then set formal-name as the hard coded formal name (firstName + middleName + lastName), and set the IsOverridden flag to be false(0). -> End
• If target user has job info, go to Second option

Second option:

If target user has job info record, get Job Information record as of personal information’s effective start date.

• If there is formal-name change between database value and to-be-saved value, set formal-name as the value in request, and set isOverriden flag to be true(1).-> End
• If there is no formal-name change between database value and to-be-saved value, check database's EO's(previous record's)isOverriden flag. if previous record's isOverriden=null, then go to third option;
• If previous record's isOverriden is true, then return the to-be saved formal name, and set isOverriden flag to be true(1); if isOverriden flag is false, then go to third option.

Third Option:

Get Legal Entity from target user’s Job Information. Get Legal Entity record as of Personal Information’s effective start date.

• If NameFormat is not configured in Legal Entity and name format code is null, then set formal-name as default Name Format which is hard coded as firstName + middleName + lastName, and set isOverriden to be false
• If NameFormat is configured in Legal Entity, go to Fourth option

Forth Option:

Get Legal Entity record as of personal information’s effective start date. Get NameFormat based on legal entity record’s association, set isOverriden to be false(0).

• If NameFormat GO record doesn’t exist, then set formal-name the default nameformat(firstName + middleName + lastName) 
• If NameFormat is configured as one to one association in Legal Entity definition, and set NameFormat value in Legal Entity data
• If NameFormat is configured as one to many association in Legal Entity definition, and set NameFormat value in Legal Entity data. Always use the first NameFormat configured in Legal Entity. Then use the same logic as point 2.

NameFormat, Formal Name, formal-name, Personal Information, LOD-SF-EC-PER, PER, display-name , KBA , LOD-SF-EC-PER , Person Data (All Person Data Types) , LOD-SF-EC-INT , Manage Pending Hires (Integration RCM/ ONB/ OBX + UI) , Problem