Overview
This document describes the skill sync integrations between SAP SuccessFactors and TechWolf. These integrations synchronize skill profiles between the two systems. This document contains details on the configuration and the deployment of the integrations in the customer’s SAP SuccessFactors environment. The intended audience for this document is the integration implementer.
Functional Objective
Key benefits:
- TechWolf synchronizes employee and/or job skill profiles across all relevant systems, harmonizing skills between them.
- The accurate and up-to-date skills data in SAP SuccessFactors that originates from TechWolf can be used for downstream purposes in the system such as Opportunity Marketplace for employees and skills-based recruiting for jobs.
Components
Skill Inventory Sync
For skill profiles to be synchronized between TechWolf and SAP SuccessFactors, part of the TechWolf skill vocabulary must be uploaded to the Attributes Library of the SAP SuccessFactors Talent Intelligence Hub. By doing this, TechWolf skills can be displayed and used everywhere in SAP SuccessFactors.
Additionally, if you have a TechWolf taxonomy, tags for each of the skill clusters are loaded into SAP and attached to the skills in those skill clusters.
To minimize load on the SAP system, only the part of the TechWolf skill vocabulary currently in use for the in-scope entities (i.e. the validated skills present in at least one skill profile of an in-scope entity); this in-use subsection of the TechWolf skill vocabulary is also referred to as the “Skill Inventory”. Since the subset of skills in use can change, this subset cannot simply be loaded in once, but will be actively maintained.
The management of the Attributes Library in relation to these integrations happens in a file-based manner, managed from the SAP SuccessFactors Integration Center, with Integration Center Definitions provided by TechWolf.
The Skill Inventory Sync is a prerequisite for the Employee and Job Skill Syncs.
Employee Skill Sync
The SAP Employee Skill Sync integration is a two-way data flow between SAP SuccessFactors and the TechWolf SkillEngine API. This allows the two systems to have up-to-date, in-sync and accurate skill profiles for employees. Note that TechWolf Employees are linked to SAP Per Person entities.
Within SAP, employees assigned to job roles automatically inherit all skills of those job roles, on top of any other skills they may have.
Job Skill Sync
The SAP Job Skill Sync integration is a two-way data flow between SAP SuccessFactors and the TechWolf SkillEngine API. This allows the two systems to have up-to-date, in-sync and accurate skill profiles for jobs. Note that TechWolf Jobs are linked to SAP Job Roles.
Data Flow
Skill Inventory
The management of the Attributes Library in relation to the Skill Sync integrations happens in a file-based manner, managed from the SAP SuccessFactors Integration Center, with Integration Center Definitions provided by TechWolf. These ICDs can be found in the Installation Guide .
This management process consists of the following steps, which are automatically executed on a daily schedule:
- Firstly, the relevant TechWolf skills are loaded into the SAP SuccessFactors Attributes Library.
- Secondly, the previously imported skills are extracted from the Attributes Library, with their SAP-generated WSM ID. The result of this can then be used by TechWolf to automatically construct a mapping between the TechWolf skill IDs and the WSM IDs for all relevant skills. These WSM IDs can subsequently be used in the Skill Sync integrations to reference the skills in situations where the external id of the skill (which will match the TechWolf skill ID) cannot be used.
If a TechWolf taxonomy is present, the following steps will also be executed:
- The TechWolf skill clusters from the taxonomy are loaded into SAP SuccessFactors as tags.
- Finally, the appropriate skill cluster tags will be attached to the skills in SAP, matching the TechWolf taxonomy. An “Out of Taxonomy” tag will be given to the skills that are not part of the taxonomy. Note that one TechWolf skill can belong to multiple TechWolf skill clusters, and multiple tags can then also be given to one skill within SAP.
Employees
Whenever employee skills are validated or rejected in the SkillEngine API, this information is immediately forwarded to the Talent Intelligence Hub in SAP SuccessFactors, using the SAP SuccessFactors Talent Intelligence Hub REST API. In particular, the following endpoint is used: PATCH - /rest/ecosystem/wholeself/v1/growthPortfolios.
Changes that are made to the employee skill profile within SAP SuccessFactors are reflected back to the TechWolf SkillEngine API on a regular basis (daily), in a file-based manner, managed from the SAP SuccessFactors Integration Center, with an Integration Center Definition provided by TechWolf. This ICD can be found in the Installation Guide.
Jobs
Whenever job skills are validated or rejected in the SkillEngine API, this information is immediately forwarded to SAP SuccessFactors, using the OData API for Skills Management. In particular, the following endpoints are used:
POST /odata/v2/upsertfor theRoleSkillMappingEntity(to add skills for a job role)DELETE /odata/v2/RoleSkillMappingEntity(RoleEntity_externalCode='<role_code>', externalCode='<role_skill_mapping_code>')(to remove skills for a job role)
Changes that are made to the job skill profile within SAP SuccessFactors are reflected back to the TechWolf SkillEngine API on a regular basis (at least daily), using the OData API for Skills Management. In particular, the following endpoint is used:
GET /odata/v2/RoleSkillMappingEntity?$filter=RoleEntity_externalCode eq '<role_code>'
Installation
To install the SAP SuccessFactors Skill Sync integrations, please follow the installation guides given below. Please note the prerequisites given for each integration before the installation can be completed.
Was this page helpful?