Edum Documentation
Examination Guide

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:

1. Grading System 2. Exam Setup 3. Subjects 4. Mark Distribution 5. Mark Entry 6. Generate Results 7. Publish 8. Remarks 9. Reports 10. Promotion

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.

Example:
A+ = 80–100% (5.00) A = 70–79% (4.00) F = 0–39% (0.00)

Menu: Examination → Grading System

/examination/grade-systems

Create a Grade System

1
Open Grading System

Open Grading System and click Create.

2
Enter the System Name

For example, "Standard 5-point".

3
Save

Store the grade system.

Add Grade Rules

  1. Open the grade system's Rules option.
  2. Click Create.
  3. Enter the percentage range, grade and grade point.
  4. Store the rule.
  5. 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-setup

Create an Examination

1
Open Exam Setup

Click Create.

2
Enter Exam Information

Enter the exam name and select the school and academic year.

3
Store the Exam

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/subjects

Create a Subject

  1. Open Subjects.
  2. Click Create.
  3. Enter the subject name and code.
  4. Select the relevant class and academic year.
  5. 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-students

Select 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.

Example:

English: Written = 70, Oral = 20, Project = 10, Total = 100

Menu: Examination → Mark Distribution

/examination/mark-distributions

Create a Mark Distribution

  1. Open Mark Distribution.
  2. Click Create.
  3. Select school, academic year, class, subject and exam.
  4. Add each component and its maximum marks.
  5. 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/marks

Manual Mark Entry

1
Select Academic Data

Select school, year, class, exam and subject.

2
Review Students

Edum filters the student list according to the selected academic information.

3
Enter Component Marks

Enter marks for each component and student.

4
Store Marks

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
  1. Open Marks → Bulk Import.
  2. Select school, year, class, subject and exam.
  3. Download the real-data template or blank sample.
  4. Fill in the marks.
  5. Upload the file.
  6. Preview the imported data.
  7. 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/generate
1
Select Filters

Select school, year, class, section, exam and subject where applicable.

2
Generate

Click Generate to calculate and store the result records.

3
Review

Check how many results were created.

4
Recalculate When Necessary

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-publish

Publish

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
  1. Open Aggregate.
  2. Select the required filters.
  3. Click Generate.
  4. 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/reports

Individual Result

View a student's subject marks, grades and GPA and download the result as PDF.

/examination/reports/individual-result

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.

/examination/reports/transcript

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.

/examination/reports/pass-fail-report

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/promotion
1
Select Academic Data

Select year, class, section and exam.

2
Preview Students

Review the students eligible for promotion.

3
Process Promotion

Move the selected students to the next class/year.

4
Review History

Review previous promotion batches and their details.

5
Roll Back if Necessary

Roll back a promotion batch if it was created in error.

Result Settings & Templates

Result Settings

Menu: Examination → Settings

/examination/settings

Examination 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/templates

Templates control the appearance of result sheets and report cards when printed or downloaded.

  1. Open Templates.
  2. Review existing templates.
  3. Use Builder to create or modify a layout.
  4. Configure the sections and columns that should appear.
  5. Save the template.
  6. 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

  1. Open Examination → Seat Plan and select New Seat Plan.
  2. Select the school, session, exam, classes, and optional sections, shift, or department.
  3. Load the eligible active students and select the candidates to allocate.
  4. Select enabled exam rooms. Available seats must cover every selected student.
  5. Choose an allocation method and seat-number format, then use Preview Allocation.
  6. Review the preview and select Generate & Save.
Allocation methodHow it works
SequentialAllocates students in class, section, and roll-number order.
Mixed ClassAlternates class and section groups where possible.
RandomUses 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

  1. Open Examination → Admit Card and select Generate Admit Cards.
  2. Select the school, session, exam, classes, and optional sections.
  3. Enter the card title and examination instructions.
  4. Choose the fields to show: photo, student ID, registration number, exam time, room, seat, and QR code.
  5. Optionally require a saved seat allocation for every selected student.
  6. 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