Overview

The Exam ecosystem encompasses various processes defined by Institutes, including (but not limited to) Slot Booking, Admit Card Generation, Rescheduling, Score Card generation, Retake Attempts, and more. Enabling this ecosystem involves configuring the Exam Workflow and Partner Configurations.

With pre-integrated Exam Partners like Wheebox, Cocubes and Mercer Mettl, we continually strive to simplify and streamline these configurations. This article will provide a comprehensive guide to enabling Codetantra Online Exam Partner within the Exam ecosystem with a Plug and Play Configuration.

Understanding the Exam Workflow

The first step in integrating Codetantra Online is gaining a complete understanding of the Exam workflow as expected by the Institute. This involves:

1. Requirement Gathering:

   • Obtain necessary approvals from the Institute.

   • Share the Requirement Gathering Sheet with the Institute. This document contains:

     • Questions for the Institute to understand their Exam Workflow.

     • Technical questions for Codetantra Online to address integration details.

2. With the collected information, proceed to configure the Exam Workflow.

Step 1: Configure the Exam Workflow

Navigation

1. Go to Settings.

2. Select Institute Configuration.

3. Click Manage Exam Config.

4. On the Manage Exam page, click the Exam Config button in the top-right corner.

Initial Configuration

1. Select the Form Name for which the exam has to be configured.

2. Under the Exam Partner dropdown, search and select Codetantra Online.

Enable Slot Booking

• This option allows eligible candidates to book exam slots via Single Sign-On (SSO) to Codetantra Online portal, where they can select their venue, date, and time slot.

• Input required:

  • Eligibility Start Date and End Date: Defines the exam’s booking window.

• Note: Only Static and Dynamic dates are applicable for Codetantra Online.
  

Enable Online Exam 

• Checking this will enable the take test button once the user has booked the slot.

• Configuration options:

  • Button Name: Customize the button text displayed on the Candidate Dashboard.

Cooling Period

• Define the time gap between multiple exam attempts, if applicable.
  

Enable Mock Test same as tooltip on exam config.

• Enabling the Enable Mock Test button lets you configure its label and display a Take Mock Test button on the student dashboard.

• This button will be visible from the slot booking date to the exam date.

• The button enables SSO to the vendor platform, while all other processes are vendor-managed
  

Enable Take Test

• Enabling the Enable Take Test button lets you configure its label and display a Take Test button on the student dashboard.
• This button will be visible on the exam date.
• The button enables SSO to the vendor platform, while all other processes are vendor-managed
• You can also select the Disposition on which this button should be enabled on the student dashboard. This is a mandatory field.
  

Enable Admit Card

• Activates the Modify Appointment API, enabling Codetantra Online to push candidate slot booking details once the candidate has booked the slot.

• Configurations:

  • Choose an admit card template to display on the Candidate Dashboard after scheduling.

  • Admit cards can also be configured on document templates under the sub-type "Admit Card."
    

Enable Scorecard

• Activates the Result Notifications API to receive candidate results from the vendor once the candidate has given the exam and result is available.

• Configurations:

  • • Choose an admit card template to display on the Candidate Dashboard after scheduling.

    • Scorecard can also be configured in document templates under the sub-type "Scorecard."
      

Enable Exam Rescheduling

• This module allows the Candidates who have scheduled their Exam, to change their Exam Venue or Date or Time any time within the allowed window for Rescheduling. Based on the Institute's requirements, you could define the number of times a candidate can reschedule his exam attempt, the Button name to be shown to the Candidates, the Time duration before which a candidate is allowed to pay for reschedule and/or Reschedule Exam, define the payment details, etc.

• You can configure the following Configurations:

  • Number of Re-schedules

  • Reschedule Button Name

  • Reschedule Cooling Period

  • Enable Payment?

  • Exam button to be visible after exam date

  • Re-schedules Payment Button Prior (In Hours)

  • Vendor Message

  • Reschedule Mode

Enable Multiple Attempts/Retakes

• This allows Candidates to take more than one Exam Attempt. Basis Institutes requirement, we can define the conditions when a Candidate is allowed for a Retake, Payment to be taken for Retake (if any), Name of a button, the Time gap between any two attempts, etc.

• Configure conditions for retakes:

•  Enable Retake when Exam disposition is
• Retake Cooling Period
• Enable Retake Payment
• Number of Re-takes
• Re-take Button Name
• Re-take Gap in days
• Vendor Message
• Retake Mode
• Enable retake mock Exam
• Enable retake test
• Enable Retake Take Exam when Exam disposition is
• Enable Retake Admit Card Template
• Enable Retake Attempt

Display Exam Graph

• Specify Exam Dispositions to be displayed in the Exam Attempts dashlet on the Admin Dashboard.

Exam Status

• Toggle the Exam Ecosystem as Active or Inactive.

• Whitelisting options:

  • Restrict functionality to specific IPs or emails for testing purposes.

  • Whitelisted configurations will show as Test Mode.
    

Step 2: Configure APIs

Slot Booking API

• Meritto uses this API to register the candidates with the vendor using there Demographic and Exam related data .

• For Codetantra, this API is triggered every time the candidate SSO’s (Single-Sign-On) to the vendor platform.

• This API configuration will only be seen when the Enable slot booking option is active in Step 1.  

• To enable the Slot Booking button on the student dashboard we have the following triggers:

  • Payment Approved: Verifies the candidate's payment status.

  • Application Submitted: Confirms the candidate's application submission.

  • Application Stage Selection: This further asks to define the stage of the application process.

  • Payment Approved on Token Fee: This further asks to define the token fee.

  • Partwise Submission: This further asks to define the part of the application.

Form Mapping 

• Below this configuration there is an input text field for the Form Mapping where the JSON for mapping the form fields to the vendors registration API can be mapped. Below are the validations work on this input box:
  • College ID should be same.
  • Form ID should be of the form selected.
  • The Meritto field should be in the selected form.
  • Vendor should be Codetantra Online.
• Important Notes:- 
  • Once the Mapping is entered, the Preview option can be used to view the JSON in a summarized manner and check if the correct vendor key is mapped with the correct form field.
  • The Save Button can ne used to save the JSON Mapping. 
  • If this save button is not clicked, the mapping will not be saved on the master configuration save. 
    

Exam Authorization Data : This can be added in the form mapping directly after changing the College ID and Form ID

{

"custom_value": "",

"required": true,

"sort_order": 3,

"type": "exam_ead",

"value_from": "custom",

"vendor_field": "clientCandidateID",

"college_id": 715,

"form_id": 16997,

"vendor": "codetantra-online"

},

{

"form_id": 16997,

"custom_value": "",

"required": true,

"sort_order": 6,

"type": "exam_ead",

"value_from": "vendor_config",

"vendor": "codetantra-online",

"vendor_field": "cId"

},

{

"custom_value": "",

"required": true,

"sort_order": 2,

"type": "exam_ead",

"value_from": "custom",

"vendor_field": "clientAuthorizationID",

"college_id": 715,

"form_id": 16997,

"vendor": "codetantra-online"

},

{

"form_id": 16997,

"custom_value": "",

"required": true,

"sort_order": 8,

"type": "exam_ead",

"value_from": "vendor_config",

"vendor": "codetantra-online",

"npf_field": "eligibilityApptDateFirst",

"vendor_field": "eligibilityApptDateFirst"

},

{

"form_id": 16997,

"custom_value": "",

"required": true,

"sort_order": 6,

"type": "exam_ead",

"value_from": "vendor_config",

"vendor": "codetantra-online",

"npf_field": "examSeriesCode",

"vendor_field": "examSeriesCode"

},

{

"form_id": 16997,

"custom_value": "",

"required": true,

"sort_order": 7,

"type": "exam_ead",

"value_from": "vendor_config",

"vendor": "codetantra-online",

"npf_field": "eligibilityApptDateLast",

"vendor_field": "eligibilityApptDateLast"

}

Client Candidate Data:

{ "npf_field": "mobile_no",

"required": true,

"sort_order": 9,

"type": "exam_cdd",

"value_from": "form_details",

"vendor_field": "contactNo",

"college_id": 715,

"form_id": 16997,

"vendor": "codetantra-online" }

Admit Card API

• The vendor uses this API to send the candidates Slot Booking data to Meritto.

• This data is received as and when the candidates book the slot.
• This API configuration will only be seen when the Receive the Appointment/Slot Details/Enable Admit Card option is checked in Step 1.  

Disposition Mapping 

• Below this configuration there is an input text field for the Disposition Mapping where the JSON for mapping the form fields to the vendors registration API can be mapped. In this case different mappings need to be done for Main Exam and Retake's (Will dependent on the no. of retakes entered on step 1) Below are the validations work on this input box:
  • College ID should be same.
  • Form ID should be of the form selected.
  • The Meritto field should be in the selected form.
  • Vendor should be Codetantra Online.
• Important Notes:- 
  • Once the Mapping is entered, the Preview option can be used to view the JSON in a summarized manner and check if the correct vendor key is mapped with the correct form field.
  • The Save Button can ne used to save the JSON Mapping. 
  • If this save button is not clicked, the mapping will not be saved on the master configuration save. 
    

Sample Json :-  Format - (“Vendors Key” :”Meritto Field ”)

{       "college_id": 715,

        "form_id": 16997,

        "type": "exam_disposition",

        "exam_city": "exam_details_8",

        "event_time_timestamp": "exam_details_9",

        "event_type": "exam_details_10",

        "exam_slot_booked_timestamp": "exam_details_5",

        "exam_center_address": "exam_details_6",

        "exam_state": "exam_details_7",

        "exam_slot_booked_date": "exam_scorecard_date",

        "examMode": "exam_details_23",

        "serial_number": 0} (This Serial Number is for exam attempt, if main attempt then configure 0 , if 2nd attempt then 2 and accordingly increment the number) 

Preview :- 

Exam Result API

• The vendor uses this API to send the candidates Examination score data to Meritto.
  

• This data is received as and when the candidates result is generated and sent to meritto via API.
  

• This API configuration will only be seen when the Receive the Candidates Result/Enable Scorecard option is checked in Step 1.  

Score Mapping 

• Below this configuration there is an input text field for the Score Mapping where the JSON for mapping the form fields to the vendors registration API can be mapped. In this case different mappings need to be done for Main Exam and Retake's (Will dependent on the no. of retakes entered on step 1) Below are the validations work on this input box:
  • College ID should be same.
  • Form ID should be of the form selected.
  • The Meritto field should be in the selected form.
  • Vendor should be Codetantra Online.
• Important Notes:- 
  • Once the Mapping is entered, the Preview option can be used to view the JSON in a summarized manner and check if the correct vendor key is mapped with the correct form field.
  • The Save Button can ne used to save the JSON Mapping. 
  • If this save button is not clicked, the mapping will not be saved on the master configuration save. 

Vendor Credentials

• All the accurate configuration keys of Codetantra online should be mapped in this section to enable seamless integration.

• The following data needs to be mapped in this section:- 
  • Generate Token API
  • API Client Id
  • Secret Key
  • CID
  • Generate Client Candidate ID From - Dropdown with selection of Application no. and Applicant payment ID
  • Exam Series Code Type - Static/Dynamic/Logic Based

Re-take Exam Series Code

This feature is hardcoded for Lovely Professional University (ID: 524) Only.