Articles in this section

How to Set Up the Oracle HCM Integration with CodeSignal

Avatar
Team CodeSignal
Updated

Table of Contents

Overview

The Oracle HCM + CodeSignal integration enables recruiters to send CodeSignal assessment invitations to candidates directly from Oracle and automatically receive results within the ATS. 

Prerequisites

Before you begin, make sure you have:

  • Oracle HCM access with the necessary permissions
     
  • CodeSignal Enterprise account with integration permissions
     
  • A point of contact with your CodeSignal Customer Success Manager
     

Step 1: Import CodeSignal configuration into Oracle

  1. You should have received a zip file containing CodeSignal’s Oracle configuration from your CSM. You will need to import this into Oracle.
  2. In the settings menu, select Setup and Maintenance

  1.  Open the task list and select Manage Configuration Packages

 

  1.  Select Upload, then upload the zip file.
  2.  Click Get Details
  3.  Click Submit
  4.  Back on the Manage Configuration Projects page, click Import Setup Data

  1. Go through the prompts and submit. It will take a few minutes for Oracle to import the configuration. Once the status has changed to Completed successfully, you can continue with the next step.

Step 2: Enable the Integration in Oracle HCM

  1. You should have received a Client Secret, a Client ID, and a Reference Key from CodeSignal. Make sure to store these values securely and keep them private.
  2. Log in to Oracle HCM.
  3. In the settings menu, select Setup and Maintenance, then Recruiting and Candidate Experience Management, then Recruiting Category Provisioning and Configuration

  1. Search for CodeSignal in the partner integrations list and select it.
  2. Input the Client Secret, Client ID, and Reference Key into the form.
  3. Activate the integration.

Flexfields
 

Flexfields can be enabled in order to view additional information about an assessment result. We support the following flexfields, which are all character strings:

Name Code Description
Verification Status VerificationStatus If the assessment was proctored, the verification status will be here
Labels Labels The labels on the assessment
Integrity review suggested Integrityreviewsuggested Whether an integrity review is suggested for the assessment
Behavioral result label Behavioralresultlabel If the assessment was a behavioral assessment, their behavioral result will be here
Rejection reasons Rejectionreasons If the assessment verification was rejected, reasons will be listed here
Time spent Timespent Amount of time the candidate took to complete the assessment
Solved questions Solvedquestions Number of questions the candidate solved

You must notify your  CodeSignal CSM that you intend to use flex fields so we can enable the feature for you within our system.

For examples of assessment results with flexfields, see the screenshots below.

Step 3: Load CodeSignal assessments into Oracle

  1. On the same page, select Assign User Account
  2. Enter the user name (it can be any name and does not need to correspond to a username in CodeSignal) and optionally, a description.
  3. Click save.
  4. Check that all your CodeSignal assessments are loaded into Oracle.
  5. When an assessment in CodeSignal is created, updated, or deleted, the changes will be automatically synced to Oracle.

Step 4: Assign CodeSignal to Job Requisitions

  1. Open a Job Requisition.
     
  2. Scroll to the Assessments section.
     
  3. Select CodeSignal as the provider.
     
  4. Choose the user you created above and the appropriate CodeSignal assessment. Note: Although you can select multiple assessments within Oracle, our system only allows selecting a single assessment.
     

Step 5: Invite candidates to take the assessment

  1. In Oracle HCM, open the candidate list for a requisition.
     
  2. Select a candidate.
     
  3. There are multiple ways to trigger an assessment for the candidate. You can choose to manually trigger assessment by navigating to the Screening tab, then clicking the … icon in the Assessments section, and clicking Initiate Request
     

Click the checkbox next to the assessment, then click Save.

If you have automation enabled through the Candidate Selection Process, you can also move the candidate to the appropriate application stage to automatically trigger an assessment. The application stage to move the candidate to depends on your configuration.

Once the assessment invitation has been sent, the status will display as Initiated. At this point, an assessment will be created within CodeSignal and the candidate will be invited to take it.

Step 6: View Results in Oracle

  1. Once candidates complete the assessment, results are automatically synced to Oracle and viewable within the candidate profile.
     
  2. Open the candidate’s profile to see:
     
    • Overall Score
       
    • Detailed Report Link
  3. When an assessment result is updated in CodeSignal (for example, if a label is updated, or if an assessment is certified or flagged etc), the result will also be updated within Oracle.

If an assessment was proctored and flagged due to violations of the assessment rules, here is what you will see:

If the candidate did not start the assessment before the due date, here is how the assessment expiration will appear:

If an assessment was completed, here is what you will see:

Flexfields

Flexfields can be enabled in order to provide additional information about an assessment result.