Skip to main content
The SAP SuccessFactors via BTP Data Source Connector is an API-based integration that extracts HR data from SAP SuccessFactors through the SAP Integration Suite. TechWolf calls the iFlow over HTTPS; the iFlow calls SuccessFactors on the customer’s behalf and stages the results in TechWolf-managed storage for ingestion into the SkillEngine API.

Prerequisites

  • An active TechWolf contract.
  • A working SAP SuccessFactors tenant.
  • A working SAP BTP tenant with SAP Integration Suite provisioned, including the Build Integration Scenarios capability.
The full prerequisites and the BTP-side roles required are listed on the Installation page.

Key benefits

  • Customer-owned infrastructure: every call to SuccessFactors is performed in the customer’s BTP tenant, giving the customer full visibility via BTP’s Monitor Message Processing view and keeping SuccessFactors credentials inside the customer’s BTP Keystore.
  • Single package, multiple data types: one BTP package serves all enabled data types. Enabling or disabling a data type does not require a new install.
  • No file infrastructure: no SFTP, no report schedules, no export files (integration center definitions). Data flows from SuccessFactors through the iFlow to TechWolf storage.
Note that this is a valid but equivalent alternative to the Integration Center definition-based method of extracting data. The most notable difference is that data moves through the BTP platform.

How it works

  1. TechWolf calls the integration over HTTPS to request a run for a given data type.
  2. The integration acknowledges the request and processes the work asynchronously.
  3. The process calls SuccessFactors with the entity set and query for the requested data type, paginates through the results, and writes them to TechWolf-managed storage.
  4. TechWolf ingests the staged data into the SkillEngine API using connectors.
See the How It Works page for the full flow.

Available data types

The connector supports the following data types. Each data type corresponds to a SuccessFactors OData V2 EntitySet and requires the corresponding SuccessFactors permissions to be granted to the technical user used by the iFlow. These permissions are detailed on the Installation page.
Basic Employee identity and account status, sourced from the UserAccount EntitySet.
Output fieldDescription
accountIdThe SuccessFactors account ID
accountUuidThe SuccessFactors account UUID
accountStatusWhether the account is active
userTypeThe user type
perPersonUuidThe Per Person UUID linking the account to the underlying person
personIdExternalThe external Person ID
userIdThe User ID
departmentThe user’s department
managerUserIdThe User ID of the user’s manager
lastModifiedDateTimeTimestamp of the last modification
Employee certifications, sourced from the Background_Certificates EntitySet.
Output fieldDescription
backgroundElementIdBackground element ID for the certificate row
userIdThe Employee’s User ID
perPersonUuidThe Per Person UUID linking the certificate to the Employee
nameName of the certification
descriptionDescription of the certification
startDateDate the certification was issued
endDateDate the certification expires
lastModifiedDateTimestamp of the last modification
Employee course history, sourced from the Background_Courses EntitySet.
Output fieldDescription
backgroundElementIdBackground element ID for the course row
userIdThe Employee’s User ID
perPersonUuidThe Per Person UUID linking the course to the Employee
courseName of the course
endDateEnd date of the course
instructionTypeLocalised label for the type of instruction
lengthLocalised label for the course length
lastModifiedDateTimestamp of the last modification
Employee education history, sourced from the Background_Education EntitySet.
Output fieldDescription
backgroundElementIdBackground element ID for the education row
userIdThe Employee’s User ID
perPersonUuidThe Per Person UUID linking the education to the Employee
schoolName of the educational institution
degreeLocalised label for the degree obtained
majorLocalised label for the field of study
startDateStart date of the education
endDateEnd date of the education
lastModifiedDateTimestamp of the last modification
Employee external work history, sourced from the Background_OutsideWorkExperience EntitySet.
Output fieldDescription
backgroundElementIdBackground element ID for the work-experience row
userIdThe Employee’s User ID
perPersonUuidThe Per Person UUID linking the work experience to the Employee
employerName of the previous employer
startTitleJob title at the previous employer
startDateStart date of the position
endDateEnd date of the position
lastModifiedDateTimestamp of the last modification
Employee internal staffing history, sourced from the EmpJob EntitySet. The connector requests the full effective-dated history per Employee (not only the current job).
Output fieldDescription
userIdThe Employee’s User ID
perPersonUuidThe Per Person UUID linking the job period to the Employee
jobCodeJob code of the position
jobTitleJob title of the position
startDateStart date of the job period
endDateEnd date of the job period
seqNumberSequence number of the effective-dated row
employmentStatusEmployment status for this period
lastModifiedDateTimeTimestamp of the last modification
Job Profile Builder families (job architecture, not per-Employee), sourced from the FamilyEntity MDF object. parentFamily carries the family hierarchy.
Output fieldDescription
externalCodeExternal code of the family
name_en_USFamily name (en_US locale)
name_defaultValueFamily name (creator-locale default)
parentFamilyExternal code of the immediate parent family (hierarchy)
statusWhether the family is active
Job Profile Builder roles (job architecture), sourced from the RoleEntity MDF object. A single canonical job code is resolved from the role’s job-code mappings.
Output fieldDescription
externalCodeExternal code of the role
name_en_USRole name (en_US locale)
name_defaultValueRole name (creator-locale default)
familyExternal code of the family this role belongs to
job_codeCanonical job code for the role (lowest job classification mapping)
statusWhether the role is active
Job Profile Builder profiles — the readable description attached to a role — sourced from the JobProfile MDF object. Section bodies are returned inline per locale; only published profiles are included (drafts are excluded).
Output fieldDescription
externalCodeExternal code of the profile
name_en_USProfile name (en_US locale)
name_defaultValueProfile name (creator-locale default)
roleExternal code of the role this profile describes
headerEnUsHeader section text (en_US)
headerDefaultHeader section text (creator-locale default)
footerEnUsFooter section text (en_US)
footerDefaultFooter section text (creator-locale default)
longDescriptionEnUsLong description text (en_US)
longDescriptionDefaultLong description text (creator-locale default)
shortDescriptionEnUsShort description text (en_US)
shortDescriptionDefaultShort description text (creator-locale default)
statusWhether the profile is active
Not all data types need to be enabled. Work with TechWolf to select the data types that are relevant for your use case. SuccessFactors permissions only need to be granted for the data types you choose to enable.

Next steps

How It Works

Detailed walkthrough of the connector’s flow, configuration, and authentication model.

Installation

Step-by-step guide to install the connector in your SAP BTP tenant and grant the required SuccessFactors permissions.