Guide to Marksheet Settings: Understanding Segment & Component Validation

Overview

We've enhanced the Mark Book Segments configuration page with smart, context-sensitive validation. This new system helps prevent common setup errors by checking the "Factors" and "Weights" you enter in real-time.

This guide explains the relationships between Segments and Components and the new rules you must follow to save your settings.

The Setup: A Context-Sensitive Structure

The settings on this page follow a clear hierarchy. Understanding this structure is key to setting them up correctly:

1. Grade Level: The top-level filter (Year / Term / Grade Level). All settings below apply only to the grade level you've selected.
2. Marksheet Segments: These are the main grading categories for the selected grade level (e.g., "Mid Term," "Final Exam").
3. Marksheet Components: These are the sub-categories within a single segment (e.g., "Test," "Quiz," "Assignment").

Because of this structure, the validation rules for Components are "context-sensitive"—they depend on the rules you just set for their parent Segment.

1. Rule for Marksheet Segments ⚖️

Segments are the high-level "buckets" for your grades. Their Factor values must add up correctly to represent a valid total for the term.

The Rule: The sum of all segment Factors must be either:

• Exactly 1 (for standard weighted grading, e.g., Mid Term 0.5 + Final 0.5 = 1).
• A whole number greater than 1 (for averaging, e.g., Term 1 1 + Term 2 1 = 2).

⚠️ Error Example (from the image):

The admin has only one segment, "MID TERM," with a factor of 0.5. The system shows an error:

"The sum of segment factors is 0.50, which is less than 1. The sum must be exactly 1..."

To fix this, the admin would need to add other segments (like "Final Exam") until the total factor sum equals 1.

2. Rule for Marksheet Components (Context-Sensitive) 🎯

Components are the sub-categories inside a segment. The system validates the sum of their Weight values against the parent segment's Factor.

The Rule: The sum of all component Weights for a segment must meet one of the following three conditions:

1. Sum equals 1 (Standard weighting, e.g., Test 0.5 + Quiz 0.3 + Assignment 0.2 = 1).
2. Sum is a whole number > 1 (For averaging components).
3. Sum equals the parent segment's Factor (This is the new, context-aware rule).

⚠️ Error Example (from the image):

1. The parent segment "MID TERM" has a Factor of 0.5.
2. The components inside it are: Test 0.5, Quiz 0.3, and Assignment 0.1.
3. The sum of these components is 0.5 + 0.3 + 0.1 = 0.90.
4. This sum (0.90) is invalid because it does not equal 1, it is not a whole number greater than 1, and it does not equal the parent's factor of 0.5.

The error message correctly identifies this:

"'MID TERM' components sum to 0.90. This is invalid. The sum must equal 1, be a whole number > 1, or match the segment factor of 0.5."

To fix this, the admin would need to adjust the component weights so their sum is either 1 or 0.5.

3. The "Heads Up" Warning Banner 💡

You will also see a yellow "Heads up" banner whenever you change a factor or weight. This banner is a reminder of the "either/or" logic we've built in:

• Changing Segment Factors will update all gradebook columns that are not using components.
• Changing Component Weights will update all gradebook columns that are using components.

This warning lets you know that saving your changes will impact the gradebook and may require you to withdraw and resubmit grades for the new calculations to take effect.

Summary: Always look for the red error banners and fix them before saving. The new validation rules are designed to ensure your gradebook calculations are mathematically sound and error-free from the start.