Symptom
- This Knowledge Base article provides an explanation how to sync Positions from BizX to Onboarding using the Integration Center.
- 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 HCM Suite
- SAP SuccessFactors Onboarding
Resolution
Prerequisites:
- An additional XSLT will need to be imported into Super Admin by the Operations team
- Please follow the steps outlined in KBA 2473170 Additional Corporate structure XSLT File-Onboarding, for this import.
- Once that is completed, and the file is visible in the Super Admin UI, then:
Create an additional Corporate Structure level
- Navigate to Super Admin
- Corporate Structure
- Add Level, enter level number, Title, Data Key for Level Code,
Data Key for Level Name, check Show in UI, Show in User Profile, and Create - Navigate to BizX
- Admin Center
- Integration Center
- My Integrations
- Create, select 'Scheduled Simple File Output Integration'
- Search for Position
- Select it
- Choose Code (code) String(128), and Job Title (jobTitle) String(255)
- Click next
- Output File Type is CSV, Header Type is Simple Header
- Click Next, on the Configure Fields remember the headings of the report as it will be used later
- Click Next, Filter and sort is optional
- Destination setting, SFTP host address(URL) and credentials will go on the File Server Setting
- File Name is a combination of ONBAcountID_Position_Sync, File Extension is CSV,
File Folder by standard will be /ONB/inbound (where the folder is located in SFTP) - For scheduling, choose when it occurs, and the Start Time (Must be a future date)
- Click next and save
Before running the job, additional files must be configured:
- Navigate to Super Admin
- Import/Export Settings
- Export these 3 files ImportPosition, FoundationImport, and FoundationImportFieldMapping
- Open the file in a text editor
- In the FoundationImport
- Copy the Location section of the code, and edit it to suit the Position entity.
- Change the ID from SuccessFactorsLocation to SuccessFactorsPosition
- Change the File Mask from {AccountName}_Location*.csv to {AccountName}_Position*.csv
- Change the ImportXslt name from ImportLocation.xslt to ImportPosition.xslt
- Change the field Name from Location to Position
Note: the changes made in these areas is based on the title of that level in the corporate structure - In the ImportPosition file
- Customers need to provide us with the ImportPosition XSLT file to upload into the system through the back-end
- Change the OrgLevel to the appropriate Org level for Position, in this example is 5
- The name of the variables in the ImportPosition file must be changed,
the variables can be called anything, but they do have to match the variables in the FoundationImportFieldMapping - In the FoundationImportFieldMapping
- Copy the Location section
- Change the name from SuccessFactorsLocation to SuccessFactorsPosition
- The Keys must match the variable in the ImportPosition XSLT.
In the example below, they are Name and ClientID. The value must match the row heading of the report. - If you have additional fields for Position, other than the standard fields Name and ClientID in the FoundationImportFieldMapping file, then you will need to add these additional elements within a Properties container in the ImportPosition file, see the below example showing the additional elements being added to the ImportPosition file:
- Save all files and import them back in Super Admin.
See Also
Support Engineer, please see internal memo for next steps.
Keywords
Foundation Import, Position Sync, Corporate Structure, BizX, SF, Success Factors, OBD, INT, ONB , KBA , LOD-SF-OBD-INT , Integrations with Onboarding , How To
Product
SAP SuccessFactors Onboarding all versions