Integrate SAP SuccessFactors with Testlify

This guide walks you through retrieving integration details from SAP SuccessFactors and connecting it to Testlify.

Before you begin

• You must be an Admin of your SAP SuccessFactors instance. If you are not an admin, you will not be able to access the configuration pages described in this guide. Contact your SuccessFactors Admin to complete the setup on your behalf.
• The OData v2 API must be enabled on your instance (it is enabled by default, so this usually requires no action).

Step 1: Find Your API Domain

Your API domain depends on the region where your SAP SuccessFactors instance is hosted.

1. Open the SuccessFactors API URLs list.

2. Filter for production environments (unless you are connecting a preview instance).

   

3. Find your region and copy the corresponding API domain. For example, Germany uses https://api012.successfactors.eu/.

   

   Tip: The API domain is usually similar to your login domain. For example, if you log in at pmsalesdemo8.successfactors.com, the API is at apisalesdemo8.successfactors.com. If you are unsure, contact your SAP SuccessFactors representative.

Step 2: Find Your Company ID

1. Click your profile picture in the top right corner, then select Show version information.

   

2. Copy the value displayed next to Company ID.

   

Step 3: Create a Permission Group

1. In the search bar, enter Manage Permission Groups and open the result.

   

2. Click Create New.

   

3. Enter a name for the group. Click Pick a category and select Username.

   

4. Search for your user by username, tick the checkbox next to the user, then click Done.

Step 4: Create a Permission Role

1. In the search bar, enter Manage Permission Roles and open the result.

   

2. Click Create New.

   

3. Enter a name for the permission role.

   

4. Click Next and grant the required permissions.

   

   

5. Click Save, add the permission group you created, grant access, then click Save again.

   

Step 5: Generate OAuth2 Client Credentials

1. In the search bar, enter Manage OAuth2 Client Applications and click the action.

   

2. Click Register Client Application.

   

3. Enter a name and any valid URL for the application (any URL is acceptable). Check Bind to Users and click OK.

   

4. Enter the USERID of the admin user.
5. Do not click Generate X.509 Certificate. Instead, go to the Testlify connection flow and Copy the certificate provided there.
6. Paste the certificate from the Testlify Integration Page into the field and click Register.
7. Click View in the top row to open the registered application.
8. Copy the API Key displayed on the page.
9. Paste the API Key and the API username into the Testlify connection flow to complete authentication.

Step 6: Set Up Assessment Vendor

1. Navigate to Manage Assessment Vendors in SAP SuccessFactors.
2. Export the existing list of assessment vendors.
3. Open the downloaded file and add a new row for Testlify with these values:
   • externalPartnerCode: TESTLIFY
   • clientId: TESTLIFY

4. Return to the Manage Assessment Vendors page and import the modified file.

   

5. In your Provisioning space, go to Import/Export Assessment Vendor Packages.
6. Import the template file and add a single line with these values:
   • vendorId: TESTLIFY (or the vendor ID you created)
   • packageCode: 123
   • reportPackageCode: TESTLIFY
   • shortName: Testlify

7. Add Testlify to the languages you use.

   

Step 7: Set Up Event Notification

1. Go to the Event Notification Subscription page and add a new subscriber with these details:

   • Category: Customized
   • Subscriber ID: TESTLIFY
   • Name: TESTLIFY
   • Group: Leave empty
   • Client ID: TESTLIFY

   

2. On the External Event tab, add an event with these settings:

   • Event Type: rcm_assessment_alert_v2
   • Subscriber: TESTLIFY
   • Protocol: SOAP_OVER_HTTP_HTTPS
   • Endpoint URL: Enter the subscription URL provided by Testlify
   • Authentication: Basic
   • User: Your username
   • Password: Your password
   • Leave all remaining fields empty.

   

   

Need help? Contact support.