Introduction: A national Identification/ Identity number is used by the governments of numerous countries as a means to identify their citizens and permanent/temporary residents for the purposes of work, taxation, government benefits, health care, and other governmentally related functions.
To store this critical employee’s master data, SuccessFactors HR solution provides National ID portlet under people profile. SuccessFactors solution provides the standard country specific National ID formats to achieve the same. Hence, in this blog, we will discuss on how to create custom alphanumeric display format for national IDs when needed.
Standard National ID Format and Validation
Before we move to custom National ID creation, let’s understand how the standard National ID functionality works in SuccessFactors. The standard country specific National ID formats are available under Manage Business Configuration using below characters that follows rule as specified below:
The created Display format for Singapore in above example is validated as per the Regular expression defined where A is expected to be a character between (A-Z) and N is expected to be a number between (0-9), any value that does not match the defined format gives error to enter a valid value.
There is another Deep Validation method available for standard national ID which is hard coded for certain country specific standard national IDs. This needs to be enabled via Company System and Logo Setting page in SuccessFactors.
It validates the ID values when entries are saved. As a system admin, we cannot re-use these Deep Validations for other national IDs or create new Deep Validations.
Now, Considering the fact that we have fair amount of understanding on country specific National ID format, regular expression and display format from the above discussion, let’s move forward to our use cases for custom National ID creation.
Use Case: Create alphanumeric National ID format for countries.
Scenario 1 - 11-digit alphanumeric ID for users varies as per below example.
ID1 – 1DER23456GT
ID2 – 1DER2AB9611
Configuration Step
We use "X" in the National ID format here as the place value of each character changes between number and alphabet.
Step 1: Go to Manage Business Configuration
Step 2: Go to National ID >> Country Specific National ID
Step 3: Add identifier, Label, Display Format and Regular expression as below and save
Step 4: Go to National ID portlet under people profile and try saving National ID value for user 1 and user 2
Scenario 2 - 15-digit alphanumeric ID varies as per below example.
ID1 – 325620201409551
ID2 – 32562020140955A
Configuration step for this scenario 2 can be used to configure single/multiple alphanumeric character in National ID card type, please check below screenshot.
Step 1: Go to Manage Business Configuration
Step 2: Go to National ID >> Country Specific National ID
Step 3: Add identifier, Label, Display Format and Regular expression as below and save
Try Saving sample value. User should be able to save the ID without an error.
Conclusion : In this blog, we have learnt how standard country specific national id values are validated when maintained for end users. Additionally, we understood some of the use cases for custom alphanumeric national id creation. Hope this provides some good insights. Appreciate your feedback and comments.
Happy Learning 😊
To store this critical employee’s master data, SuccessFactors HR solution provides National ID portlet under people profile. SuccessFactors solution provides the standard country specific National ID formats to achieve the same. Hence, in this blog, we will discuss on how to create custom alphanumeric display format for national IDs when needed.
Standard National ID Format and Validation
Before we move to custom National ID creation, let’s understand how the standard National ID functionality works in SuccessFactors. The standard country specific National ID formats are available under Manage Business Configuration using below characters that follows rule as specified below:
- A in National ID format represents a letter
- N in National ID format represents a number
- X in National ID format represents any alphanumeric character
- * (Symbol) in National ID format represents a special symbol (for example, &/!/@) or an alphanumeric character
- YYMMDD/YYYYMMDD (or similar date patterns) represents a date/date of birth
Image/data in this blog is from sample data, or demo systems.
The created Display format for Singapore in above example is validated as per the Regular expression defined where A is expected to be a character between (A-Z) and N is expected to be a number between (0-9), any value that does not match the defined format gives error to enter a valid value.
Image/data in this blog is from sample data, or demo systems.
There is another Deep Validation method available for standard national ID which is hard coded for certain country specific standard national IDs. This needs to be enabled via Company System and Logo Setting page in SuccessFactors.
It validates the ID values when entries are saved. As a system admin, we cannot re-use these Deep Validations for other national IDs or create new Deep Validations.
Now, Considering the fact that we have fair amount of understanding on country specific National ID format, regular expression and display format from the above discussion, let’s move forward to our use cases for custom National ID creation.
Use Case: Create alphanumeric National ID format for countries.
Scenario 1 - 11-digit alphanumeric ID for users varies as per below example.
ID1 – 1DER23456GT
ID2 – 1DER2AB9611
Configuration Step
We use "X" in the National ID format here as the place value of each character changes between number and alphabet.
Step 1: Go to Manage Business Configuration
Step 2: Go to National ID >> Country Specific National ID
Step 3: Add identifier, Label, Display Format and Regular expression as below and save
Image/data in this blog is from sample data, or demo systems.
Step 4: Go to National ID portlet under people profile and try saving National ID value for user 1 and user 2
Image/data in this blog is from sample data, or demo systems.
Image/data in this blog is from sample data, or demo systems.
Scenario 2 - 15-digit alphanumeric ID varies as per below example.
ID1 – 325620201409551
ID2 – 32562020140955A
Configuration step for this scenario 2 can be used to configure single/multiple alphanumeric character in National ID card type, please check below screenshot.
Step 1: Go to Manage Business Configuration
Step 2: Go to National ID >> Country Specific National ID
Step 3: Add identifier, Label, Display Format and Regular expression as below and save
Image/data in this blog is from sample data, or demo systems.
Try Saving sample value. User should be able to save the ID without an error.
Image/data in this blog is from sample data, or demo systems.
Conclusion : In this blog, we have learnt how standard country specific national id values are validated when maintained for end users. Additionally, we understood some of the use cases for custom alphanumeric national id creation. Hope this provides some good insights. Appreciate your feedback and comments.
Happy Learning 😊
- SAP Managed Tags:
