SAP Knowledge Base Article - Public

2456957 - How to default National ID Information fields in the Add New Employee wizard

Symptom

Employees can be hired in the system without National Id data

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

SAP SuccessFactors Employee Central

Cause

By default system behavior, National ID data is not obligatory during a hire. The system will only check mandatory fields if a new entry has been added for the national id, but you can proceed without adding any entry.

Resolution

This requirement can be covered with Business Rules.

There are two rules which can be set here:

  1. A rule to initially start a new record in National ID portlet when this is first initialized, it will allow to request the national id fields in first block when starting the hire, although still the line could be removed with trash can icon and proceed (onInit rule)
  2. A rule to give an error message when the employee is saved, if no national id has been introduced. This will trigger at the end of the hire, but it ensures the national id was introduced (onSave rule)

Configuration for rule in option 1

This Business Rule needs to be based on Employee Information object so it will only trigger during the Hire.

The below example will default the "Country", "Card Type" and "Is Primary" fields. Also please take note of the extra IF condition to check whether a Person ID is set or not - this is only an example of how to prevent this rule from triggering if it is a Rehire (i.e. the Person ID already exists). Because the onInit rules will trigger after using "Accept this match". Please note however, if you choose to "Rehire with New Employment" this rule will not trigger because the Person ID already exists.

NationalID Card Rule.jpg

In Manage Business Configuration, this rule needs to be set as onInit on the nationalIdCard HRIS Element.

As a result, the National ID portlet will already have a line when initially loaded in the hire.

 

Note: for this to work, if nationalIdCard portlet has subsection nationalIdCard_employee, this subsection should be disabled.

Configuration for rule in option 2

This Business Rule needs to be based on Employee Information object so it will only trigger during the Hire.
Also, a message would need to be created with desired text (Manage Data -> Create new -> MessageDefinition)
For example, the rule can be set against the 'Is Primary' field as in below screenshot:

national_id_rule1.png

Or alternatively in cases where this field would have been hidden, the rule can also be set against 'Country' field, which is obligatory for the portlet data.

Then later the rule needs to be linked to the NationalIdCard portlet with onSave through 'Manage Business Configuration'

national_id_businessconf.png

As a result, the system will throw this error message when saving the employee hire if the national id data has not been introduced.

national_id_error.png

Please note: this logic may not work in Manage Pending Hires for users coming from other modules, like Onboarding, since the onInit rule may conflict with the existing mappings.

Keywords

National ID, mandatory, required, obligatory, Employee Central, nationalIdCard, hire wizard, add new employee, rehire, rule , KBA , LOD-SF-EC-HIR-NEW , Add New Employee Wizard , LOD-SF-EC-PER-NAT , National ID - Config, Rules, RBP, UI , LOD-SF-EC-RUL , DO NOT USE - Business Rules & Event Derivation , How To

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Suite all versions