Installation

​

System Requirements

The SAP standard integration will make use of existing SAP SuccessFactors functionality. The customer will need a TechWolf contract with a live TechWolf tenant. This tenant must be populated with the employees present in SAP SuccessFactors, which can for example be achieved by using the Standard Employee Data Input Integration.

It is also possible to load in the data in other ways, for example by writing custom input integrations. When doing this, an essential detail is linking Employees in the TechWolf SkillEngine API with their corresponding SAP SuccessFactors Per Person objects. Since an employee’s Per Person ID may differ from the external_id used in the SkillEngine API, a method for mapping these IDs is necessary. This can be done by setting a Custom Property for each Employee within the TechWolf API that contains the Per Person ID from SAP, enabling the skill sync integration to sync skills between SAP and TechWolf. More information on custom properties can be found here. Additionally, the Person External ID field in SAP SuccessFactors must also be added as a custom property for each employee in the TechWolf API.

TechWolf has already pre-configured some parts of the integration. The following ZIP archive contains the necessary files that will need to be imported into your SAP SuccessFactors environment:

.

In addition to this, you will also need an SFTP server to host the integration files. On this server, the following folders should be created: techwolf_sap_integration/datasource and techwolf_sap_integration/skillsync. You will need to share the following information about this server with TechWolf in a secure way so that TechWolf can access the files on the server and load them into our system:

• Host Address
• Host Port number (usually this is 22)
• Login Username
• FTP Password
• Host Key of your server

​

SAP SuccessFactors Configuration

​

Skill Sync Integration-specific configuration

To be able to use TechWolf skills in your SAP SuccessFactors Talent Intelligence Hub environment, an integration definition needs to be set up to regularly import newly discovered TechWolf skills into the Attributes Library of the Talent Intelligence Hub. This way, these newly discovered skills can be added to your employee growth portfolios. Next to this, a recurring export schedule of the employee growth portfolios must be created. This way, the growth portfolios present in SAP can be synchronized to TechWolf. Finally, an OAuth2 Client Application must be created to allow TechWolf to alter employee growth portfolios in SAP SuccessFactors and add new skills to them. The steps below describe how this can be achieved:

1. Create the TechWolf Skill Import Schedule

   • Go to the Integration Center by entering Integration Center in the search bar at the top of the screen.
   • In the Integration Center, click My Integrations.
   • Click the Create button at the top right of the screen, then select Import an Integration Definition.
   • In the popup, upload the techwolf_attribute_import_definition.icd file that can be found in the integration_definitions folder of the ZIP file mentioned in the System Requirements section. If any warning pops up, click OK.
   • In the Options window, keep the following Integration Name: “TechWolf Attribute Import”. Then click Next.
   • In the Configure Fields window, click Next again.
   • Under the “Destination Settings” window, choose Single Destination and enter the following:
     • SFTP Server Host Address: The address of your SFTP server (note that this does not start with “https://”).
     • Port: 22
     • SFTP User Name: The username of the SFTP server you shared with TechWolf.
     • SFTP Password: The password of the SFTP server you shared with TechWolf.
     • File Name Prefix: “TechWolfAttributesImport”
     • Date Suffix Format: “yyyyMMdd”
     • File Extension: “csv”
     • File Folder: /techwolf_sap_integration/skillsync/incoming
     • Processing Folder: /techwolf_sap_integration/skillsync/processed
     • File Decryption: “No Decryption Key”
   • Then click Next to go to the Scheduling window.
   • In the Scheduling window, choose “Daily” in the dropdown. Next, select 12:00 AM on the next day (tomorrow) as Start Time. Leave Ending On blank. Then click Next.
   • Finally, on the Review and Run page, click Set Schedule. You will get prompted to save the integration before continuing. Click Save and Continue and then Save again. The schedule is now live.

2. Create Employee Growth Portfolio Export Schedule

   • Return to the Integration Center by entering Integration Center in the search bar at the top of the screen. In the Integration Center, click My Integrations.
   • Click the Create button at the top right of the screen, then select Import an Integration Definition. In the popup, upload the techwolf_employee_growth_portfolio_export_definition.icd file found in the integration_definitions folder of the ZIP file mentioned in the System Requirements section. If any warning pops up, click OK.
   • In the window that opens, keep the following in the Integration Name text box: “TechWolf Employee Growth Portfolio Export”. Leave the Output File Type on “True CSV” and the Header Type on “Simple Header”. Now click Next.
   • In the “Configure Fields” window, click Next again.
   • Under the “Destination Settings” window, choose Single Destination and enter the following:
     • SFTP Server Host Address: The URL of your SFTP server (note that this does not start with “https://”)
     • Port: 22
     • SFTP User Name: The username of your SFTP server you shared with TechWolf.
     • SFTP Password: The password of your SFTP server you shared with TechWolf.
     • File Name Prefix: “EmployeeGrowthPortfolioExport”
     • Date Suffix Format: “yyMMddHHmmssZ”
     • File Extension: “csv”
     • File Folder: /techwolf_sap_integration/skillsync/outgoing
     • File Encryption: “No Encryption”
   • Then click Next to go to the Scheduling window
   • In the Scheduling window, choose “Daily” in the dropdown. Next, select 12:00 AM on the next date as Start Time. Leave Ending On blank. Then click Next.
   • Finally, on the Review and Run page, click Set Schedule. You will get prompted to save the integration before continuing. Click Save and Continue and then Save again. The schedule is now live.

3. Create OAuth2 Client Application

   • Create a TechWolf User in your SAP SuccessFactors environment

     • In the search bar at the top right of the screen, enter Import Employee Data.
     • In the resulting window, select “Basic Import” for the Select an entity dropdown. In the Choose File field, upload the techwolf_api_user_definition.csv file that can be found in the ZIP file mentioned in the System Requirements section.
     • Leave the other fields unchanged and click Validate Import File Data. If the validation is successful, click Import.

   • Create a new OAuth2 Client Application: Once the TechWolf User is created, it can be used to link a new OAuth2 Client Application. This will allow TechWolf to update employee growth portfolios in real time using API calls. The steps for this are as follows:

     • 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, a few fields should be filled in:
     • Application Name: “TechWolf Skill Sync”
     • Application URL: “https://techwolf.ai”
     • Bind to Users: Check the checkbox
     • User IDs: TECHWOLF_API_USER
     • 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, and share the following fields with your TechWolf point of contact: Company, API Key.
     • Finally, TechWolf will also need to know the API URL of your SAP SuccessFactors environment. This can be found by going to the overview of all SAP API URLs and finding the URL corresponding to the datacenter where your SuccessFactors environment is hosted.