2755154 - How To Enable Temporary National ID Fields

Symptom

How to enable Temporary National ID fields in the National ID Card portlet.

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 HXM Suite
Employee Central - Personal Information
National ID

Resolution

How to enable the feature

This feature is enabled by adding the fields to the nationalIdCard hris-element configuration.

Navigate to Admin Center > Manage Business Configuration
In the "HRIS Element" list, select "nationalIdCard"
Add the following 2 fields to the configuration -:

temporary-id (STRING)
isTemporary (BOOLEAN)

Click Save

You will also need to make the national-id field non-mandatory but this change will currently need to be made via Succession Data Model XML import.

Field id : temporary-id

<hris-field id="temporary-id" max-length="256" visibility="both">

<label>Temporary ID</label>

<label xml:lang="en-US">Temporary ID</label>

</hris-field>

Field id : national-id

<hris-field id="national-id" max-length="256" visibility="both" required="false>

<label>National Id</label>

<label xml:lang="en-US">National ID</label>

</hris-field>

Permissions

Go to Manage Permission Roles;
Select a Permission Role which the user is inserted;
Click on "Permission...";
Go to Employee Data;
Check the boxes "Is Temporary" and "Temporary ID";
Save.

How does it work?

When the field "temporary-id" is filled and the "isTemporary" is set to "Yes" - the other fields and validations for National ID are skipped for that row in the National ID Card portlet.

Via Import: Please refer to the EC Imports handbook for details

Import Behaviour:

IF "isTemporary" = TRUE/Yes then the other fields will not be validated.
If "isTemporary" = No/FALSE or is NULL - then it is not considered as Temporary and the fields are validated
Leaving "temporary-id" field blank will not cause any issues
If you allow Temporary IDs in the system, then the National ID field (national-id) must not be set to required or else the system will not allow you to save without it.

For more information about this, you can refernce this page in the guide: National ID Information
IMPORTANT: Currently it is not possible to change the mandatory status of the "national-id" field via Manage Business Configuration (BCUI). Therefore this particular change will need to be made via the Succession Data Model XML import. Clarification on when BCUi will support this will be provided in time.

Customer Action:

As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your implementation partner. If you're no longer working with an implementation partner, contact SAP Cloud Support.
Customer must provide a written approval for above task (Change Code in SDM Data Model to: Field id : national-id <hris-field id="national-id" max-length="256" visibility="both" required="false> )

FAQ - Additional Information

Q) Compare temporary-id Vs national-id?

A) If you use only the National ID field, then it can be set as a required field. If you allow temporary IDs in the system, then National ID must not be set to required.

You set up the country/region-specific format in the country-specific Succession Data Model, where you also define if the user input is validated against a specific format.

Q) Where can I get more information on this topic in the Guides?

A) Guide National ID Information

Keywords

ECT-95363, ECT-102823, ECT-104823, ECT-108304, Using Temporary National ID While Hiring and Employee, ECT-115257, national-id, ECT-109130, please confirm the following automatic change(s) Field national-id is mandatory, temporary-id, national-id , KBA , LOD-SF-EC-PER-NAT , National ID - Config, Rules, RBP, UI , Problem

Product

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