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

Open Grading System

Open Grading System and click Create.

Enter the System Name

For example, "Standard 5-point".

Save

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

Create an Examination

Open Exam Setup

Click Create.

Enter Exam Information

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

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

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

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

Manual Mark Entry

Select Academic Data

Select school, year, class, exam and subject.

Review Students

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

Enter Component Marks

Enter marks for each component and student.

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

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

Select Filters

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

Generate

Click Generate to calculate and store the result records.

Review

Check how many results were created.

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

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

Select Academic Data

Select year, class, section and exam.

Preview Students

Review the students eligible for promotion.

Process Promotion

Move the selected students to the next class/year.

Review History

Review previous promotion batches and their details.

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.

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.

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