SAP Knowledge Base Article - Public

2747845 - How to Configure Mapping of Single or Multiple National Identification (ID) Information - Onboarding 1.0


  • How to mapped National Identification (ID) Information from Onboarding 1.0 to Employee Central?
  • Country, Card Type, and Identification Number pre-population in Manage Pending Hires via Onboarding 1.0

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


  • SAP SuccessFactors Onboarding 1.0
  • SAP SuccessFactors Employee Central

Reproducing the Issue

1.Go to Manage Pending Hire/Manage Pending Recruits

2.Hire the candidate, the National ID Card is not passing to EC or the value not accepted into the placeholder in EC box


Configuration is incorrect


For Live Customer(s), Implementation Partner(s), and Consultant(s)

For customers who is engaged with a partner or consultant, please engage with them to configure the mapping of National ID Portlet of Employee Central with Onboarding 1.0 . Below instructions is given on how to properly mapped National Identification (ID) Information.



  • National Identification (ID) Information Panel Field in Onboarding 1.0
  • Mapping Onboarding 1.0 to Employee Central Fields


National Identification (ID) Information Panel Field in Onboarding 1.0

  • Step 1: Navigate to SAP SuccessFactors HCM and go to Admin Center
  • Step 2: Under Tools, find and select Manage Onboarding Settings 1.0
  • Step 3: In Manage Onboarding Settings 1.0 , click Panels
  • Step 4: Create a new Panel to store the National Identification (ID) Information, see below reference images 


  • National Identification (ID) Information requires 4 standard fields below.
    • National Identification Country
    • National Identification Card Type
    • National Identification Card Number
    • Is Primary
  • The Panel can be configured as multi-panel or single panel

Please find below configurations for your reference:

1.Define the key you used for national ID Card Type in data dictionary as Suite Based Picklist, and name the Ext Code Key such as global_NIDCardType_code,create the Ext Code Key global_NIDCardType_code as string and make sure all is repeating field like below

card type key setting.jpg


2.If you have parent control picklist for field global_NIDCardType, like country, to keep it consist, you should make the same for its parent control field country as Suite Based Picklist, define the Ext Code Key and then create the Ext Code Key as string. The same make sure it is repeating field

card type panel.jpg

3.As the Ext Code Key is repeating field, you need to copy the panel into a dummy wizard, make sure both the orignal the dummy panel as multi-panle like below-

copy dummy panel.jpg

panely index.jpg

dummy panel index8.jpg

4.Add the Ext Code Key you defined into EC Integration Namespace like below

move to ec integration namespace.jpg

5.Finally map the  Ext Code Key to EC in Field Mapping tool

Mapping Onboarding 1.0 to Employee Central Fields

field mapping tool.jpg

With Respect to National ID, the data type does not matter in Onboarding 1.0 , any data type can flow.

The only pre-requisite configuration needed is national id regular expression in country specific data model and custom validations   in panel should match with EC Validations.

See Also

2432802 - ONB-EC Integration(National Information Portlet)-Onboarding 1.0

2507544 - Employee Central - Troubleshooting Recruiting and Onboarding to Employee Central Integrations


National ID Card Type mapping, national id, national , KBA , LOD-SF-OBD-INT , Integrations with Onboarding , How To


SAP SuccessFactors Onboarding all versions