Overview
Display label: Additional actions after the annual results calculation
Setting ID: Actions_After_Annual_Result_Calculation
Location: Main Settings > General Settings > Higher Education Customization, group Basic Settings
What This Setting Does
After Classter calculates a _Student_’s annual academic result and determines whether the _Student_ is promoted to the next academic year, this setting lets the institution automatically trigger one or more follow-up actions for any _Subject_ the _Student_ failed:
- Remove depending Subjects: automatically remove (soft-delete) any other Subjects the Student had already enrolled in that depended on the failed Subject as a prerequisite, since the Student can no longer take them.
- Change prerequisite Subject status to retake: automatically switch the failed Subject’s status to a designated retake status, so the Student’s record clearly shows it must be retaken.
- Change School Registration Category to previous state: automatically roll back the Student’s registration category to the value it had before the current period, reversing any category change that had been applied.
More than one of these actions can be selected at the same time; Classter runs whichever are selected for every failed Subject found during the calculation.
Where It Is Used
This setting has no dedicated screen of its own. It runs automatically inside the annual results calculation that is triggered from Academic Tasks > Marking > Annual Results (the AnnualResults screen), whenever an academic officer runs the annual result/certification calculation for a group of Students.
Business Logic / Behavior
The three actions are only evaluated when a Student’s Subject is found to be failed during the calculation, and the entire block of logic that reads this setting only runs when Enable Student enrollment view based on enrollment history/College_Enable_Enrollments_History_View is turned on and Enrollment history grouping per/College_Group_HIstory_View_Per is set to a value other than None. If either of those two conditions is not met, the actions selected here are never executed, regardless of what is selected.
- Remove depending Subjects: Classter walks the curriculum’s prerequisite chain (through the classification/team structure) to find every Subject enrollment that lists the failed Subject as a prerequisite, then marks those enrollments as deleted with today’s date as the deletion date.
- Change prerequisite Subject status to retake: Classter looks up the first configured course status that is flagged as a retake status (not a pass, not a fail, not an exemption, not an absence-failure) and applies it to the failed Subject’s enrollment record; it then updates the matching enrollment history snapshot row for that Subject, using the dimension chosen in Enrollment history grouping per (Grade, Stream, School Registration Category, or Form Status) to find the correct historical row to update.
- Change School Registration Category to previous state: Classter looks up the registration category recorded on the Student’s most recent enrollment history snapshot for that Subject and resets the Student’s current registration category to that earlier value.
- Selecting None (the default) means no additional action runs after the calculation; the annual result is still calculated and promotion still happens, but nothing else is changed automatically.
Example(s)
Alpha Institute has enabled the enrollment history view, set the grouping to Stream, and selected both Remove depending Subjects and Change prerequisite Subject status to retake.
Student Ioannis K. fails Calculus II in the Engineering program’s 2025-2026 annual result calculation. Calculus II is a prerequisite for Differential Equations, which he had already enrolled in for the following term.
When the annual results calculation runs: Classter removes his Differential Equations enrollment automatically (since its prerequisite was not passed), and changes his Calculus II course status to Retake so his transcript clearly shows it needs to be repeated. If Change School Registration Category to previous state had also been selected and his category had changed mid-year from Regular to Probation, that category would be reverted back to Regular as recorded on the prior snapshot.
When to Use
Select Remove depending Subjects when the institution wants failed prerequisite chains to automatically clean up downstream enrollments instead of requiring staff to manually withdraw Students from Subjects they can no longer take.
Select Change prerequisite Subject status to retake when the institution wants a failed Subject to be immediately and visibly flagged for repetition in the Student’s record, without a manual status change.
Select Change School Registration Category to previous state when registration category changes during the year (for example, probation, scholarship tiers) should be automatically undone if the annual result calculation reverses the situation that caused the change.
Leave the selection empty (None) if the institution prefers to review failed Subjects manually and apply any status or enrollment changes by hand.
Remember that none of the selected actions take effect unless Enable Student enrollment view based on enrollment history is on and Enrollment history grouping per is set to a value other than None.
Notes
- Prerequisite: Enable Student enrollment view based on enrollment history/College_Enable_Enrollments_History_View must be enabled.
- Prerequisite: Enrollment history grouping per/College_Group_HIstory_View_Per must be set to a value other than None.
- Related setting: Enrollment history grouping per (College_Group_HIstory_View_Per in Higher Education Customization > Basic Settings)
- Related setting: Don’t allow Student progress if outstanding payments exist (annual results calculation) (Dont_allow_Student_progress_if_outstanding_payments_exist in Higher Education Customization > Basic Settings)
- Related setting: Enable GPA Calculation Format (Enable_GPA_Calculation_Format in Annual Results > Basic Settings)
K-12 vs Higher Education: the annual results calculation itself runs for any tenant, but this setting’s actions are wired specifically into the College enrollment-history mechanism: they only execute when Enable Student enrollment view based on enrollment history is on and a grouping dimension other than None is selected, both of which are Higher Education Customization settings. An institution that does not use the College enrollment-history view will have this setting stored but never actually applied.
