Overview
Display label: Enrollment history grouping per
Setting ID: College_Group_HIstory_View_Per
Location: Main Settings > General Settings > Higher Education Customization, group Basic Settings
What This Setting Does
This setting chooses the dimension that Classter uses to group a _Student_’s _Group_-enrollment history entries when it records and displays that history. Instead of treating every enrollment record as a flat, unrelated row, Classter can bucket the history by _Grade_, by _Stream_, by School Registration Category, or by Form Status, so that a _Student_’s enrollment record for one academic context does not get mixed up with the record for a different one.
This dropdown only has an effect once the related setting Enable Student enrollment view based on enrollment history (College_Enable_Enrollments_History_View in Higher Education Customization > Basic Settings) is turned on. If that setting is off, the grouping dimension chosen here is stored but not used.
Where It Is Used
Students > open a Student’s profile > Enrollments tab > Enrollment History section. This is where the grouped enrollment history entries are displayed to office staff reviewing a Student’s academic record across periods.
The same grouping dimension is also used automatically, with no dedicated screen, in two backend processes: the curriculum _Subject_ declaration/enrollment save process, and the annual results calculation stored procedure that runs when Academic Tasks > Marking > Annual Results is executed for a _Student_.
Business Logic / Behavior
- Available grouping values are: None, Grade, Stream, School Registration Category, Form Status, and a second Form Status variant (Form Status 2).
- When set to None (or left unset), Classter does not group enrollment history snapshot rows at all, even if Enable Student enrollment view based on enrollment history is turned on.
- When set to Grade, enrollment history rows are matched and updated only when the _Student_’s current Grade matches the Grade recorded on the historical snapshot row.
- When set to Stream, the same matching is done using the _Student_’s Stream instead of Grade.
- When set to School Registration Category, matching uses the _Student_’s registration category (MCID) instead.
- When set to Form Status, matching uses the _Student_’s form/enrollment status value.
- The grouping dimension is read together with Enable Student enrollment view based on enrollment history inside the same settings batch every time curriculum enrollment history is fetched or updated; both settings must be evaluated together because the grouping value alone has no effect unless the history view is enabled.
- The chosen grouping also determines how the additional actions configured in Additional actions after the annual results calculation/Actions_After_Annual_Result_Calculation locate the correct historical enrollment snapshot row to update for a failed _Subject_.
Example(s)
Alpha Institute enables Enable Student enrollment view based on enrollment history and sets Enrollment history grouping per to Stream.
Student Maria P. is enrolled in the Business Administration curriculum. In academic year 2024-2025 she is registered under the Marketing stream; in 2025-2026 she transfers to the Finance stream.
Because grouping is set to Stream, Classter keeps her 2024-2025 Marketing-stream enrollment history separate from her 2025-2026 Finance-stream history. When an academic officer opens her Enrollments tab, the two streams’ subject histories are shown as distinct groups rather than one merged list, and any automatic update to a subject’s enrollment snapshot only touches the row that matches her current stream.
When to Use
Choose Grade when the institution’s curriculum tracks are primarily organized by academic year or grade level and enrollment history should not cross grade boundaries.
Choose Stream when _Students_ are organized into specializations or majors (streams) within the same Grade, and history should stay separated per stream, for example when a _Student_ changes major.
Choose School Registration Category when the institution’s meaningful grouping boundary is the registration category (for example, a scholarship or program-type category) rather than Grade or Stream.
Choose Form Status or Form Status 2 when enrollment history should be split by the _Student_’s form/enrollment status instead of academic structure.
Leave the value at None only if Enable Student enrollment view based on enrollment history is also left off, since the grouping choice has no effect without it.
Notes
- Prerequisite: Enable Student enrollment view based on enrollment history/College_Enable_Enrollments_History_View must be turned on for this setting to take effect.
- Related setting: Enable Student enrollment view based on enrollment history (College_Enable_Enrollments_History_View in Higher Education Customization > Basic Settings)
- Related setting: Additional actions after the annual results calculation (Actions_After_Annual_Result_Calculation in Higher Education Customization > Basic Settings)
- Related setting: Use automatic Group creation based on Subject (Auto_Create_Group_From_Subject in Higher Education Customization > Basic Settings)
K-12 vs Higher Education: this setting is only read and applied when Enable Student enrollment view based on enrollment history is enabled, and that enrollment-history-view feature is defined and evaluated only within the Higher Education Customization tab together with the other College-module settings in this group. In practice it is used by institutions that have curriculum structures and Educational Programs configured, which is the Higher Education side of Classter; it has no effect for a tenant that does not enable the enrollment history view.
