Symptom
- When the Onboarding process is initiated via Recruiting, the candidate is not visible in the Onboarding Dashboard.
- In the To-Do panel > Business Process, it gives the error:
Create External User (1)
Data Validation.
[Error Code: 7]The User Name you provided is not valid. Please use the following character types: [’a’ to ‘z’, ‘A’ to ‘Z’, ‘0’ to ‘9‘, ‘-‘, ‘_‘, ‘.‘, ‘@’].
Environment
SAP SuccessFactors Onboarding
Reproducing the Issue
- Log in to the instance
- Navigate to the To-Do panel > Business Process
- View user validation errors for [NEW HIRE] (EMAIL) for Onboarding process trigger [PROCESS ID]
- Create External User (1)
Data Validation.
[Error Code: 7]The User Name you provided is not valid. Please use the following character types: [’a’ to ‘z’, ‘A’ to ‘Z’, ‘0’ to ‘9‘, ‘-‘, ‘_‘, ‘.‘, ‘@’].
Cause
A special character exists in the candidate's primary email address in Recruiting.
Resolution
(Note: Username in Onboarding is from "primaryEmail" value in Recruiting, which is not editable in UI; only "contactEmail" is editable in Recruiting.)
Solution 1:
- Correct primaryEmail in Recruiting:
- Create support ticket to component LOD-SF-OBX and request a script to correct the email address in Recruiting.
- (For product support) Check internal memo for script to correct the email address.
- Restart the associated Business Process error.
Solution 2:
- Go to Manage Data > Process Trigger > search with candidate's application id
- Take Action > Make Correction > Change the "Process Initiation Status" from "Started" to "Cancelled" > Save
- Correct primaryEmail in Recruiting via script (see above Solution 1)
- Go to Check Tool > Validation > run the check "Process trigger object exists for the new hire (ONB2CheckProcessTriggerObjectExists)"
- Apply the quick fix to re-enable the "Initiate Onboarding" option for the candidate in RCM
- Re-initiate onboarding for candidate from RCM
See Also
Keywords
Onboarding, Onboarding 2.0, LOD-SF-OBX, OBX, Recruiting, Email Address, Data Validation, Validation Error, The User Name you provided is not valid. Please use the following character types: [’a’ to ‘z’, ‘A’ to ‘Z’, ‘0’ to ‘9‘, ‘-‘, ‘_‘, ‘.‘, ‘@’]., Candidate not visible, Onboarding Dashboard , KBA , LOD-SF-OBX-RCM , Initiate onboarding from RCM , How To
SAP Knowledge Base Article - Public