SuccessFactors Integration Guide

Updated by Integrations Team

Activating the Integration 

Before you Begin 

  • You must have appropriate SAP Success Factors licensing to use the Assessment Integration. 
  • Ensure that you have Provisioning access from SAP. 

Remember: As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your implementation partner or Account Executive. For any non-implementation tasks, contact Product Support. 

  • Ensure that you grant Manage Assessment Vendors permission to recruiting users.  

Exchange of Information 

Criteria will give you: 

  • List of packages - names and IDs 
  • Details to use in the event notification subscription - URL, username and password 

You will give Criteria: 

  • SuccessFactors company ID 
  • SuccessFactors URL 
  • SuccessFactors environment name E.g., DC8 Production, DC10 Preview 
  • API user username and password (once the user is created)  

Permissions (Provisioning) 

Go to Provisioning > Company Settings. 

  • Enable the Enable Assessment Integration setting. 
  • Enable SFAPI   
  • Enable SFAPI Webservices  

Add Assessment Vendor (Admin Center) 

Add CRITERIA as an Assessment Vendor. Users with Manage Assessment Vendors permissions can add assessment vendors.  

Go to Admin Center > Manage Assessment Vendors and export the current Vendors list.  

Open the exported vendor list.  

If CRITERIA is already in the list, change the active value to 'Y', otherwise, add a new entry to the list. 

  • External Partner Code = CRITERIA 
  • Client Id = CRITERIA 
  • Active = Y 

Upload the new Assessment Vendors CSV file into SuccessFactors.   

Add Assessment Vendor Packages (Provisioning) 

Now that your CRITERIA Vendor has been created, you can add the packages for that Vendor. 

These packages will represent the Criteria Jobs that you will be able to invite candidates to complete. Criteria will provide these details, or you can get the details from your Criteria Platform Jobs list. 

Note: SuccessFactors does not allow packages to be removed, only renamed. Please ensure that your packages have been finalized before adding them into SuccessFactors. 

Go to Provisioning > Managing Recruiting > Import/Export Assessment Vendor Packages.  

Export the current packages 

Open the CSV and add the Criteria packages to the list, one per line. The following fields are mandatory: 

  • vendorId: identifies the assessment vendor the package uses. Enter CRITERIA, or whatever clientId you specified when you added the vendor.  
  • packageCode: identifies an assessment solution to use for the order. Generated by the third-party assessment vendors. Use the Criteria Job Code, in the format JB-123ABC which can be copied from your Criteria Platform jobs list.  
  • shortName: Shortened name of the package for use on the candidate summary page. The complete name appears elsewhere. Use the Criteria Job Name, or a shortened version if the name is too long to appear in the column heading  
  • Label for each locale: The combination of the country and location code for each language in which the assessment is displayed. For example: en_US, fr_FR. Add the Criteria Job Name into all the columns for the language/s you are using in SuccessFactors. 

The following columns are included in the template but aren’t used. You can leave these empty: 

  • reportPackageCode 
  • comparisongroupID  

Upload the new Assessment Vendor Packages CSV into SuccessFactors.  

SFAPI Integration User (Admin Center) 

Create the user that the integration will use to connect to SuccessFactors. Provide the username and password to Criteria.  

Create an SFAPI integration user. 

Grant Access to Event Notification Subscription permission to the SFAPI integration user. 

Grant the SFAPI Retrieve Assessment Order permission to the SFAPI integration user. 

Grant the SFAPI Update Assessment Report permission to the SFAPI integration user. 

Enable the following permissions to the SFAPI integration user: 

  • Recruiting Permissions > OData API Application Export 
  • Recruiting Permissions > OData API Application Create 
  • Recruiting Permissions > OData API Application Update 

Grant API User Login permissions for the SFAPI integration user. 

Set the API logon exceptions. Go to Admin Tools > Password & Login Policy Settings > Set API Login Exceptions > Add. Then set the following: 

  • Username: Select the SFAPI integration user. 
  • Maximum password age (days): Set this option to -1 for the password to never expire. 
  • IP Address Restrictions: Designated IP addresses or address range for use with integration.  
  • US Data Center: 52.5.142.59, 34.226.132.221, 52.54.43.157 
  • APAC Data Center: 54.253.214.156, 13.236.115.248, 13.238.90.15  

Event Notification Subscription (Admin Center) 

Create a notification subscription so that Criteria will be notified when there is a candidate ready to be invited. 

Go to Admin Center > Event Notification Subscription and click Add New to create a new subscription. 

Go to the Subscriber tab, click Edit Subscribers then Add Subscriber. Click into the first blank row to edit it. Complete the following fields, leave the other fields blank. 

  • Category: leave as Customized 
  • Subscriber Id: enter the Vendor name - CRITERIA 
  • Name: enter the Vendor name - CRITERIA 
  • Client Id: enter the Vendor clientId - CRITERIA 

Click Save  

Go to the External Event tab and click Add New. Enter the details provided by Criteria which tell SuccessFactors how to notify Criteria that a candidate is ready to be invited. 

Complete the following fields, leave the other fields blank: 

  • Event Type: rcm_assessment_alert_v2 
  • Subscriber: choose the Criteria subscriber that was just created - CRITERIA 
  • Protocol: SOAP_OVER_HTTP_HTTPS 
  • Endpoint URL: Use the URL provided by Criteria 
  • Authentication: BASIC 
  • User: api-token 
  • Password: Use the Password provided by Criteria 

Add Assessment field to Job Requisition (Provisioning) 

To allow the Criteria package to be configured on a Job Requisition, the Job Requisition XML template must be edited to include this field. 

Add and permission the assessment field on the Job Requisition XML. 

Job Requisition assessment field XML sample: 

<field-definition id="assessment" type="derived" required="true" custom="false"> 

<field-label><![CDATA[Assessment association]]></field-label> 

<field-description><![CDATA\[Assessmentasso]]></field-description> 

</field-definition> 

<field-permission type="write"> 

<description><![CDATA[job code permissions]]></description> 

<role-name><![CDATA[R]]></role-name> 

<status><![CDATA[pre-approved]]></status> 

<field refid="assessment"/> 

</field-permission>  

The assessment field on the requisition has a link that allows the user to add multiple assessments to the requisition. However, assessment integrations only support one assessment per requisition. To avoid users selecting more than one assessment per requisition, we recommend adding a text field to the requisition template below the assessment field instructing the user to only add one assessment per requisition. Optional text: "Please Note: The assessment integration only supports one assessment selection per requisition."  

Add the Assessment Integration feature permission and feature permission block to the Job Requisition XML. 

The Assessment Integration feature permission is used to permission the Assessment Portlet in the applicant profile. 

Add this for the status value/s that you are using for Criteria testing. (Default = New Application.) 

Job Requisition Assessment Integration Feature Permission XML Sample: 

<feature-permission type="assessmentIntegration"> 

<description><\!\[CDATA\[Operators with below roles can see Assessment detail report for the applicant when the application is in Phone Screen Status\]\]></description> 

<role-name><\!\[CDATA\[S\]\]></role-name> 

<role-name><\!\[CDATA\[T\]\]></role-name> 

<role-name><\!\[CDATA\[O\]\]></role-name> 

<role-name><\!\[CDATA\[R\]\]></role-name> 

<role-name><\!\[CDATA\[G\]\]></role-name> 

<status><\!\[CDATA\[Phone Screen\]\]></status> 

</feature-permission> 

<feature-permission type="assessmentIntegration"> 

<description><\!\[CDATA\[Operators with below roles can see Assessment detail report for the applicant when the application is in New Application Status \]\]></description> 

<role-name><\!\[CDATA\[S\]\]></role-name> 

<role-name><\!\[CDATA\[T\]\]></role-name> 

<role-name><\!\[CDATA\[O\]\]></role-name> 

<role-name><\!\[CDATA\[R\]\]></role-name> 

<role-name><\!\[CDATA\[G\]\]></role-name> 

<status><\!\[CDATA\[Default\]\]></status> 

</feature-permission>  

Hard Stop Status (Optional) 

If you would like to stop a candidate from proceeding in the SuccessFactors pipeline until the Criteria package is completed, a hard stop may be configured on the Criteria testing status within SuccessFactors. 

A hard stop status field is configured in the job requisition template as a standard field. 

When the recruiter moves the candidate to a status past the hard stop status, the system checks if assessment triggers exist for the candidate and if all of them are completed. If yes on both counts, the new status is allowed. If not, the candidate won't be allowed past the status until all assessments are complete. 

You can configure and assign permissions to the assessment hard stop field in the job requisition template, just like you can for other job requisition fields. This field is configured as a standard picklist field. 

<field-definition id="hardstopStatus" type="picklist" required="false" custom="false"> 

  <field-label><![CDATA[Hardstop Status]]></field-label> 

  <field-description><![CDATA[Hardstop status for assessments]]></field-description> 

    <picklist-id>jobReqStatus</picklist-id> 

  </field-definition>  

Once configured, choose the hard stop status on the Job Requisition. Choose the same status that has been configured with a Criteria package on that requisition. 

Email Template (Optional) 

When the candidate is moved into the Assessment status and the testing with Criteria is triggered, an email is always sent from SuccessFactors. The default email template for this situation is D6. Assessment details needed.  

For Recruiter Initiated testing, Criteria will send the invitation and reminder emails; the email from SuccessFactors should advise the candidate that they have advanced to the next phase and to action the email they receive from Criteria. 

If Criteria testing is being initiated automatically On Application, by default the email will be sent by Criteria, however, the link could be sent in an email by SuccessFactors if you wish. The SuccessFactors email template would need to be edited to have the testing link included in the SuccessFactors email. If you opt for this method, be sure to inform Criteria that the Criteria invitation email should be turned off. 

Edit the existing email template or create a new template with the testing link included dynamically in the body of the email. Ensure the text is shown in yellow in the template to confirm that the dynamic field has been inserted correctly. 

  • Criteria link: [[APPLICATION_ASSESSMENT_PROVIDER_URL]] (mandatory) 
  • Criteria package name: [[APPLICATION_ASSESSMENT_PACKAGE_TITLE]] (optional) 

Screen Layouts 

Update your candidate summary list screen in SuccessFactors to display the Status, Score and Recommendation columns so you can sort/rank your candidates. 

The Score and Recommendation columns headings will be prefixed with the Criteria package "Short Name" value. In this example, the Criteria package used in this requisition is called 'GAME Assessment'.  

Using the Integration 

On Application 

Criteria assessments may be issued directly after application by associating Criteria testing with the New Application status. 

If assessments are a mandatory step in the workflow, the Hard Stop status may be chosen to stop candidates from progressing until they have Criteria results available. 

On the Job Requisition add/edit screen, click Add more assessments and complete the fields: 

  • Status: choose New Application 
  • Vendor: choose CRITERIA  
  • Assessment: choose the appropriate Criteria package 
  • Email Template: choose D6, or the appropriate email template for this situation. 

Important: only configure 1 status to be associated with a Criteria package. Each Job may only be associated with Criteria testing in 1 status, however, that status may be different per Job. 

Save the Requisition configuration.   

After the candidate applies for a Job Requisition with Criteria testing in the New Application stage, the candidate can click the link to view their profile. The Jobs Applied section in the profile will show a warning icon to indicate that there is an outstanding task. When the Jobs Applied section is expanded, the candidate will see the Complete Your Assessments link next to the Job they just applied for.  

Clicking Complete Your Assessments will take the candidate to another page which shows the Criteria assessment package that they need to complete. The candidate will then click the assessment package name to start the testing. In this example, the package name is called 'FIRST_ADVANTAGE TAX PKG'.  

In case the candidate does not go to into their profile, an email is sent from SuccessFactors to let them know that they need to complete the Criteria package. This email may include the link to the Criteria testing, or you may choose for Criteria to send the link directly to the candidate. This workflow will be discussed and configured when you set up the integration. 

The candidate's Assessment Status will be updated to show Initiated to let you know that the invitation has been successful in Criteria and the system is waiting for the candidate to complete the testing. 

If a due date has been configured in Criteria, Criteria will send a reminder email 24 hours prior to the expiry date.  

Recruiter Initiated 

To issue testing later in the recruitment process, Criteria assessments may be issued at any stage in the recruitment pipeline other than New Application. 

If assessments are a mandatory step in the workflow, the Hard Stop status may be chosen to stop candidates from progressing until they have Criteria results available. 

Configure the Job Requisition to trigger a specific Criteria package at the appropriate application status. (Use any status other than "New Application".) 

On the Job Requisition add/edit screen, click Add more assessments and complete the fields: 

  • Status: choose the status you are using for Criteria testing 
  • Vendor: choose CRITERIA  
  • Assessment: choose the appropriate Criteria package 
  • Email Template: choose D6, or the appropriate email template for this situation. 

Important: only configure 1 status to be associated with a Criteria package. Each Job may only be associated with Criteria testing in 1 status, however, that status may be different per Job.  

Save the Requisition configuration.   

To trigger testing, update the candidate status to move them into the status that is configured with the Criteria package. This may be done per-candidate or in bulk.  

If the testing is not triggered automatically on status change, you can try again by using Action > Initiate assessment.  

The candidate will be created in Criteria, and Criteria will send the invitation email to the candidate. The preconfigured SuccessFactors email will also be sent so the candidate knows to look out for the Criteria email.  

Viewing Results - Assessments 

Use the candidate list to see a summary of the status and results for the candidates in the requisition. 

The Assessment Status will change to Completed once the Criteria package has been completed and results have been sent to SuccessFactors. 

If you have displayed the Score and Recommendation columns in this view, they will show a summary of the results achieved. The Score column will show the Talent Signal from Criteria and the Recommendation column will indicate if the candidate met all the Score Ranges, or not.  

Hover over the Score value to see the detailed score info from the assessments in the package, and the report link.  

The same detailed information may be seen from the candidate profile.  

The View detailed results link will open the Criteria report in a new browser tab. This report may be in PDF or HTML format, depending on your Criteria account configuration.  

Viewing Status and Results - Video Interviewing 

When the candidate completes their video interview and when an evaluator completes their evaluation, the Assessment Status will update to Pending in SuccessFactors. 

The Assessment Status will change to Completed once the minimum number of evaluators have completed their review, and results have been sent to SuccessFactors. 

If you have displayed the Score and Recommendation columns in this view, they will show a summary of the results achieved. The Score column will show the Video Interview Score from Criteria and the Recommendation column will show the overall recommendation from each evaluator.  

Hover over the Score value to see the report link.  

The same information may be seen from the candidate profile.   

The View detailed results link will open the Criteria report in a new browser tab. This report may be in PDF or HTML format, depending on your Criteria account configuration.  

Note: If an additional evaluator completes, another score block will be added to the candidate in SuccessFactors with the latest score.  

Ongoing 

Updating Packages 

Note: SuccessFactors does not allow vendor packages to be removed, only renamed.  

  • If a Criteria Job is made inactive, you should rename the package in SuccessFactors so your users know not to use it anymore. E.g. you could add 'zz' or 'DO NOT USE -' to the front of the package name.
  • If a new Job is created in Criteria it should be added as a package in SuccessFactors to allow you to use it via the integration.

Refer to the Add Assessment Vendor section in the Activation section above to download the current CSV of packages, make your changes, and upload the new CSV. 

The Criteria Job code can be copied from the Jobs list in the Criteria Platform: 

How did we do?