Overview

Wheebox Exam Integration allows you to configure and manage the complete exam ecosystem, covering processes like slot booking, admit card generation, online exam access, result retrieval, and more. Meritto provides seamless pre-integrated solutions with multiple exam partners, including Wheebox, AoN Cocubes, and Mercer Mettl, ensuring simplified configurations and improved process management.

This article explains how to enable Wheebox, configure exam workflows, manage exam partner settings, validate candidate results, and troubleshoot potential issues.

Core Functionalities

Understanding the Exam Workflow

The first step in Wheebox integration is to obtain a complete understanding of the exam workflow as expected by you.
To initiate the process:

• Share the Requirement Gathering Sheet (RGS) with you and Wheebox.

• Collect institute-specific information about slot booking, exam attempts, scorecard requirements, and retake options.

• Verify Wheebox-related technical details such as API versions, authentication keys, and exam series codes.

Configuring the Exam Workflow

To configure the exam workflow in Meritto:

1. Navigate to Exam Configuration:

• Go to Settings > Institute Configuration.

• Click on Manage Exam Config.

• Click on the Exam Config button on the top right.

2. Select Form Name and Exam Partner:

• Choose the form name for which the exam has to be configured.

• Under the Exam Partner section, select Wheebox.

3. Whitelist for Testing:

• For testing purposes, you can whitelist specific IPs or emails.

• If enabled, the ecosystem operates only for these selected candidates, and the status will be displayed as Test Mode on Manage Exam Page.

4. Select Wheebox Version:

• Choose from four supported versions: 1.0, 2.0,  and 4.0.

• Use the version mentioned in the filled RGS to configure this.

Slot Booking Configuration

To enable slot booking:

• Check Enable Slot Booking to allow candidates to book slots.

• Define Eligibility Start and End Dates for slot booking.

• Data will be pushed to Wheebox via the Exam Information API.

Key Benefit: Allows candidates to SSO to Wheebox and book their exam slot, selecting date, time, and venue.

Note: Only Static date is applicable for all pre-integrated vendor partners. The other 2 options do not apply.

Enabling Online Exam

To enable online exam attempts:

• Enable Online Exam to allow candidates to take the test without slot booking.

• Define the Button Name to be displayed on the candidate’s dashboard.

Admit Card Generation

To enable admit card generation:

• Enable Modify Appointment API.

• Slot booking details will be pushed via the Modify Appointment API.

• Configure the Admit Card Template that appears in the student’s portal post-slot confirmation.

Note: Also, admit cards can be configured in document templates where you can choose the document sub-type as 'Admit Card' and it will be visible in the drop-down in admit card template dropdown in the exam config.

Scorecard Generation

To enable scorecard generation:

• Enable Result Notification API.

• Wheebox pushes the result using the Result Notification API.

• Configure the Scorecard Template for download by candidates from the portal.

Key Benefit: Allows seamless fetching and display of candidate results.

Rescheduling and Retake Configuration

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. Currently, rescheduling and retake options are:

• Not Active: No requirements have been received from you or Wheebox.

• Once enabled, You can define:

• Reschedule attempts allowed and Button Name.

• Payment options for rescheduling.

• Time duration within which rescheduling can be done.

• Retake conditions, including fees, Button Name  and time gaps between attempts.

Note: Rescheduling and retake options will be configured based on future requirements. As of now, we have not received reschedule or retake configuration requests for Wheebox. Hence, the Re-scheduling and Retake options are optional to configure in this case.

• Show Exam Graph: Here you can define all the Exam dispositions that you would like to see in the Exam Attempts dashlet on the Admin Dashboard.

• Collected by Vendor: Not Applicable

• Blocked Actions Status: Not Applicable

Configuring Exam Partner Settings

Click on ‘Save Config’ to complete the integration. The system will clear static caches and apply the configured settings.

On the Manage Exam Config page, selecting the form name in the Filter option shows the Application-Exam Integration status (Active/Inactive/Test mode) and the exam vendor.

Result Mapping

Result Mapping allows you to map JSON/XML result data to Admin fields in Meritto. Once candidates complete the exam, Wheebox pushes the results to Meritto's Result API.

Steps to Map Results:

1. Preview Result Data:

• Go to Manage Exam > Exam Result Data.

• Click on Preview to view result data in JSON/XML format.

2. Validate and Map JSON:

• Copy and paste the JSON/XML into the Template Format dialog box.

• Click on Validate JSON to verify its correctness.

• Define sectional and subsection headings for marks obtained.

3. Map Fields to Admin Data:

• Select Admin fields to map the result data.

• Click on Add More to map multiple fields.

• Create new Admin fields if required.

Save Config to apply result mapping settings.

Note: Result mapping should only be done, after saving the main exam config. Once the student is able to SSO and the result has been fetched on the Meritto Result API, only after that should you map the Result JSON.

Implementation Tracker and Sanity Sheet

Once the configurations are complete, the candidate flow needs to be tested, and a sign-off should be obtained using:

• Implementation Tracker: Tracks configuration progress and approvals.

• Sanity Sheet: Maintains weekly data to monitor any discrepancies.

Note: Refer to the Exam Ecosystem Debugging Kit to troubleshoot errors during SSO or API communication. Contact the product team if issues persist.

Conclusion

Wheebox Exam Integration in Meritto enables you to efficiently manage exam workflows, including slot booking, admit card generation, result mapping, and API communication. By leveraging Meritto’s pre-integrated solutions, you can provide candidates with a seamless examination experience while maintaining high standards of data accuracy and process control.