CBT Sync to Student Grades

How CBT exam scores automatically sync to the Student Grades system.

When a student submits a CBT exam, their score is automatically synced to the Student Grades system (Enter Results). No manual data entry is needed — the score appears in the correct column immediately.

How It Works

1. Student submits a CBT exam
2. The system reads the current Term and Session from Academic Settings
3. The raw score is scaled to match the assessment column's maximum (e.g., 60% for Exam)
4. The scaled score is written to the student's grade record under the correct subject and term

Scaling Formula

Scaled Score = round(correct answers / total questions × column max)

Example: A student scores 18/25 on a Geography exam. The Exam column max is 60.

round(18 / 25 × 60) = round(43.2) = 43

The student gets 43 in the Exam column for Geography.

Requirements

For sync to work, the following must be configured:

Setting	Where	Example
Current Term	Academic Settings	Term 3
Current Session	Academic Settings	2026/2027
Assessment Type	CBT Exam settings	exam, ca1, ca2, etc.
Subject	CBT Exam settings	Geography
Grading Config	Academic Settings	CA max scores, Exam max

If any of these are missing, the sync will not fire.

Assessment Types

The Assessment Type on the CBT exam determines which column the score goes into:

Assessment Type	Column in Enter Results
exam	Exam
ca1	CA1
ca2	CA2
ca3	CA3

This is set when creating the CBT exam under "Assessment Type".

Three Sync Methods

1. Auto-Sync (Automatic)

Fires immediately when a student submits their exam. No action needed from the teacher or admin.

2. Resync Button (Manual)

Found in CBT → Results after selecting a test. Click "Sync to Grades" to re-sync all scores for that test. Useful if:

• Academic Settings were changed after students submitted
• You need to overwrite previously synced scores
• Auto-sync failed due to a temporary issue

You can also select specific students to sync rather than all.

3. Combined Exam Sync (Automatic)

For combined exams (multiple subjects in one session), each subject syncs independently. A student taking Math + English + Science in one combined exam gets three separate grade entries — one per subject.

Viewing Synced Scores

Go to Student Grades:

1. Select the class (e.g., JSS1)
2. Select the arm
3. Select the subject (e.g., Geography)

Synced scores appear in the appropriate column (CA1, CA2, or Exam) with no visual difference from manually entered scores. They are part of the student's official record.

Important Notes

• The subject name on the CBT exam must match the subject name in Academic Settings exactly (case-sensitive)
• Syncing overwrites the specific column only — it won't erase other columns (e.g., syncing Exam won't touch CA1)
• If a student retakes an exam, the new score overwrites the old one
• The term format in the grade record is always "Term X, YYYY/YYYY" (e.g., "Term 3, 2026/2027")

Troubleshooting

Problem	Cause	Fix
Score not appearing in Enter Results	Term or Session not set in Academic Settings	Go to Academic Settings and set both
Score in wrong column	Wrong Assessment Type on the CBT exam	Edit the exam and change Assessment Type
Score seems too high/low	Grading config changed after sync	Click Resync to recalculate with current config
Subject not matching	Subject name mismatch (e.g., "Maths" vs "Mathematics")	Ensure CBT exam subject matches Academic Settings exactly