Examinations & Results
The examination module is one of Edum's most comprehensive workflows. Schools can configure grading systems, set up exams, enter marks, generate and publish results, create reports and transcripts, and promote students.
Who can use the examination module?
Most examination screens require the school-owner role. Teachers enter marks through their assigned areas. Students and guardians can only view published results.
Examination & Results Workflow
A typical examination process in Edum follows these steps:
Important: Results cannot be generated until marks are entered. Student, school, and class information must also be configured in advance.
Prerequisites
Before configuring an examination, make sure the following information is ready:
- Academic year
- Academic classes and sections
- Enrolled students
- Examination module enabled in School Settings
Grading Systems & Grade Rules
A grading system determines how percentage ranges are converted into grades and grade points.
Menu: Examination → Grading System
/examination/grade-systemsCreate a Grade System
Open Grading System and click Create.
For example, "Standard 5-point".
Store the grade system.
Add Grade Rules
- Open the grade system's Rules option.
- Click Create.
- Enter the percentage range, grade and grade point.
- Store the rule.
- Repeat until all percentage ranges are covered.
Sanity check: Grade rules should be contiguous. Avoid gaps between percentage ranges so every student's percentage maps to exactly one grade.
Exam Setup
Exam Setup is used to create the examinations that students will be graded against.
Menu: Examination → Exam Setup
/examination/exam-setupCreate an Examination
Click Create.
Enter the exam name and select the school and academic year.
Save the examination. It can later be edited, updated, trashed or restored.
Subjects
Subjects are the units against which marks are recorded. Main and optional subjects are supported.
Menu: Examination → Subjects
/examination/subjectsCreate a Subject
- Open Subjects.
- Click Create.
- Enter the subject name and code.
- Select the relevant class and academic year.
- Store the subject.
Assign Students to Subjects
Not every student necessarily takes every subject. Use Assign Students to select the students who take a particular subject.
/examination/subjects/assign-studentsSelect School
Choose the school for the subject assignment.
Select Class
Choose the academic year and class.
Select Students
Select the students taking the subject.
Mark Distribution
Mark distributions define how a subject's total marks are divided into components.
English: Written = 70, Oral = 20, Project = 10, Total = 100
Menu: Examination → Mark Distribution
/examination/mark-distributionsCreate a Mark Distribution
- Open Mark Distribution.
- Click Create.
- Select school, academic year, class, subject and exam.
- Add each component and its maximum marks.
- Store the distribution.
Each subject + class + exam combination should have exactly one mark distribution before marks are entered.
Entering Marks
Teachers normally enter marks through their own screens. School owners can also manage marks centrally.
Menu: Examination → Marks
/examination/marksManual Mark Entry
Select school, year, class, exam and subject.
Edum filters the student list according to the selected academic information.
Enter marks for each component and student.
Save the marks. Existing records can be updated, trashed or restored.
Bulk Marks Import
For large classes, marks can be imported using CSV or JSON files.
/examination/marks/bulk-import- Open Marks → Bulk Import.
- Select school, year, class, subject and exam.
- Download the real-data template or blank sample.
- Fill in the marks.
- Upload the file.
- Preview the imported data.
- Click Import.
CSV
Download and upload marks using spreadsheet-friendly CSV files.
JSON
Use JSON templates for structured bulk marks import.
Locking Marks
Once marks have been verified, lock them to prevent accidental or unauthorized changes.
| Action | Route | Purpose |
|---|---|---|
| Lock | /examination/marks/lock | Freeze marks |
| Unlock | /examination/marks/unlock | Reopen marks for correction |
| Locked Marks | /examination/marks/locked-marks | Review locked marks |
Recommended workflow: Verify marks → Lock marks → Generate results.
Generate Results
Result generation calculates the percentage, grade and grade point for each student's subject result.
Menu: Examination → Results → Generate
/examination/results/generateSelect school, year, class, section, exam and subject where applicable.
Click Generate to calculate and store the result records.
Check how many results were created.
If marks are corrected later, recalculate the affected results.
Important: Results should be regenerated or recalculated after any mark change.
Publish Results
Publishing makes generated results visible to students, parents and public result links.
Menu: Examination → Result Publish
/examination/result-publishPublish
Make results visible to authorized users and public result links.
Unpublish
Temporarily hide results when corrections are required.
Check Status
Verify whether a selected result set is currently published.
Results will not be visible to students or guardians portals until they are published.
Aggregate Results & Remarks
Aggregate Results
Aggregation combines results across multiple exams, such as Term 1, Term 2 and Final examinations, into an overall result.
Menu: Examination → Aggregate
/examination/aggregate- Open Aggregate.
- Select the required filters.
- Click Generate.
- Review the aggregated totals and GPA.
Remarks
Remarks can be added to exam results or aggregated results.
| Type | Route | Purpose |
|---|---|---|
| Aggregate Remarks | /examination/remarks/aggregate | Add remarks to aggregated results |
| Exam Remarks | /examination/remarks/exam | Add remarks for individual exams |
Reports & Transcripts
Edum provides several examination reports for individual students, classes and school analysis.
Menu: Examination → Reports
/examination/reportsIndividual Result
View a student's subject marks, grades and GPA and download the result as PDF.
Aggregate Result
View a combined or overall performance across examinations.
Transcript
View a student's academic record across terms or academic years and download PDF.
Tabulation Sheet
View a class-wide table of student marks and grades across subjects.
Merit List
Rank students according to their examination performance or GPA.
Class Statistics
Review class-level averages, counts and examination statistics.
Subject Analysis
Analyze subject-level performance and identify weaker subjects.
GPA Analysis
Analyze grade point distributions and export the analysis as PDF.
Pass / Fail Report
View how many students passed or failed for selected academic filters.
Many examination reports can be generated and downloaded as PDF.
Individual Result Email
Individual results can optionally be sent to a student's email address directly from the report screen.
Before using result email functionality, confirm that the school's email settings are working correctly.
Student Promotion
Promotion moves students from one class or academic year to the next, typically based on their current year's results.
Menu: Examination → Promotion
/examination/promotionSelect year, class, section and exam.
Review the students eligible for promotion.
Move the selected students to the next class/year.
Review previous promotion batches and their details.
Roll back a promotion batch if it was created in error.
Result Settings & Templates
Result Settings
Menu: Examination → Settings
/examination/settingsExamination settings can control how results are calculated and displayed, including academic flow, pass/fail thresholds, aggregate weights and result sheet defaults.
Changes to examination settings may affect subsequent result generation and reports. Review the effect of a setting before changing it.
Result Templates
Menu: Examination → Templates
/examination/templatesTemplates control the appearance of result sheets and report cards when printed or downloaded.
- Open Templates.
- Review existing templates.
- Use Builder to create or modify a layout.
- Configure the sections and columns that should appear.
- Save the template.
- Delete templates that are no longer required.
PDF troubleshooting: If a generated PDF does not look correct, check the active result template before troubleshooting the underlying data.
Students & Public Result Access
Students
After results are published, authenticated students can access their examination results and transcripts.
| Feature | Route | Available Action |
|---|---|---|
| Student Results | /examination/student/result | View Published Results |
| Student Transcript | /examination/student/transcript | View and download PDF |
| Normal Student Area | /student/results | View Published Results |
Public Result Links
Published results and transcripts can also be shared using token-based public links without requiring the viewer to log in.
| Resource | URL Pattern |
|---|---|
| Public Result | examination/result/{token} |
| Public Transcript | examination/transcript/{token} |
Keep public links private. Anyone who has a public result or transcript token link can access that published result.
Exam Seat Plans
A seat plan assigns every selected candidate to a room and seat. Complete it before issuing admit cards when the cards must show room and seat details.
Prepare exam rooms first
Open Examination → Exam Rooms and create or enable the rooms you will use. Each room needs a name or number, rows, columns, and capacity. Capacity cannot be greater than the room's rows multiplied by its columns.
Create a seat plan
- Open Examination → Seat Plan and select New Seat Plan.
- Select the school, session, exam, classes, and optional sections, shift, or department.
- Load the eligible active students and select the candidates to allocate.
- Select enabled exam rooms. Available seats must cover every selected student.
- Choose an allocation method and seat-number format, then use Preview Allocation.
- Review the preview and select Generate & Save.
| Allocation method | How it works |
|---|---|
| Sequential | Allocates students in class, section, and roll-number order. |
| Mixed Class | Alternates class and section groups where possible. |
| Random | Uses a generated seed to create a reproducible randomized order. |
Review, adjust, and lock
Open View to review allocations by room. While a plan is unlocked, authorized users can move a student to an empty position, swap two students, remove an allocation, add an eligible unallocated student, or regenerate the plan. Regeneration replaces manual changes.
Lock the final plan. Locking prevents further allocation changes and protects the room and seat details used on reports and admit cards. Unlock only to make an authorized correction, then review and lock it again.
Reports and seat slips
From the plan view, print or download PDF versions of the Visual Seat Plan, Room Student List, Class-wise Seat List, Room Door Notice, and Student Seat Slips. Seat slips can be filtered by room and by selected students.
Exam Admit Cards
Admit cards are generated per school, session, and exam. They can include candidate identity, examination details, room and seat information, instructions, and a public QR verification code.
Generate admit cards
- Open Examination → Admit Card and select Generate Admit Cards.
- Select the school, session, exam, classes, and optional sections.
- Enter the card title and examination instructions.
- Choose the fields to show: photo, student ID, registration number, exam time, room, seat, and QR code.
- Optionally require a saved seat allocation for every selected student.
- Load students, review the selection, and generate the cards.
Settings, view, print, and PDF
Use Settings in a batch's Actions column to update its title, instructions, visible fields, QR code, and seat-allocation requirement. The school, session, and exam remain fixed for that batch. View opens cards inside Edum; Print opens a clean A4 document; the PDF action downloads the active cards in the batch.
QR verification: each QR-enabled card links to /admit-card/verify/{card-token}. The public page confirms an active card and shows its school, student, exam, class/section, roll, room, and seat details. Test a sample QR code before distributing cards.
Student access
Logged-in students can see only their own active cards at /examination/student/admit-cards, where they can view a card or download its PDF.
Tips & Best Practices
Follow the Correct Order
Configure academic data, grade systems, exams, subjects and distributions before entering marks and generating results.
Lock Before Generating
Verify marks, lock them, then generate results so calculations are based on stable data.
Keep Grade Rules Contiguous
Avoid gaps between percentage ranges so every student receives the correct grade.
Use One Distribution
Each subject, class and exam combination should have exactly one mark distribution.
Recalculate After Changes
If marks are corrected after generation, recalculate affected results.
Remember Publishing
Generated results are not visible to students until they are published.
Troubleshooting
| Symptom | Likely Cause / Fix |
|---|---|
| A student has no marks | The subject may not be assigned to the student, or there may be no mark distribution for the subject/class/exam. |
| A student has no grade | The percentage may fall into a gap between grade rules. Check grade rule ranges. |
| Result not visible to students | The result may not have been generated or published. |
| Marks cannot be changed | Marks are locked. Unlock the relevant subject/exam before editing. |
| PDF looks incorrect | Check the result template and confirm that the correct published data is being used. |
| Wrong totals | Check the mark distribution components and recalculate results after any changes to marks. |
Quick Reference
| I want to... | Go to |
|---|---|
| Manage grade systems | /examination/grade-systems |
| Create an examination | /examination/exam-setup |
| Manage subjects | /examination/subjects |
| Configure mark distributions | /examination/mark-distributions |
| Enter marks | /examination/marks |
| Bulk import marks | /examination/marks/bulk-import |
| Generate results | /examination/results/generate |
| Publish results | /examination/result-publish |
| Generate reports | /examination/reports |
| Promote students | /examination/promotion |