> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

# Job Skill Sync Integration with SAP BTP

This Deployment Guide provides instructions that will assist in the process of
deploying the SAP BTP - TechWolf Job Skill Sync Integration, including detail on
the configuration and deployment of the integration in the customer's SAP BTP
tenant and SAP SuccessFactors tenant. The intended audience for this document is
the Integration Implementer.

## Integration

The Integration has been designed, developed, tested, documented, and deployed
by TechWolf with SAP's guidance and oversight. The integration facilitates the
flow of validated Job skill data between SAP SuccessFactors and TechWolf, using
Integration Flows deployed in the customer's SAP Integration Suite. It is not
intended to address every use case a customer may be interested in. The customer
benefits by receiving pre-built, pre-tested, documented, partner-maintained
integrations that minimize implementer's effort as compared to custom
integrations for the specific use case(s) addressed.

<Note>
  This is a **distinct integration** from the direct-API [SAP SuccessFactors
  Job Skill Sync <Icon icon="link" iconType="solid" />
  ](/integrations/sap-skill-sync-integration/overview-jobs). Customers choose
  one or the other depending on their deployment model: the SAP SuccessFactors
  Skill Sync calls SAP SuccessFactors APIs directly from TechWolf. The SAP BTP
  Skill Sync uses the SAP Integration Suite running in the customer's own SAP
  BTP tenant.
</Note>

## Functional Objective

TechWolf and SAP are partnering to enhance skill management within
organizations. TechWolf leverages data from various sources, including business
systems, to infer skills. These inferred skills are seamlessly integrated into
SAP SuccessFactors Job Skill Profiles, providing a comprehensive and real-time
view of Jobs' skills. The integration also enables profile synchronization
between TechWolf and SAP, ensuring that both platforms' updates are consistently
reflected. Note that TechWolf **Jobs** are linked to SAP **Job Roles**.

Besides Skill presence or absence, the integration also synchronizes the
proficiency of the Jobs' Skills. These proficiency levels can be set in the Job
Governance interface in the TechWolf Console.

Changes that are made to the Job Skill Profile within TechWolf are synchronized
to SAP SuccessFactors instantaneously through the Integration Flows. Changes
that are made to Job Skill Profiles within SAP SuccessFactors are reflected back
to the TechWolf SkillEngine API on a regular basis (bi-hourly by default).

**Key benefits:**

* Effortless skill identification: the integration streamlines Skill
  identification for Job profiles by automatically extracting data from various
  sources (incl. SAP SuccessFactors) and leveraging TechWolf's labor market data
  to infer and structure Skills into profiles, eliminating manual efforts.
* Governance & maintenance made simple: oversee and control Job Skill Profiles
  within your Job catalog through the TechWolf Console's Job Governance
  interface, with collaborative ownership and tailored access for different user
  groups.
* Skill synchronization: TechWolf synchronizes Job Skill Profiles across all
  relevant systems, harmonizing Skills across all systems.
* Enriched downstream use cases: the accurate and up-to-date Skill data in SAP
  SuccessFactors can be used for downstream purposes within SAP.
* 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.

## The Integration Flows

The Content Package contains two Job-related Integration Flows, each deployed in
the customer's SAP Integration Suite:

* **Query RoleSkillMappingEntity** (SAP → TechWolf): TechWolf polls this iFlow
  on a regular schedule (bi-hourly by default) to fetch the current state of Job
  Role skill mappings from SuccessFactors.
* **Update RoleSkillMappingEntity** (TechWolf → SAP): TechWolf calls this iFlow
  to push Job Skill Profile changes to SuccessFactors in near-real time.

Both iFlows authenticate to SuccessFactors using an OAuth 2 SAML Bearer
Assertion backed by a customer-managed X.509 certificate, and carry the TechWolf
AIR key in their request header so SuccessFactors can attribute traffic to the
TechWolf Skill Sync partner solution.

## Reference Material

Reference materials and documentation can be found at:

* TechWolf developer documentation:
  [https://developers.techwolf.ai/ <Icon icon="link" iconType="solid" />](https://developers.techwolf.ai/)
* TechWolf Skill Sync source IP addresses:
  [IP Addresses <Icon icon="link" iconType="solid" />](/integrations/reference/ip-addresses)
* SAP SuccessFactors Talent Intelligence Hub documentation:
  [Talent Intelligence Hub <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/successfactors-platform/using-talent-intelligence-hub/talent-intelligence-hub)
* SAP Integration Suite / Cloud Integration documentation:
  [SAP Integration Suite <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/integration-suite)
* Used SAP SuccessFactors Talent Intelligence Hub OData calls:
  * `POST /odata/v2/upsert` for the `RoleSkillMappingEntity` (to add Skills to
    a Job Role)
  * `DELETE /odata/v2/RoleSkillMappingEntity(RoleEntity_externalCode='<role_code>', externalCode='<role_skill_mapping_code>')`
    (to remove Skills from a Job Role)
  * `GET /odata/v2/RoleSkillMappingEntity?$filter=RoleEntity_externalCode eq '<role_code>'`
    (to get the Skills for a Job Role)
  * `GET /odata/v2/RoleEntity?$filter=externalCode in '<role_code>'` (to check
    if a Job in TechWolf exists as a Job Role in SAP)

To deploy the integration, follow the
[Installation <Icon icon="link" iconType="solid" />](/integrations/sap-btp-skill-sync/installation-jobs)
guide.