For administrators

Gradebooks and transcripts

Recording marks in a class or an admission campaign, what publishing sends and why it cannot be taken back, and what the transcript and administrative-paper templates under Student Services do and do not produce.

This article covers two jobs that sound like one, and they live in two different parts of the administration side.

Gradebooks are where marks are recorded. A gradebook belongs to one course of one class, or to one admission campaign, and you reach it from inside that class or that campaign — never from a menu of its own.

Transcripts and Administrative Papers are document templates. They live under Tools → Student Services, and they are visible to administrators only.

If you are looking for one and finding the other, that is the reason. The two halves below are independent; the section at the end joins them up.

Most of this is in English

The gradebook's own controls — Add Grade, Export, Publish Gradebook, New Gradebook and the Gradebook tab — are translated. Almost everything inside the panels is not, and neither is anything under Student Services except the two tab names.

The labels below are quoted as each reader will see them.

Part one: gradebooks

Where a gradebook comes from

Three routes, and which one you took decides how much work is waiting for you.

It was there already

A class built from a program — by Start the Class, from the cohort's Classes tab, or from the class form's program option — arrives with a gradebook per course, already carrying the columns, the weights and the descriptions the program's structure attached to that course.

This is the route worth using. See Classes and lectures.

Create from Template

An empty course says "This course doesn't have a gradebook yet!" and "Get started by creating a new gradebook.", with two buttons.

Create from Template asks you to Select Template and builds the gradebook from it — the same templates the program's structure uses, and the same columns.

New Empty Gradebook

The other button. It gives you a gradebook with no columns at all, which you then build by hand.

Gradebook templates themselves are made under Tools → Settings → Gradebook Templates; see Settings. They are attached to a course through the program's Structure screen, where the form that adds a course to a module carries Add gradebook templates; see Programs and cohorts.

The grid

One row per student enrolled in that course, one column per grade.

Each column heading is the grade's name followed by its weight, written as "× 2". Choosing the heading opens that grade for editing. A course with nobody on it says "This course doesn't have any students yet" and "Get started by adding new students!".

The bottom row, Average, is the mean of each column. Where a template supplied computed columns — a total, a weighted average, a rule of your school's own — they appear alongside the grades and cannot be typed into.

Entering marks

Type in a cell. There is no save button: the value is written about a second after you stop typing, and pressing Enter moves you down to the next student in the same column, wrapping to the top of the next column at the end.

Hovering a cell shows a small document icon, which opens that one mark on its own with a Mark field and Comments. The comment is where an explanation belongs — a late submission, a resit, a penalty — and it stays with the mark.

Adding a grade

Add Grade offers two ways in.

Create New Grade — "Select this option if you want to create a new grade." — asks for a Name, a Description and a Weight, and gives you an empty column to type into.

Import Existing Grade takes the scores that already exist somewhere else in the class. It asks which kind — Exams or Assignments — then which one, then the same name, description and weight. In an admission campaign's gradebook only Exams is offered, because assignments belong to classes.

An imported grade keeps following its source

Importing is not a one-off copy. A grade imported from an assignment stays attached to it, and re-marking a submission afterwards updates the figure in the gradebook on its own.

That is usually what you want, and it has one consequence worth holding on to: a mark you correct by typing over it in the grid can be overwritten again later by the marking screen it came from. If a score needs changing, change it where it was produced.

A grade can also be set up as a peer review — "I want this grade to be evaluated by multiple reviewers" — with its own reviewers, reviewees, weights and scoring grid. That is a large feature in its own right and this article does not cover it.

Publishing

Nothing a gradebook holds is visible to a learner until it is published, and publishing happens one of two ways.

Publish Gradebook, in the menu beside Add Grade, publishes everything at once. It asks "Do you want to publish this gradebook?" and explains: "By publishing the gradebook, all the students will receive their scores in each grade."

Publish Grade, on a single grade's own form — "Select this option if you want to share the grade with the student." — publishes that column alone.

Both refuse until every student has a mark in the grade concerned. Where one is missing, the dialog reads "You can't publish this gradebook right now" and "There are still some students that do not have a score in some grades", and there is nothing to press. This is a feature, not an obstacle: it is what stops half a gradebook going out.

When a grade is published, every student in it is sent an email, one per grade, subject "Grade Available", carrying their mark, the name of the grade and the name of the course.

Publishing cannot be undone from any screen

This is the one thing on this page to read twice.

Once a grade has been published, its whole column becomes read-only: the cells refuse to be typed into, the single-mark panel greys out its Mark field, and the Publish Grade tick box on the grade's own form is disabled and cannot be cleared. Once every grade in a gradebook is published, Publish Gradebook greys out too.

There is no unpublish button, anywhere. A mark you publish is a mark you have finished with, as far as these screens are concerned — and the learner has already had the email.

So treat publishing as the last act. Check the column, check the Average row, and check the handful of people you know are borderline, before you press it. If something has to be corrected after publication, this is a conversation with your platform administrator, not a job you can do here.

Exporting

Export downloads the gradebook as a spreadsheet: a row per student under "Full name", a column per grade and per computed column, and the date it was taken at the bottom. It exports exactly what is on screen, published or not.

This is the file to reach for when somebody needs their marks before the gradebook is ready to publish, and it is also a sensible thing to keep before a round of corrections.

More than one gradebook

New Gradebook adds another to the same course, either empty or from a template, and they appear as a list down the left. Use it where one course is marked in two genuinely separate ways — a continuous-assessment book and an examination book, say — rather than as a way of splitting one mark scheme in half.

Part two: transcripts and administrative papers

Tools → Student Services has two tabs: Transcripts, which a French reader sees as Modèles de bulletins, and Administrative Papers, in French Certificats et Papiers administratifs. Both are administrator-only.

The French name is the more accurate of the two. What lives here are templates, not documents.

Creating a transcript template

New Transcript asks for three things:

  • Name.
  • Program — a transcript belongs to exactly one program.
  • Its modules, ticked from that program's structure.

The modules matter more than they look: they decide which courses, and therefore which grades, the template will be allowed to refer to.

The list then shows Name and Program, with a settings button to open it and a bin that asks 'Are you sure you want to delete "MBA transcript"?' and "This action cannot be undone".

Writing the content

Opening a template gives you Name and Content, and Content is a full page editor. You lay out the document — heading, school details, a table of results, a signature block — and drop variables into it wherever a real value belongs.

The variable picker has three tabs:

  • Student Variables — the person's own details.
  • Organization Varibales (spelt that way on screen) — the school's.
  • Program Variables — everything that belongs to the program and the modules you ticked, including one entry per grade of each course's gradebook template, and any computed columns and program-level formulas your school has defined.

Choosing a grade variable walks you through "Select a course" and then "Select a grade".

Save stores the layout and remembers which variables you used. A variable you delete from the page is forgotten.

What has to be true before a grade can appear

A grade variable does not point at a mark. It points at a column of a gradebook template, on a course of a program, and it is filled in for a named person only when every link in the following chain holds:

The gradebook template exists

Built under Tools → Settings → Gradebook Templates.

It is attached to the course inside the program

Through Add gradebook templates on the program's Structure screen. A template that exists but is attached to nothing offers no variables at all.

The class was built from that program

So that the course in the class is recognisably the course in the program. A class filled with Attach Courses is not; see Classes and lectures.

The gradebook in that class came from the template

Which it does automatically on that route. A gradebook someone created with New Empty Gradebook carries the marks but not the connection.

The mark has been entered

Publishing is not required. Typing is.

Break any one of the five and the variable comes out blank — silently, with no warning and no error. If you are setting a transcript up for the first time, work down that list in order rather than debugging the template.

Nothing on the administration side issues a finished transcript for a named student

This is the hard fact about this half of the article, and it is better known now than the week somebody needs a document.

Transcripts is a template editor and nothing else. You can create the template, tie it to a program and its modules, lay out the page and insert every variable you need. There is no button — not on this screen, not on a student's profile, not in a class, not in a cohort — that takes a template plus a person and produces the filled-in document.

Administrative Papers goes one step further and then stops. A student's profile carries a Documents tab listing the paper templates with a magnifying glass tooltipped Preview and a printer tooltipped Print. Choosing Preview opens an empty panel containing the word "Preview". The printer does nothing at all.

So if an officer has to hand a learner a transcript next week, ABS Elevate will not print it. What these screens are good for today is preparing the template and getting the marks into the right gradebooks, so the document can be produced the moment the platform can produce it. Raise the gap with your platform administrator, and plan the actual document outside the platform in the meantime.

What you can produce today is in the section below.

Administrative papers

The second tab works the same way, with New Paper, a Program and its modules, and a Content editor. It adds one thing the transcript form does not have: Tags, entered as a key and a value, which is how a school separates certificates of attendance from certificates of enrolment from anything else.

One difference is worth knowing: a paper's variable picker offers Student Variables, Organization Varibales and the program's own variables, but no grade variables. A certificate can name the person, the school and the program; it cannot carry their marks. That distinction is deliberate, and it is the practical difference between the two tabs.

If Tools shows a second administrative-papers entry, ignore it

The Tools group can carry a separate entry pointing at administrative papers, alongside Student Services. In English it has no name of its own and shows as raw text; it leads to a page that does not exist, and opens blank.

The working screen is the Administrative Papers tab inside Student Services.

What you can actually give a learner today

Four things, none of them a transcript, and all of them real:

  • The gradebook export, course by course. A spreadsheet of names and marks, available whether or not anything is published.
  • A published gradebook, which sends each learner an email per grade and puts their own marks in front of them.
  • The class-wide grade sheet, which has a Print button and covers every course of a class at once — though nothing links to it, so you will need its address from your platform administrator. See Classes and lectures.
  • The attendance export on a lecture, where what is being asked for is really an attestation of presence.

For anything that has to carry a signature and a school letterhead, use the exports as your source and produce the document outside ABS Elevate.