> ## 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.
# Installation
### Prerequisites
Before continuing, ensure you have the following:
* A valid TechWolf contract and access to a **live TechWolf tenant**.
* This tenant must contain Jobs corresponding to the Job Roles present in
SAP SuccessFactors. This can be achieved by either:
* Using the
[Standard Job Data Input Integration ](/integrations/datasource-integrations/sap-standard-input-integration/overview).
* Writing custom input integrations. When doing this, ensure the
TechWolf SkillEngine API Jobs are linked with their SAP SuccessFactors
Job Role counterparts by using the SAP Job Role ID (`Role_GUID`) as
the TechWolf Job ID (`external_id`).
* An SAP SuccessFactors environment with **Talent Intelligence Hub** and **Job
Profile Builder** implemented.
* The necessary setup of the Attributes Library in SAP SuccessFactors.
* This includes at least the following:
* A proficiency rating scale of your choice, aligned with the one
configured for SAP in TechWolf. Preferably, the default TechWolf
proficiency scale (1-5) is used. Contact your TechWolf representative
for the current configuration, or to update the configuration. See
[How To: Manage the Skill Proficiency Rating Scale ](/integrations/sap-skill-sync-integration/how-to-manage-proficiency-rating-scale)
for more information on how to manage the proficiency rating scale in
SAP SuccessFactors.
* The desired set of TechWolf skills present and active in your SAP
Attributes Library, as Attributes of the default "Skill" iconType
* More information on the Attributes Library and the maintenance of the
Attributes Library in SAP SuccessFactors can be found in the
[Skills Taxonomy Sync ](/integrations/sap-skill-sync-integration/installation-skills-taxonomy)
installation guide.
## SAP SuccessFactors Configuration
TechWolf has already pre-configured some parts of the integration. The following
ZIP archive contains the necessary files that will be used in the subsequent
steps to configure the integration in SAP SuccessFactors.
Required files for the SAP Job Skill Sync Integration
### 1. Find out the correct SAP SuccessFactors Company ID
* As an SAP administrator, log into the SAP SuccessFactors environment you want
to configure the integration for.
* Click on your profile icon in the top right corner and select "Show version
information".
* The Company ID will be shown in the resulting window.
### 2. Find out the correct SAP SuccessFactors API URL
* As an SAP administrator, go to
[SAP for Me ](https://me.sap.com/systemsprovisioning/systems)
(if you have multiple credentials, sign in with your S-User credentials).
* In the *Public Cloud Systems* table, find the system you want to configure the
integration for.
* This system should have the value "SAP SuccessFactors HCM" in the
`Cloud Service` column.
* The `Data Center` column will show the location of the data center of the
system, e.g. "Netherlands: Eemshaven".
* Go to the
[List of SAP SuccessFactors API Servers ](https://help.sap.com/docs/successfactors-platform/it-landscape-requirements-for-sap-successfactors/list-of-sap-successfactors-api-servers)
* In the *API Servers* table, find your Data Center.
* This Data Center should have the previously determined data center location
as the value of the `Location` column. Note that the location name might
differ in format from the location name in the previous step, e.g.
"Eemshaven, The Netherlands" vs "Netherlands: Eemshaven". Among all rows
with this location, find the row with the appropriate value for the
`Environment` column.
* The `API Server` column will show the API URL for the API Server.
### 3. Create a TechWolf User in your SAP SuccessFactors environment
* In the search bar at the top right of SAP SuccessFactors, enter
`Import Employee Data`.
* In the resulting window, under the `Select an entity` dropdown, choose "Basic
Import". In the `Choose File` field, upload the
`techwolf_api_user_definition.csv` file from the required-files zip downloaded
above.
* Leave the other fields unchanged and click `Validate Import File Data`. If the
validation is successful, click `Import`.
If you already created a TechWolf User for another TechWolf - SAP
SuccessFactors integration, this step can be skipped.
### 4. Create a new OAuth2 Client Application
* In the search bar at the top right of the screen, enter
`Manage OAuth2 Client Applications` and press enter.
* In the window that opens, click `Register Client Application`.
* In the resulting page, the following fields must be filled in:
* `Application Name`: "TechWolf Skill Sync"
* `Application URL`: "[https://techwolf.ai](https://techwolf.ai)"
* `Bind to Users`: Check the checkbox
* `User IDs`: `TechWolf_TIH_GP` (refers to the user created in the previous
step)
* `X.509 Certificate`: Go to your TechWolf point of contact to request the
certificate file. Once you received the file, open it. It will have the
following text guards around it: "-----BEGIN CERTIFICATE-----" and "-----END
CERTIFICATE-----". Copy all the text in between these guards and paste it
into the `X.509 Certificate` field.
* Now, click `Register`.
* Once the Client Application is registered, go back to the
`Manage OAuth2 Client Applications` page and find the application you just
created. Click `View` on it.
* On this view, you can see the `API Key` you will need for the integration
configuration.
### 5. Configure the permissions for the TechWolf user
The `TechWolf_TIH_GP` user needs a Permission Group and a Permission Role to run
the Skill Sync.
If another TechWolf - SAP SuccessFactors integration using the
`TechWolf_TIH_GP` user has already been configured in this tenant, the
Permission Group and Permission Role already exist. Skip the group creation
and role assignment steps below and only **add the missing permissions** from
the table to the existing Permission Role.
* **Create a Permission Group**
* In the search bar at the top, enter `Manage Permission Groups` and open
it.
* Click `Create New`.
* Name the group `TechWolf_TIH_GP`.
* Pick the `Username` filter and set it equal to `TechWolf_TIH_GP`.
* Click `Done`.
* **Create a Permission Role**
* In the search bar at the top, enter `Manage Permission Roles` and open it.
* Create a new Role with user type `Employee`.
* Under `Administrator Permissions` →
`Manage Job & Skill Profile Visibility`, grant the following:
| Permission | Access |
| ----------------------------------------- | ------------------------------------------- |
| Role | View, Edit |
| Role.Mapped Skills (Role & Skill Mapping) | View, Correct, Create, Adjust Order, Delete |
* Save the Permission Role.
* **Assign the Permission Role to the Permission Group**
* On the saved Permission Role, click `Add Role Assignments`.
* Click `Next`.
* On the `Grant Access To` page, select `From Groups`.
* Click `Select Groups` and pick the `TechWolf_TIH_GP` group created above.
* Click `Next`, then `Next` again, and save the Role Assignment.
If the `Role` or `Role & Skill Mapping` permissions are not visible in
your tenant, enable separate security permissions for the `RoleEntity`
and `RoleSkillMappingEntity` object definitions:
* In the search bar at the top, enter `Configure Object Definitions`
and open it.
* Search for `Object Definition` → `Role`.
* Use `Take Action` → `Make Correction`.
* Configure the `Security` section according to the following screenshot. Click the "+" button in case the fields are missing.
* Scroll to the bottom of the page and click `Save`.
* Repeat the above steps for `Object Definition` → `Role & Skill Mapping`.
On recent SAP SuccessFactors releases, the Talent Intelligence Hub adds data
source governance for external skill providers. If your tenant exposes the
**Manage Data Sources** task or a **Manage Skills Governance** section under
**Manage Talent Intelligence Hub**, complete
[How To: Register TechWolf as a Trusted Data Source ](/integrations/sap-skill-sync-integration/how-to-register-data-source)
so Job Role skill updates from TechWolf flow through without additional
manual review.
## TechWolf Configuration
The TechWolf tenant will be configured by TechWolf itself.
1. In the integration service on the TechWolf side, TechWolf adds the
credentials of the customer-created integration user. For this, the customer
will need to share the following values with TechWolf:
* The Company ID of the SAP SuccessFactors environment (see Step 1 of the
SAP SuccessFactors Configuration section)
* The API URL of the SAP SuccessFactors environment (see Step 2 of the SAP
SuccessFactors Configuration section)
* Username of the integration user (see Step 3 & 4 of the SAP SuccessFactors
Configuration section, should be `TechWolf_TIH_GP`)
* The API Key of the OAuth2 Client Application (see Step 4 of the SAP
SuccessFactors Configuration section)
Additionally, the customer will need to share the following configuration
settings with TechWolf:
* The minimum proficiency level for skill attributes in SAP SuccessFactors
(see
[How To: Manage the Skill Proficiency Rating Scale ](/integrations/sap-skill-sync-integration/how-to-manage-proficiency-rating-scale))
* The number of proficiency levels for skill attributes in SAP
SuccessFactors (see
[How To: Manage the Skill Proficiency Rating Scale ](/integrations/sap-skill-sync-integration/how-to-manage-proficiency-rating-scale))
2. TechWolf adds TechWolf API credentials with correct scopes to have access to
the TechWolf API and links that TechWolf tenant to the SAP SuccessFactors
tenant.
## Configuration Options
### Sync Direction Settings
The integration supports three sync direction options:
* **Bidirectional** (default): Two-way sync between TechWolf and SAP
SuccessFactors; changes made in TechWolf Job Skill Profiles are synchronized
to their corresponding SAP SuccessFactors Job Skill Profiles, and vice versa.
* **TechWolf to SAP Only**: Skills flow from TechWolf to SAP SuccessFactors
only; changes made in SAP SuccessFactors Job Skill Profiles are copied to
their corresponding TechWolf Job Skill Profiles, while changes made in
TechWolf are discarded and overwritten with the state of the SAP
SuccessFactors Job Skill Profiles.
* **SAP to TechWolf Only**: Skills flow from SAP SuccessFactors to TechWolf
only; changes made in TechWolf Job Skill Profiles are copied to their
corresponding SAP SuccessFactors Job Skill Profiles, while changes made in SAP
SuccessFactors are discarded and overwritten with the state of the TechWolf
Job Skill Profiles.
### Merge Strategy Options
For the correct functioning of the normal operation of the integration, the
skill profiles in both systems should be initially aligned. The integration will
do this initial alignment itself automatically when the integration is first
enabled, or when it is re-enabled after having been paused, or when it
encounters a Job it had no knowledge about yet.
The initial alignment can happen in different ways; the integration supports
three such merge strategy options:
* **Merge Systems**: Combines skills from both systems, i.e. the resulting skill
profile in both systems will contain all skills that were present in either
system initially. In case of metadata conflicts for skills present in both
systems (e.g. conflicting proficiency levels), the values from TechWolf will
be used.
* **Push TechWolf**: Uses the TechWolf Job Skill Profile as the initial source
of truth, and will align the SAP SuccessFactors Job Skill Profile with it. Any
skills initially present in the SAP SuccessFactors Job Skill Profile but not
in the TechWolf Job Skill Profile will be removed from the SAP SuccessFactors
Job Skill Profile.
* **Push SAP**: Uses the SAP SuccessFactors Job Skill Profile as the initial
source of truth, and will align the TechWolf Job Skill Profile with it. Any
skills initially present in the TechWolf Job Skill Profile but not in the SAP
SuccessFactors Job Skill Profile will be removed from the TechWolf Job Skill
Profile.
## Deployment Tasks & Responsibilities
1. **TechWolf**: Setup Skill Sync environment and tenant requirements
2. **Customer**: Configure SAP SuccessFactors as described above.
3. **Customer**: Share nessary SAP SuccessFactors information and credentials
with TechWolf:
* Company ID
* API URL
* Username of the integration user
* API Key of the OAuth2 Client Application
4. **TechWolf**: Validate API access by attempting the addition, update and
removal of a skill in the Job Skill Profile of the integration user.
5. **TechWolf**: Run initial sync of Job Skill Profiles with TechWolf API.
6. **TechWolf**: Setup tenant configuration and start sync process based on
configured direction.
7. **Customer**: Check end-user test scenarios.