SAP Knowledge Base Article - Public

2678155 - Rule-based Generation of UserID/Username for Hires & Rehires with New Employment

Symptom

  • Customers often use rules to create the UserIDs/Usernames of newly hired or rehired employees. Such a rule typically creates a number of different number ranges dependent on Legal entity/Country.
  • Previously, this process did not work when an employee was rehired (using the new employment option). With the PersonID unchanged, the mechanism of generating on UserID/username (which works via the PersonID) was not being triggered.
  • However, an enhancement has been implemented to meet the UserID/Username generation both in New Hire and Rehire with New Employment.

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 HXM Suite
  • SAP SuccessFactors Employee Central

Resolution

  • The rule to generate the IDs will be consumed not by the standard events (onChange, onSave), but directly by an appropriate method entered in a designated place in the Hire/Rehire Configuration object.
  • There is also a new template option in the Manage Business Rules UI to create a rule to generate the Employment ID.
  • This can help address the previous gaps with standard events where the sequence for employee IDs was skipped; however, this does not guarantee that sequence numbers will not be skipped.
  • The Employee ID will only be generated when saving the new hire.

How to Configure:

  1. For Business Rules that will be used to generate an Employee ID via MDF Sequence, choose the following option when creating the rule in Configure Business Rules:

Screenshot1.PNG

Note: It is important to use this Scenario in order for the rule to show up as one of the options in the Hire/Rehire Configuration object. This Scenario automatically defaults the necessary paramaters that such rule will need.

Example:

sampleRule.png

  1. After the rule is configured, go to Manage Data > Select Hire/Rehire Configuration > MatchUserConfiguration, and add the rule created in the previous step:

MATCHINGUSERCONFIG.png


=====================================================

FAQ:

1. Currently, we have a business rule configured as onSave in Biographical Information (personInfo) that sets the value for Person ID External. If we want to use this feature, what should we do with the current rule?

Answer: It is recommended that the onSave rule be removed from personInfo. A new rule needs to be created with the scenario for this feature. The rule in the Hire/Rehire Configuration object will automatically set the Person ID based on the next sequence value. In the case of New Hire process, the Person ID and UserID value will come from the next sequence in the rule. In the case of Rehire with New Employment, the Person ID will remain unchanged and the UserID will come from the next sequence in the rule.

=====================================================

2. Can we just update our existing rule and assign it to the Hire/Rehire Configuration object?

Answer: No. You will be unable to update the existing rule and add the needed parameters. A new rule has to be defined from scratch.

=====================================================

3. If we manually fill out the Person ID External field in Add New Hire, will the UserID come from the Hire/Rehire Configuration rule?

Answer: No. The Person ID and User ID will be the same and in this case, the value will come from whatever value you specified in the person-id-external field. On the other hand, in the case of Rehire with New Employment, there is already an existing Person ID for the employee, so the new User ID for the new employment will come from the next sequence in the rule.

=====================================================

4. The user-name field in userAccountInfo is enabled for us. By default, it is a mandatory field in the Add New Hire wizard. What happens to the username value once the Hire is saved?

Answer: The system will always respect the value maintained in the user-name field. The Person ID and User ID values will come from the next sequence in the business rule. In case the field is not enabled in your instance (meaning you are not filling this value manually in the UI), then User ID and Username will come from the Hire/Rehire Config Rule.

=====================================================

5. If we do not enable the rule in Hire/Rehire Config object, not fill out the Person ID External and Username fields manually in the UI, from where will the system get the ID?

Answer: If no rule is setting the value and if no specific value is manually added in the field, then the system will get the Username, UserID, and personIdExternal from the "Next Person Id Assigned" in Company System and Logo Settings page (for New Hire). For Rehire with New Employment, the same thing is applicable except for Person ID which should remain unchanged. If userAccountInfo user-name if filled out during Hire, the userID value will be the same with user-name.

=====================================================

Possible ID Outputs (based on customer configuration/process)

In New Hire:

Is Person ID filled out in the UI?

Is Username filled out in the UI?

onSave Rule in PersonInfo

Hire/Rehire Config Rule

Output

Yes

Yes

NA

NA

UserId :  Value from Column 1

UserName : Value from Column 2

PersonIdExternal : Value from Column 1

Yes

No

NA

NA

UserId :  Value from Column 1

UserName : Value from Column 1

PersonIdExternal : Value from Column 1

No

Yes

Yes

No

UserId :  Value from Column 3

UserName : Value from Column 2

PersonIdExternal : Value from Column 3

No

Yes

No

Yes

UserId :  Value from Column 4

UserName : Value from Column 2

PersonIdExternal : Value from Column 4

No

Yes

Yes

Yes

UserId :  Value from Column 4

UserName : Value from Column 2

PersonIdExternal : Value from Column 4

No

Yes

No

No

UserId :  Value from DB Seq/Sysconfig

UserName : Value from Column 2

PersonIdExternal : Value from DB Seq/Sysconfig

No

No

Yes

No

UserId :  Value from Column 3

UserName : Value from Column 3

PersonIdExternal : Value from Column 3

No

No

No

Yes

UserId :  Value from Column 4

UserName : Value from Column 4

PersonIdExternal : Value from Column 4

No

No

Yes

Yes

UserId :  Value from Column 4

UserName : Value from Column 4

PersonIdExternal : Value from Column 4

No

No

No

No

UserId :  Value from DB Seq/Sysconfig

UserName : Value from DB Seq/Sysconfig

PersonIdExternal : Value from DB Seq/Sysconfig

 In Rehire with New Employment:

Is Username filled out
i
n the UI?

Hire/Rehire 
Config Rule

Output

Yes

Yes

 UserId: Value from column 2

 UserName: Value from column 1

Yes

No

 UserId: Value from column 1

 UserName: Value from column 1

No

Yes

 

 UserId: Value from column 2

 UserName: Value from column 2

No

No

 UserId: Value from DB Seq/Sysnconfig

 UserName: Value from DB Seq/Sysnconfig

FAQ - Additional Information

Q) Where can I get information on this from the Guide?

A)

See Also

  • 2418814 - How to configure an MDF Sequence object and Business Rule to auto-generate Person ID during Hire
  • 2502254 - Auto-generate Incremental External Code on MDF Object
  • 2493579 - Employee Central: Person/User IDs Used Within Employee Central - SuccessFactors Employee Profile
  • 2495643 - SuccessFactors User IDs - Clarifying the Different IDs
  • 2346919 - Add New Employee Wizard : How to configure "Use this Match" feature (Hire/Rehire Configuration: MATCHINGUSERCONFIG)
  • 2424358 - Rehire Inactive Employee with New Employment
  • 2459427 - Hide User Id and Username in New Hire wizard 
  • 2785629 - Check Tool: How to use Check Tool to check for duplicate usernames 
  • 2392253 - How to modify employee User ID
  • 2287959 - Person ID External already exists
  • 2730512 - Changing Username - Error Username already exists, please choose another one - Platform BizX

Keywords

sf, success factors, EC, ECT-96783, ECT-29059, ECT-90028, ec, rehire, new employment, person-id-external, userID, generate userID, username, rule, hire, rehire with new employment , KBA , LOD-SF-EC-HIR , Hire & Rehire Wizards , How To

Product

SAP SuccessFactors Employee Central all versions