This guide describes how to configure the Workday integration for HackerRank Interviews.

Prerequisites

Before you begin, ensure you meet the following requirements:

• The Workday Recruiting Module must be enabled and in scope.

• The Interview (Default Definition) business process must exist in the tenant.

  • Search for bp: Interview to verify it exists.

  • If it does not exist, set up and configure the Interview (Default Definition) business process using the Create Business Process Definition (Default Definition) task. For more information, see Workday Community guide.

3. Download and install Workday Studio on your computer. For more information, see Installation Guide.

Configure Workday Studio

Configuring Workday Studio involves three steps:

Step 1: Import CLAR file into Workday Studio

1. On the Studio menu bar, select File > Import.

   1. Select the CLAR file import wizard in the Workday folder. You can find the CLAR file at this link.

   2. Click Browse and select a CLAR file to import.

   3. Click Next to display the collections and projects in the CLAR file.

   4. Select collections and projects to import from the CLAR file.

   5. Edit all project name conflicts if applicable.

      • Select a project with a name conflict.

      • Click Edit.

      • In the Project Name field, rename the project.

   6. Edit all collection name conflicts if applicable.

      • Select a collection with a name conflict.

      • Click Edit.

      • In the Collection Name field, rename the collection.

   7. Click Finish.

Step 2: Add a connection in Workday

1. Select Window > Preferences > Workday > Connections.

   Note: If this option is not accessible, go to Window > Show View > Cloud Explorer. Click the icon in the upper-left corner of the Cloud Explorer panel to open Connection Details.  

2. Click Add.

   1. On the Add Connection window, enter values for the following fields:

      Field	Description
      Name	The name of the connection.
      URL	The URL of the connection.
      (Optional) Group	Adds the connection to a group.

3. In the Credentials section, specify the tenant and select an authentication method:

   • Basic Auth: Enter the Username and Password for the connection.

   • OAuth 2.0: Enter the Grant Type, Client ID, Authorization Endpoint, Token Endpoint, and Access Token.

     Note: To use OAuth 2.0 authorization, you must first register an API client. For more information, see Workday Community guide.

5. Click Test Connection. Workday Studio confirms whether it can access the connection.

   Note: The user must have certain permissions to deploy. Refer to the security group list in Workday Studio to confirm the user belongs to at least one security group for each section required to deploy the CLAR file to the tenant. For more information, see Workday article for user-based security groups.

   

Step 3: Deploy CLAR file to Workday tenant using Workday Studio

1. In Workday Studio, right-click the project and select Deploy to Workday.

2. Select the Workday environment you wish to deploy the CLAR file. Make sure the option Include source code in deployed CLAR is selected.

3. Click Next.

4. Confirm your project appears under the Configured section.

5. Click Finish.

Configure Workday Tenant

Create and configure an Integration System User (ISU) account

1. Create Integration System Users.

   1. Access the Create Integration System User task and configure a Workday account for the integration.

      

      • Name the account HackerRank_Interview_Integration_User_Step1.

      • Specify a password and save the credentials for future use.

      • Keep Session Timeout Minutes at the default value of zero to prevent session expiration. An expired session can cause the integration to stop before it completes.

      • Select Do Not Allow UI Sessions. This prevents the integration system user from signing in to Workday through the UI.

   2. Repeat the steps above to create an additional ISU named HackerRank_Interview_Integration_User_Step2.

2. Create an Integration System Security Group.

   1. Access the Create Security Group task and configure an Integration System Security Group for the integration.

      

      • Select Integration System Security Group (Unconstrained) as the Type of Tenanted Security Group.

      • Name the group ISSG_HackerRank_Interview_Integration.

   2. In the Integration System User field, select the ISUs created in step 1 above (Create Integration System Users).

   3. Click OK.

3. Edit the domain security policies.

   1. Grant the security group access to the following domains.

      • Interview Integrations

      • Candidate Data: Interview Schedule

      • Candidate Date: Interview Feedback Results

      • Worker Data: Public Worker Reports

      • Person Data: Work Contact Information

   2. Repeat the steps below for each domain.

      1. Access the View Domain report from the search bar and locate the domain.

      2. As a related action on the domain, select Domain > Edit Security Policy Permissions.

         

   3. Add the security group you created to the Report or Task Permissions and Integration Permissions. Select Get, Put, View, and/or Modify as required.

      • Activate Pending Security Policy Changes.

      • Access the Activate Pending Security Policy Changes task.

      • Describe your changes in the Comment field.

      • Select the Confirm checkbox to activate your changes.

4. Access the Maintain Password Rules task.

   Add the integration system users to the System Users exempt from the password expiration field.

   Note: Workday recommends preventing Workday passwords from expiring to avoid integration errors caused by expired passwords.

5. Assign ISU to the integration system.

   1. Search for intsys: Hackerrank_Interview_Integration_Step2 and open the integration system.

   2. From the integration's related actions, go to Workday Account > Edit.

   3. Select your ISU named HackerRank_Interview_Integration_User_Step2.

   4. Repeat these steps for adding the other ISU for Hackerrank_Interview_Integration_Step1 Integration System.

      

6. Manage authentication policies for API access

   1. Go to Manage Authentication Policies.

   2. Edit the authentication policy for your current environment.

   3. Click the Plus icon in the upper-left corner to create a new authentication ruleset.

   4. Enter a Rule Name.

   5. Select your Integration System Security Group created above under Security Group.

   6. Enter a value for Authentication condition name.

   7. Under Allowed Authentication Types, select User Name Password.

   8. Click OK.

   9. Go to Activate All Pending Authentication Policy Changes to activate your changes.

      Note: If authentication policies are not configured correctly, HackerRank may be unable to make web service calls to Workday. If there are issues with authentication, use the Signons and Attempted Signons report to troubleshoot the failed sign-on attempt.

Configure the HackerRank Settings page

1. Enter the username of one of the integration system users you created.

2. Enter the corresponding integration system user password.

3. Specify the Recruiting Public Web Services Endpoint:
   Search for the ‘Public Web Services’ report in your Workday tenant. Navigate to the Recruiting (Public) Web Service. Click on the Related Actions next to it and navigate to  Web Service -> View WSDL. Search for ‘soapbind:address’ in the WSDL.

4. Enter the Interview Rating IDs from Workday that map to Pass and Fail in HackerRank.

   • Use the Maintain Interview Feedback Ratings task to configure ratings initially. After initial setup, this task can only update feedback descriptions.

   • Use the Maintain Reference IDs task to update or view reference IDs for the Interview Feedback Rating business object.

5. Click Save.

   Saving the configuration generates the Access Token and Company ID in the HackerRank Workday integration page required for the next steps.

   Note: If you move tenants, provide updated credentials to the HackerRank team.

Add HackerRank-specific fields to the Integration

1. Search for the integration in the tenant by searching intsys: HackerRank_Interview_Integration_Step2 in the Workday search bar.

2. Go to Related Actions > Integration System > Configure Integration Attributes.

   1. Copy the Access Token available in the HackerRank Workday integration page to the Access Token integration attribute.

   2. Copy the Company ID available in the HackerRank Workday integration page to the Company ID integration attribute.

      

3. Access the Register External OAuth Client task:

   • Go to the Register External OAuth Client task.

   • Find and select the integration system named Hackerrank_Interview_Integration_Step1.

   • Enter the following values available in the HackerRank Workday integration:

     • OAuth 2.0 Client Name

     • OAuth 2.0 Client ID

     • OAuth 2.0 Client Secret

     • Scope

     • Authorize Endpoint URL

     • Token Endpoint URL

   • Click OK.

     

Edit tenant setup - recruiting task

1. Go to the Edit Tenant Setup - Recruiting task.

2. From the Web Conference Integration System prompt, select Hackerrank_Interview_Integration_Step1 and click Save.

   

Build calculated fields

Use the Create Calculated Field task to build the following fields:

1. Field Name: CFI LRV Candidate from Interview

   

   • Function: Lookup Related Value

   • Business Object: Interview

   • Lookup Field: Job Application

   • Return Value: Candidate – Field Type: Self-referencing instance (Viewable from the Related Actions off of the field)

2. Field Name: CFI LRV Candidate Email for Candidate from Interview

   

   • Function: Lookup Related Value

   • Business Object: Interview

   • Lookup Field: CFI LRV Candidate from Interview

   • Return Value: Email

3. Field Name: CFI LRV Recruiter for Interview

   

   • Function: Lookup Related Value

   • Business Object: Interview

   • Lookup Field: Job Application

   • Return Value: Recruiter

4. Field Name: CFI LRV Recruiter Email for Interview

   

   • Function: Lookup Related Value

   • Business Object: Interview

   • Lookup Field: CFI LRV Recruiter for Interview

   • Return Value: Email - Primary Work

Business process configuration

1. Search for bp:interview and open Interview (Default Definition).

2. Edit the business process definition using the Related Actions and go to Business Process > Edit Definition and click OK.

3. Set up Schedule Interview step:

   1. Click the Plus icon to add a new step.

   2. Type a letter for Order that places the Schedule Interview step after the Initiation step.

   3. Select Action in the Type column.

   4. Select Schedule Interview in the Specify column.

   5. Choose a security group for the Group column that should handle the Schedule Interview step.

   6. (Optional) Populate the Due Date column.

4. Set up Integration step:

   1. Click the Plus icon to add a new step.

   2. Type a letter for Order that places the Integration step after the Schedule Interview action step. For example, if the Schedule Interview step is Order b, make the Integration step Order c.

   3. Select Integration in the Type column and click OK.

   4. Hover over the magnifying glass for the Integration step and click Related Actions. Go to Business Process > Maintain Redirect and click OK. Select the Move to Next Step and Rerun Integration checkboxes, and select the allowed security groups for the redirect.

      Note: If there are no security groups in the drop-down, click Related Actions off the Business Process Definition and navigate to Business Process Policy - Edit. Add the desired security groups in the Redirect Action box.

   5. Click Configure for the step you created.

   6. Select Hackerrank_Interview_Integration_Step2 and click OK.

   7. Configure the Integration Criteria as follows:

      

5. Set up Manage Interview Feedback step:

   1. Click the Plus icon to add a new step.

   2. Type a letter for Order that places the Manage Interview Feedback step after the Integration step.

   3. Choose Shared Participation from the Type column drop-down.

   4. Choose Manage Interview Feedback from the Specify column.

   5. Choose the appropriate security group(s) under the Group column.

6. Set up Make Interview Decision Step:

   1. Click the Plus icon to add a new step.

   2. Type a letter for Order that places the Make Interview Decision step after the Manage Interview Feedback step.

   3. Choose Action from the Type column drop-down.

   4. Choose Make Interview Decision from the Specify column.

   5. Choose the appropriate security group(s) under the Group column.

   6. (Optional) Populate the Due Date column.

   7. Click OK to save.

   8. Hover over the magnifying glass for the Make Interview Decision step and click Related Actions. Go to Business Process > Set and set this step as Completion.

   9. Click OK.