SAP Knowledge Base Article - Public

2494423 - Pre-Day 1 New Hire Permission and IsOnboardingUser Flagging - Onboarding 1.0 [Pre-Day 1]

Symptom

  • What is the logic behind IsOnboardingUser flag?
  • How can we utilize IsOnboardingUser as a permission filter in our system?

Environment

SAP SuccessFactors Onboarding 1.0 - All Versions

Reproducing the Issue

  1.  Generate report to check if 'IsOnboardingUser' has been set to 'Yes' for the Pre-Day1 user

Resolution

For Live Customer(s), Implementation Partner(s), and Consultant(s)

In general whenever you create candidate, their new account will get assigned to 2 roles "Employee(Self service) role" and "Employee(information about other employees) role" or any permission role with target population as all. The purpose of editing a data model element is to use as permission base for New Hires and limit their access to system until they complete their paper work. The Succession Data Model does not contain IsOnboardingUser field by default. By adding IsOnboardingUser as a custom field you can enable the system to initialize this parameter when Pre-Day 1 user records are created.

For every Pre-Day 1 user record, the IsOnboardingUser field value will be set to YES. Based on the field's value, you can classify Pre-Day 1 users and setup criteria for granting role-based permissions. This solution is also use for ONB-BIZX-LMS integration where duplicate accounts are created ('Use Same UserID' not enabled).

 

Configuring Data Model for Pre-Day 1 Access

For live customer(s), editing the custom field is scope of support and should be initially done by an SAP Certified Partner/Consulant or SAP Professional Services. See below instruction on how it is done.

  • Step 1: Logon to SAP SuccessFactors back end and access target customer instance
  • Step 2: Download the Succession Data Model in Import/Export Data Model
  • Step 3: Replace one of the 15 custom data model element fields with ID 'IsOnboardingUser'

    In below example, custom2 field has been renamed and below changes need to be done in succession data model xml

    BEFORE

    <standard-element id="custom01" max-length="255" required="false" matrix-filter="false">
        <label>Customizable Field 1</label>
        <label xml:lang="en-US">Customizable Field 1</label>
    </standard-element>

    AFTER
     
    <standard-element id="custom01" max-length="255" required="false" matrix-filter="false">
        <label>IsOnboardingUser</label>
        <label xml:lang="en-US">IsOnboardingUser</label>
    </standard-element>
     
  • Step 4: Save the file
  • Step 5: Upload the data model back to SAP SuccessFactors back end

 

IsOnboardingUser Logic

  • When the Hiring Manager or Recruiter verified the information of the new hire in Post-Hire Verification step, Pre-Day 1 User will be created after the step is completed. The element contains IsOnboardingUser will now have a value of YES.
  • For customers with Employee Central, when the Hiring Manager or Recruiter added the new hire in the system via Manage Pending Hires the value will turn to NO; for customers without Employee Central after the OnStartDate job picks the new hire and change the status to hired, IsOnboardingUser will have a value of NO.

 

IsOnboardingUser as Filter for Role Based Permissions

  • System Administrators may utilize this custom field as a filter level when creating a Permission Group, this group will help limit what new hires can access
  • The IsOnboardingUser flag is also use to exclude new hire accounts in employee export to BizX-LMS integration

    SAPSUPPORT-00026 06-13-2019 9.52.25 AM.png

    SAPSUPPORT-00027 06-13-2019 9.56.17 AM.png

 

Limitations

IsOnboardingUser status will not changed if New Hire's OnboardingCandidateInfo Object hired flag is manually changed using Import and Export Data

See Also

Related SAP Help Guide

Configuring Data Model for Pre-Day 1 Access

Keywords

Pre-day hireIsOnboardingUser flag, pre hire permission, Onboarding, Preday, predayone, pre-day 1, pre-day one , KBA , LOD-SF-OBD-INT , Integrations with Onboarding , How To

Product

SAP SuccessFactors Onboarding all versions