SAP Knowledge Base Article - Public

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

Symptom

  • 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.

Environment

  • 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

Cause

Configuration is incorrect

Resolution

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.

 

Prerequisite

  • 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 

Note

  • 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. In Data Dictionary:

  • Create the key using for National ID Card Type with Field Name e.g. "global_NIDCardType" as Suite Based Picklist
  • Create the Ext Code Key with Field Name e.g. "global_NIDCardType_code" as String type
  • Mark both keys as "Repeating Field"

card type key setting.jpg

2019-01-30_12-29-35.jpg

#Attention#

(1) After checking "Repeating Field" For String field (e.g. global_NIDCardType_code), please make sure values for "Start Index" and "Number of Fields" are correct:

  • Correct sample: Start Index: 1 & Number of Fields: 3
  • Incorrect sample: Start Index: -1 & Number of Fields: -1 (mapping will be impacted in such case)

If the "Start Index" and "Number of Fields" values are found incorrect but non-editable, please delete current field and create a new one with the same Field Name/Label.

''

(2) Please don't use suffix "_1", "_2", etc to any repeating field name:

  • Correct sample: global_NIDCardType_code
  • Incorrect sample: global_NIDCardType_code_1, global_NIDCardType_code_2, etc. (mapping will be impacted in such case)

2. If having parent control picklist for field global_NIDCardType (e.g. country), to keep it consist, please 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 defined into EC Integration Namespace like below:

move to ec integration namespace.jpg

5. 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

Keywords

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

Product

SAP SuccessFactors Onboarding all versions