Installation - Employees

​

Prerequisites

• A valid TechWolf contract and access to a live TechWolf tenant.
  • This tenant must contain Employees corresponding to the PerPerson entities present in SAP SuccessFactors. This can be achieved by either:
    • Using the Standard Employee Data Input Integration .
    • Creating custom input integrations. When doing this, ensure the TechWolf SkillEngine API Employees are linked with their SAP PerPerson counterparts by using the Per Person UUID (perPersonUuid) as the TechWolf Employee ID (external_id). Additionally, each TechWolf Employee should have a custom property called person_id_external with as value the Person External ID of the corresponding PerPerson entity in SAP SuccessFactors. More information on custom properties can be found in the API Reference .
• An SAP SuccessFactors environment with Talent Intelligence Hub implemented.
  Enabling Talent Intelligence Hub activates two essential features for this integration: - Attributes Library: Enables using TechWolf skills in your SuccessFactors environment. - Employee Growth Portfolios: Enables skill assignments to employees, allowing to synchronize validated employee skills between TechWolf and SAP.
• Access to the TechWolf SFTP server to host the integration files.
• A successful SAP support case to whitelist the TechWolf SFTP server .
• 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 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 installation guide.

​

SAP SuccessFactors Configuration

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 (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
   • 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 provided by TechWolf.
   • 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 the 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”
     • 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.
   If you already created an OAuth2 Client Application for the another TechWolf - SAP SuccessFactors Integration, this step can be skipped.

5. Create Employee Growth Portfolio Export Schedule Follow the steps in How To: Load Export Integration Definitions to create a new export integration definition that will create an export of employee growth portfolios. Use the values from the table below when setting up the integration definition. Preferably, the time of day of the Start Time of the schedule is set to be some time (e.g. one hour) after the time of day of the Start Time of the Attribute Import Schedule (Step 1) of the Skills Taxonomy Sync .

   Configuration Item	Value
   Integration Definition	techwolf_employee_growth_portfolio_export_definition.icd
   File Name Prefix	EmployeeGrowthPortfolioExport
   Date Suffix Format	yyMMddHHmmssZ
   File Folder	/tih/exports/employee_growth_portfolio

​

TechWolf Configuration

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, must 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 )
   • The number of proficiency levels for skill attributes in SAP SuccessFactors (see How To: Manage the Skill 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.
3. TechWolf enables the schedule to consume the SAP SuccessFactors Growth Portfolio export files on TechWolf’s side.

​

Configuration Options

​

Sync Direction

• Bidirectional (default): Two-way sync between TechWolf and SAP SuccessFactors
• TechWolf to SAP Only: Skills flow from TechWolf to SAP SuccessFactors only
• SAP to TechWolf Only: Skills flow from SAP SuccessFactors to TechWolf only

​

Merge Strategy

• 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.
• Push TechWolf: Uses the TechWolf Employee Skill Profile as the initial source of truth, and will align the SAP SuccessFactors Employee Growth Portfolio with it.
• Push SAP: Uses the SAP SuccessFactors Employee Growth Portfolio as the initial source of truth, and will align the TechWolf Employee Skill Profile with it.

​

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 Employee Growth Portfolio of the integration user.
5. TechWolf: Run initial sync of user profiles with TechWolf API.
6. TechWolf: Setup tenant configuration and start sync process based on configured direction.
7. Customer: Check end-user test scenarios.