Symptom
- Selecting specific fields to be exported in the Custom New Hire Data Export Feature
- Export information in separate file for each employee
- Configuring export frequency
- This KB article explains how to enable the Custom New Hire Data Export Feature
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 Onboarding 1.0
Resolution
For Live Customer(s)
- The Custom New Hire Data Export Feature is a job at the back end of Onboarding (Super Admin) which enables the application to send a file with candidate's record in a CSV or XML format.
- This CustomNewHireDataExportFeature triggers a user data export at any point in the Onboarding process other than the completion of the Orientation step (Standard Export if enabled).
- Enabling this feature is done by an SAP Certified Partner, Consultants, or SAP Professional Services. See KB article 2400090
For Implementation Partner(s) and Consultant(s)
When creating a custom export, follow the instructions below/use the SAP Help Guide, Create a Custom Export, to assist you on enabling this scheduled export job.
Prerequisites
- Data Dictionary Custom Tag and Mapped Keys
- Creating Custom Status in an Onboarding Process
- Enabling CustomNewHireExportFeature
Data Dictionary Custom Tag and Mapped Keys
- Go to Admin Center > Tools > Manage Onboarding Settings (Manage Onboarding/Offboarding Settings will be shown if Offboarding is enabled)
- Click on the Data Dictionary sub-tab
- Create a new Tag using a unique naming convention (for example, by clicking Integration Namespace at the left pane):
- After creating the Tag, add the fields to be included in the export job
Note:
- There is no save button, once the fields are moved to the right column it is automatically added
- The order of the columns in the file is base from the sequence of fields in the right column
Creating Custom Status in an Onboarding Process
- Log into the Onboarding backend and navigate to target account
- Select a process and the step to edit/select the step directly from the Processes screen
- Select Assign Actions and click Add Action and define the action properties
Field | Description | Example |
Name | Defines the action by choosing Select Custom Status | Select Custom Status |
Execution Type |
Defines when the action is executed. There are three options.
|
OnFinish |
Filter | Define criteria used to decide if the action should be executed | DivCode Equals SAP |
Parameters |
A status with the name specified in the Key field and the value specified in the Value field will be created when the action is executed Note! Only one parameter should be defined |
|
Reference Image: Process Assign Actions
- Click the Create button once done
Enabling CustomNewHireExportFeature
- Log into the Onboarding backend and navigate to target account
- Select Features and click CustomNewHireDataExportFeature under Integrations
- To create an export job, select the schedule first (Advance Schedule can be use to select specific days and minutes)
- Add a valid Email in the scheduled job to receive notification for failed export
- Click Add Export to create a custom data export, kindly refer to below table on how to fill the input fields
Field | Description | Example |
Custom Status Name | Enter the parameter key set when adding a custom status | ExportCustomData |
Custom Status Value | Enter the parameter key value set when adding a custom status | True |
Field Set | Select the created Tag in Data Dictionary | CustomExport |
Method | Select method of export, use SFTP | SFTP |
File Format | Use CSV to include all record in one file and XML for a separate | CSV |
Use Custom Headers | To create custom header, select the Use custom headers checkbox, then enter your custom header separated by commas in the Headers text box | |
File Name Format |
The name of the exported file Note: the timestamp is must included, otherwise export job would fail if a file with same name already exists in the folder. |
NH-{accountname}-{timestamp}.{file-format} |
Enable Encryption | Encrypt the exported file using a PGP key |
Reference Image: Create a Custom Export
- Once fields are all completed, Click Activate
Note:
- The CustomNewHireDataExportFeature uses only one schedule timings for every export created
- If you want a separate file for each new hire record, use XML format when exporting and enable "Send each record in separate file"
See Also
KB article 2400090 - Scope of SAP SuccessFactors Cloud Product Support for Onboarding
Keywords
sf, success factors, ONB 1.0, OBD, onboarding 1.0, Super Admin, Features, Customer New Hire Export, CustomNewHireExportFeature, Export, New Candidate, Data Dictionary, Tag, Namespace, keys, fields, download, Set Custom Status , KBA , LOD-SF-OBD-REP , Reporting & Analytics, Data Imports & Exports , How To