Integrate Onboarding 1.0 data to Custom MDF object / portlet in Employee Central – COVID-19 Vaccine Tracking portlet

Context:

Many of us might have had customer requirements to integrate Onboarding 1.0 data to Custom MDF object / portlet in Employee Central. For example., Integrate COVID 19 Vaccine Tracking data from Onboarding 1.0 to an MDF COVID 19 Vaccine Tracking portlet. While this requirement is identified as a product enhancement, there is an alternate way to integrate the data across modules and to the Custom MDF object / portlet in Employee Central.

This post explains about the workaround solution that can be implemented to integrate data collected during Onboarding process to a Custom MDF object / portlet in Employee Central with a reference to COVID-19 vaccination tracking. This is achieved by leveraging Intelligent Services for ‘Employee Recruitment’ Event and Integration Centre.

Prerequisites:

  1. Enable Employee Central
  2. Enable Intelligent Services Centre using the Upgrade Centre(ISC)
  3. Integration Centre
  4. COVID-19 Vaccine Tracking MDF is either enabled (SAP standard portlet) or configured as a custom object through Admin Center> Configure Object Definitions
  5. COVID-19 Vaccine Tracking portlet is configured through Admin Center> Manage Configuration UI and added to People Profile.
  6. COVID-19 Vaccine Tracking portlet fields are configured in Onboarding panels.

Configuration:

  1. Configure necessary fields in one of the HRIS elements in Employee Central:
    • Admin Center> Manage Business Configuration> Select [HRIS element]

In the example below, the fields are created under Personal Info because COVID-19 data are identified personal.

COVID19%20ONBTOECMDF%20ECPersonalInfo

Note: The above fields are not granted RBP permissions for any role to keep it hidden in Employee Profile. These fields will appear while hiring a candidate under Manage Pending Hires and can be hidden through a business rule (KBA: https://launchpad.support.sap.com/#/notes/0002080655).

2. Map the fields from Onboarding 1.0 to respective fields in Employee Central through Admin Center> Field Mapping tool for integration with Employee Central

COVID19%20ONBTOEC%20Map

3. Configure a business rule in Job Information portlet – To trigger Intelligence Service during New Hire

    • Create a Basic rule with ‘Employment Information Model’ as the Base Object

COVID19%20ONBTOECMDF%20Business%20Rule

    • Set the rule condition to execute ‘Trigger New Hire Event’

COVID19%20ONBTOECMDF%20Rule%20Trigger

4. Assign the Business rule

    • Navigate to Admin Center> Manage Business Configuration> ‘jobInfo’ element

COVID19%20ONBTOECMDF%20Add%20Rule

    • Scroll all the way down to the ‘Trigger Rules’ section
    • Add the business rule as a ‘onPostSave’under ‘Job Information Model’ and Save

COVID19%20ONBTOECMDF%20Assign%20Rule

Configure Intelligent Services for ‘Employee Recruitment’ event – Create and assign Integration Centre flow

    • Navigate to Admin Center> Intelligent Services Centre (ISC)
    • Search and select the Event> Employee Recruitment

COVID19%20ONBTOECMDF%20ISC

    • Under ‘Activities’, Select ‘Integration’ tab

COVID19%20ONBTOECMDF%20ISC%20Config

  • Click ‘OK’ and ‘Create a new integration’ in the pop-up window

Create%20a%20new%20integration

  • In the ‘Choose Integration Type’ pop-up, select the following:
    • Destination Type: SuccessFactors
    • Format: OData v2
  • Click ‘Create’
  • The system redirects to the Integration Centre

The%20system%20redirects%20to%20the%20Integration%20Centre

  • Enter an Integration Name and Description
  • Click ‘Next’

COVID19%20ONBTOECMDF%20IC

  • Switch to Field Mapping view

COVID19%20ONBTOECMDF%20IC%20FieldMappingView

  • Click ‘+’ in the ‘Destination Fields’ section
  • Search, Select, and Add ‘[Custom MDF object]’ as starting Node in Integration Centre. For example., COVID-19 vaccine tracking

COVID19%20ONBTOECMDF%20IC%20Node

  • Map and Assign the fields
  • This is completed by drag and drop from Source Fields to Destination Fields in the custom MDF

COVID19%20ONBTOECMDF%20IC%20FieldMap

  • The other field mappings should have the following associations: userNav/empInfo/personNav/personalInfoNav/*/

In my experience, never search for the fields as the system picks the logged in users mapping than the userNav. Hence ensure that you navigate the tree entity one by one to reach userNav/empInfo/personNav/personalInfoNav/*/[custom fields you have configured]

COVID19%20ONBTOECMDF%20IC%20FieldMap2

Note: If you have a picklist field to be mapped then ensure that the externalCode is selected as shown below:

COVID19%20ONBTOECMDF%20IC%20FieldMap4

COVID19%20ONBTOECMDF%20IC%20FieldMap3

  • Once all fields are mapped; Click ‘Next’
  • Skip ‘Filter’, Click ‘Next’ and move to ‘Review and Run’
  • Click Save> Save

COVID19%20ONBTOECMDF%20IC%20Schedule

Save%20Integration%20Success

6. Set the Intelligent Services Flow Rule

    • Navigate to Admin Center> Intelligent Services Centre (ISC)
    • Search and select the Event> Employee Recruitment

COVID19%20ONBTOECMDF%20ISC

  • Under ‘Activities’, Select ‘Integration’ tab

COVID19%20ONBTOECMDF%20ISC%20Config

  • In the pop-up window, Select the integration definition configured and click ‘Add Integration’

COVID19%20ONBTOECMDF%20IC%20AddIntegration

  • This adds the new integration to the Flow Rule.
  • Set the ‘Timing’ to ‘When event is published’

COVID19%20ONBTOECMDF%20IC%20SetTiming

  • Make sure you have saved the changes under Actions> Save Flow

COVID19%20ONBTOECMDF%20IC%20SaveFlow

COVID19%20ONBTOECMDF%20IC%20SaveFlowOK

Every time a new hire happens in Employee Central, the ISC will trigger the Integration Centre job. This then sync and map over the data stored under personal information portlet to the custom MDF portlet.

COVID19%20ONBTOECMDF%20EP

CONCLUSION:

This blog post describes how an integration can be created between Onboarding 1.0 and a Custom MDF object. The same integration logic can be used to map over other information from Onboarding 1.0 to any Custom MDF object.

With the solution proposed we aim to avoid manual entry of Onboarding 1.0 data into an MDF portlet in Employee Central. This workaround updates the system within the same information from Onboarding 1.0.

Additional Note:

  1. While all other fields are supported, it is not possible to directly integrate any attachments or forms from Onboarding to EC.
  2. This logic can be configured to map any data collected during Onboarding 1.0 process to a custom MDF portlet in EC.
  3. Any HRIS element (preferably Personal Info or Job Info) can be used to configure the fields and map fields from Onboarding 1.0.
  4. Metadata Framework | How to create a custom field for a MDF Object?
  5. How to Configure a UI for a Generic Object in Meta Data Framework – [MDF]
  6. How to create a Custom MDF Portlet in the Employee/People Profile?

Please provide your feedback and any questions in the comments box.