Symptom
In SAP SuccessFactors Onboarding, User ID generation during hiring can be governed by a rule in the Onboarding Configuration object (DEFAULT_ONB2_CONFIG) or by a rule in the Employee Central Hire/Rehire Configuration object (MatchingUserConfiguration). When both objects have rules assigned with separate sequences, only one rule executes at the point of hire submission.
This guide aims to provide information on the system behavior when both rules are present, the correct configuration approach for single-source ID generation, and sequence gap handling when candidates do not complete the hire process.
Environment
- SAP Successfactors Onboarding
- SAP Successfactors Employee Central
Reproducing the Issue
- In Manage Data, assign a business rule with a custom sequence (Sequence A) to DEFAULT_ONB2_CONFIG > Rule for Onboarding User ID Generation.
- In Manage Data, assign a separate business rule with a different sequence (Sequence B) to MatchingUserConfiguration > Rule to generate next employee ID.
- Initiate a new hire through Onboarding.
- Proceed to Manage Pending Hires and submit the hire.
- Observe that the User ID in the hired record comes from Sequence A. The rule trace shows the EC-side rule (Sequence B) failing to execute.
Resolution
How the system resolves rule priority
When a business rule is assigned to the Rule for Onboarding User ID Generation field in DEFAULT_ONB2_CONFIG, the Onboarding system generates the User ID at ONB initiation. Because User ID is immutable once assigned, the rule configured in MatchingUserConfiguration under Rule to generate next employee ID cannot overwrite it at Manage Pending Hires. The EC-side rule fails at that point by design. This behavior is consistent regardless of whether the two rules reference the same or different sequences.
Recommended configuration: single-source setup
Configure User ID generation in only one of the two objects.
Option 1: ONB-side rule only (recommended for manual onboarding without Recruiting Management)
- Assign the rule in DEFAULT_ONB2_CONFIG > Rule for Onboarding User ID Generation.
- Confirm that Respect Rule-Based Generation of User ID During Manual Onboarding is enabled in the same object.
- Leave the Rule to generate next employee ID field empty in MatchingUserConfiguration.
For full ONB-side setup steps, see KBA 3211424 - Configure Business Rule for Custom User ID and Employee ID Format for External ATS Integration or Manual Onboarding - SAP for Me and Help Portal, Configuring Business Rule for Custom User ID and Employee ID Format in Onboarding: Configuring Business Rule for Custom User ID and Employee ID Format in Onboarding | SAP Help Portal
Option 2: EC-side rule only
- Leave the Rule for Onboarding User ID Generation field empty in DEFAULT_ONB2_CONFIG.
- Assign the rule in MatchingUserConfiguration > Rule to generate next employee ID.
In this case, the system uses the default sequence from Company System and Logo Settings during ONB initiation. The EC rule applies at Manage Pending Hires when the hire is submitted.
For EC-side rule configuration steps, see Help Portal, Generating User IDs with Business Rules:Generating User IDs with Business Rules | SAP Help Portal and KBA 2678155: 2678155 - Rule-based Generation of UserID/Username for Hires & Rehires with New Employment - SAP for Me
Sequence gap handling
When the ONB-side rule governs ID generation, the sequence value is consumed at ONB initiation. If the candidate does not complete the hire process, the consumed value is not recovered. To close a sequence gap, import a user record carrying the skipped ID to realign the sequence. When using the EC-side rule only, the ID is not generated until hire submission, which reduces exposure to sequence gaps from incomplete processes.
See Also
Keywords
SAP SuccessFactors Onboarding, OBX, ONB, Employee Central, employee ID, user ID, business rule, DEFAULT_ONB2_CONFIG, MatchingUserConfiguration, Rule for Onboarding User ID Generation, Rule to generate next employee ID, Manage Pending Hires, MPH, Generate Employee ID for Hire/Rehire, sequence, sequence gap, EC rule fails, expected behavior, single-source ID generation, rule conflict , KBA , LOD-SF-EC-INT , Manage Pending Hires (Integration RCM/ ONB/ OBX + UI) , LOD-SF-OBX , Onboarding 2.0 , LOD-SF-EC-INT-OBX , Onboarding 2.0 to EC Integration , How To
SAP Knowledge Base Article - Public