Academics

Assessments, marks and reports

Create an assessment, capture marks, publish when you are ready, print a learner report.

Written for School adminTeacher
On this page

This page has no sections.

Marks in Alviyora go through three stages: you create an assessment, you capture marks against it, and you publish it. Nothing reaches a learner or a guardian until that third stage, and that is the point of the design — a mark is visible when the teacher decides it is, not when it is typed.

Who can do this

View Academics to create assessments and capture marks — Teacher holds it. View Own Results is the separate, narrower permission that lets a learner or guardian see their own marks and nobody else’s.

Creating an assessment

Academics → Results → Create Assessment.

A school at the start of a term. Everything begins with Create Assessment.

An assessment carries:

FieldWhat it is for
NameWhat it is called on a report — “Term 1 Test 1”
TypeTest, Assignment, Exam, Project or Practical
SubjectWhich subject it belongs to
Academic yearWhich year it is filed under
GradeWhich grade sits it
ClassOptional — leave blank and it is for the whole grade
Total marksWhat it is out of
WeightIts percentage contribution towards the final mark
TermTerm 1 to 4
DateWhen it is written
Time and venueOptional — fills in the exam timetable

Weights are what make an average mean something

The weight is a percentage contribution to the subject’s final mark. A term’s assessments should add up to what your school’s policy says they should — often 100 across the year, or 25 per term. Set them as you create each assessment rather than reconciling them in November.

Class or whole grade

Leaving Class blank makes the assessment apply to the entire grade — right for a common paper written by every Grade 10. Setting a class scopes it to that class, which is right when 10A and 10B write different tests.

Capturing marks

Open the assessment and you get the enrolled learners as a list.

  • Type each mark. It is validated against the total — you cannot enter 85 out of 60.
  • Tick absent for a learner who did not write. That is different from a zero, and the averages treat it differently.
  • Add a per-learner comment where it helps.
  • Save.

You can leave and come back; partial capture is saved.

Marks capture keeps working offline

If the connection drops while you are typing a class’s marks, Save still works — the marks are kept on the device and sent as soon as the signal returns. A banner tells you they are waiting, and again when they have gone up. Along with the daily register, this is one of only two screens that work without a connection; see Taking the register for what that does and does not cover.

An empty mark list means an enrolment problem

The capture list is built from enrolled learners — learners enrolled in that subject in that grade. If it is empty or short, the enrolment is incomplete rather than the assessment being wrong. See Enrolments.

The marks capture sheet

Most schools capture every mark twice: once in Alviyora, and again in the departmental mark workbook. The Marks capture sheet button on the results screen removes the second typing.

It downloads a spreadsheet holding your marks, laid out in the order the departmental sheet lists learners — surname first, alphabetically — so the mark column can be copied and pasted straight across instead of retyped learner by learner.

Filter to one subject and one grade

The button stays greyed out until you do. Departmental workbooks capture one subject-class at a time, so a sheet spanning two subjects would have nothing to be pasted into.

Download the sheet

It opens in Excel or LibreOffice. The top of the sheet states the subject, grade, term and year, and counts what is inside — how many learners, how many tasks, how many marks captured, absent, and not yet captured.

Check the two lists line up

Compare the learner count against your departmental sheet, and check the first and last names match. This is the one check worth doing every time.

Paste the mark columns only

Each mark column is headed with the task name, its total, its date, and a code like T1:A1. Match on the name and total, and paste only the marks.

Check the order before you paste

If the two lists are ordered differently, a correct column of marks lands on the wrong learners — and neither screen will tell you. Nothing goes red. That is why the sheet prints the learner count at the top: it is your check, and it takes ten seconds.

What the cells mean

-1 is a learner who was absent. An empty cell means no mark has been captured yet — leave it empty. Do not type 0: a zero is a real mark of zero, and pasting one turns “not marked yet” into “scored nothing” on a report card.

This is a transfer sheet, not a departmental file. It is not a file the departmental system can import, and it is not trying to be — those workbooks are distributed encrypted and carry their own hidden learner identifiers, so only the mark cells may be changed. Copying marks across is precisely the operation they permit. The filename begins alviyora-marks-capture_ so it is never mistaken for one of theirs in the same folder.

Publishing

An assessment has a published state, and it starts unpublished.

  • Unpublished — visible to staff. Invisible to learners and guardians.
  • Published — visible to the learners who wrote it and to their guardians.

Publish when the marking is finished, checked and moderated. Not before.

This is the mechanism that lets a teacher capture marks over a week without a parent seeing a half-marked class and drawing conclusions from it.

Publishing can be reversed if something is wrong; the marks stop being visible again while you fix them.

Learner reports

Academics → Learner Report, or the Academic record button on any learner’s profile, which opens that learner directly.

Pick a learner to see every subject they take, every mark, and their averages.

Choose a learner and you get their whole academic picture on a page of its own: their subjects, every assessment in each, the marks, and the average per subject and overall. Each learner’s record has its own address, so you can bookmark one before a parent meeting or send the link to a colleague.

One learner's full record — every subject, every mark, and the averages.

A learner with no marks captured yet shows a dash rather than 0.0%. Nothing recorded and everything scored zero are different situations, and the report says which one it is.

This is the screen to open before a parent meeting, and the source of the report card at the end of a term.

What learners and guardians see

They see published assessments only, for their own subjects. A learner opening Results gets:

  • Each subject they are enrolled in.
  • Each published assessment in it, with their mark, the total, and the percentage.
  • Their average per subject.

A guardian sees exactly the same, per child.

The permission behind this is View Own Results, which is deliberately separate from the staff-facing View Academics. A learner seeing their own marks is a narrower claim than a teacher capturing everyone’s, and conflating the two would mean handing learners the capture screens.

Year-end

Weighted subject averages roll up into the final average that year-end promotion works from. Getting the weights right through the year is what makes that number trustworthy in November.