The goal of the Grade Book Working Group is an efficient, functional standard that supports the entire SIF structure, allowing for easy, bi-directional transfer of data integral to grading.
This object provides information about a particular assignment, allows applications to synchronize each other's assignment tables, gathers the definition for a GradingAssignmentScore object, etc.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
GradingAssignment | This object provides information about a particular assignment, allows applications to synchronize each other's assignment tables, gathers the definition for a GradingAssignmentScore object, etc. | |||
@ | RefId | M | A GUID that identifies an instance of this object. | RefIdType |
@ | SectionInfoRefId | M | The GUID for the SectionInfo object. | IdRefType |
@ | TermInfoRefId | M | The GUID for the TermInfo object that defines the marking period that the assignment was created in. | IdRefType |
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that these Mark Values apply to. | IdRefType |
@ | GradingCategoryRefId | M | The GUID for the GradingCategory that this assignment is part of. | IdRefType |
Description | M | The text-based description of the assignment. | xs:string | |
PointsPossible | M | The points possible on the assignment. | xs:unsignedInt | |
CreateDate | O | Creation date of the assignment. | xs:date | |
DueDate | O | Date the assignment is due. | xs:date | |
Weight | O | The weight of the assignment. | xs:decimal | |
DetailedDescription | O |
This element defines the assignment.
If the | URIOrBinaryType | |
@ | Type | M | The type of information that is contained in the DetailedDescription element. | values:
|
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object provides score information about a particular assignment.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
GradingAssignmentScore | This object provides score information about a particular assignment. | |||
@ | RefId | M | A GUID that identifies an instance of this object. This RefId is new for 2.7M and MUST be supported like other objects that have a RefId (i.e. it is the key for the object). The alternate keys MUST continue to be supported. | RefIdType |
@ | StudentPersonalRefId | M | IdRefType | |
@ | SectionInfoRefId | M | IdRefType | |
@ | SchoolInfoRefId | M | The GUID that specifies the school this score was recorded at. | IdRefType |
@ | GradingAssignmentRefId | M | IdRefType | |
ScorePoints | C | The score represented as points. Conditionally required that one or more of ScorePoints, ScorePercent or ScoreLetter must be filled in. | xs:unsignedInt | |
ScorePercent | C | The score represented as a percent. Conditionally required that one or more of ScorePoints, ScorePercent or ScoreLetter must be filled in. | xs:decimal | |
ScoreLetter | C | The score represented as a letter grade. Conditionally required that one or more of ScorePoints, ScorePercent or ScoreLetter must be filled in. | xs:string | |
ScoreDescription | O | Text description of the score. | xs:string | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object provides information about a particular grading category to provide grouping and type information for assignments.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
GradingCategory | This object provides information about a particular grading category to provide grouping and type information for assignments. | |||
@ | RefId | M | GUID that identifies a grading category. | RefIdType |
@ | SectionInfoRefId | M | The GUID for the SectionInfo object that this category is used for grading in. | IdRefType |
@ | TermInfoRefId | M | The GUID for the TermInfo object that defines the marking period that the category was created in. | IdRefType |
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that these Mark Values apply to. | IdRefType |
Description | M | The name/short description of the category. | xs:string | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object defines each mark that can be recorded and associates it with a MarkValueInfo object that lists the types of values and valid values for each type. It also places the definition in the context of a school and a school year.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
MarkInfo | This object defines each mark that can be recorded and associates it with a MarkValueInfo object that lists the types of values and valid values for each type. It also places the definition in the context of a school and a school year. | |||
@ | RefId | M | The Id (GUID) that uniquely identifies this Grading Mark entity. | RefIdType |
@ | MarkValueInfoRefId | M | The Id (GUID) that uniquely identifies the MarkValueInfo. | IdRefType |
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that this Mark applies to. | IdRefType |
SchoolYear | M | The year that this MarkInfo applies to. | SchoolYear | |
Description | M | Textual description of the type of Mark (e.g. "Marking Period Grade", "Comment 1", "Comment 2", "Conduct", "Effort", "WorkHabits"). | xs:string | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object defines the types of values allowed for a mark and the domain for each mark value. At least one of the Percentage, Numeric, Letter or Narrative nodes must be used to create a valid MarkValueInfo.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
MarkValueInfo | This object defines the types of values allowed for a mark and the domain for each mark value. At least one of the Percentage, Numeric, Letter or Narrative nodes must be used to create a valid MarkValueInfo. | |||
@ | RefId | M | The Id (GUID) that uniquely identifies this MarkValueInfo entity. | RefIdType |
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that these Mark Values apply to. | IdRefType |
SchoolYear | M | The year that this MarkValueInfo applies to. | SchoolYear | |
Name | M | The text name of the value list ("Letter Grades", "Letter Grades (+/-)", "ESU", "Pass/Fail", "Override Grades", "Citizenship Comment Codes", etc.). | xs:string | |
Percentage | M | Indicates whether a percent Mark is accepted (format ##0.00). | ||
@ | IsAccepted | M | Indicates whether a percent Mark is accepted and is used in Change events to unambiguously signal whether support for the Mark has changed, especially ended. | xs:boolean |
Percentage/Minimum | O | The minimum percent value accepted for this mark. If present, the publisher of this object is required to ensure that any values present in the StudentSectionMarks object will not be lower than this value. | xs:decimal | |
Percentage/Maximum | O | The maximum percent value accepted for this mark. If present, the publisher of this object is required to ensure that any values present in the StudentSectionMarks object will not be higher than this value. | xs:decimal | |
Numeric | M | Indicates whether a raw numeric score is accepted. | ||
@ | IsAccepted | M | Indicates whether a raw numeric score is accepted and is used in Change events to unambiguously signal whether support for the score has changed, especially ended. | xs:boolean |
Numeric/Precision | O | Number of significant digits. | xs:unsignedInt | |
Numeric/Scale | O | Number of decimal places. | xs:unsignedInt | |
Numeric/Low | O | Lowest Mark in the range (e.g., 98, 3.95). | xs:decimal | |
Numeric/High | O | Highest Mark in the range (e.g., 100, 4.0). | xs:decimal | |
Letter | M | Indicates whether a letter Mark is accepted. | ActionList (ValidMark/Code) | |
@ | IsAccepted | M | Indicates whether a letter Mark is accepted and is used in Change events to unambiguously signal whether support for the Mark has changed, especially ended. | xs:boolean |
Letter/ValidMark | CR |
List of specific valid letter Marks. May be omitted when | ||
@ | SIF_Action | O |
In a | values:
|
Letter/ValidMark/Code | M | String representing the actual Mark that would appear on the report card (e.g., "A+", "I", "100"). | xs:token | |
Letter/ValidMark/NumericEquivalent | O | Numeric equivalent for the Mark (e.g., 100, 4.0). | xs:decimal | |
Letter/ValidMark/Description | O | The description for this code. (e.g. "Excellent", "Participates in Class", "Incomplete", etc...). | xs:string | |
Narrative | M | If present, indicates that a free-form text narrative is accepted. | ||
@ | IsAccepted | M | Indicates whether a narrative is accepted and is used in Change events to unambiguously signal whether support for a narrative has changed, especially ended. | xs:boolean |
Narrative/MaximumSize | O | An integer value representing the maximum number of Unicode characters for the narrative, the UTF-8 encoding of which may be longer. | xs:unsignedInt | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object provides attendance for a student in the context of a SectionInfo object. It is used to represent the final/official attendance that has been assigned to a student. Only one agent in a zone should generate events for this object. That agent is responsible for receiving and validating all StudentPeriodAttendance events and for generating a corresponding OfficialStudentPeriodAttendance event once any unofficial events have been processed.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
OfficialStudentPeriodAttendance | This object provides attendance for a student in the context of a SectionInfo object. It is used to represent the final/official attendance that has been assigned to a student. Only one agent in a zone should generate events for this object. That agent is responsible for receiving and validating all StudentPeriodAttendance events and for generating a corresponding OfficialStudentPeriodAttendance event once any unofficial events have been processed. | StudentPeriodAttendance |
This object defines the marking periods (TermInfo) that marks (StudentSectionMarks) are recorded in for a particular section (SectionInfo) and lists the types of marks (MarkTypeInfo) that are valid for that marking period (TermInfo).
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
SectionMarkInfo | This object defines the marking periods (TermInfo) that marks (StudentSectionMarks) are recorded in for a particular section (SectionInfo) and lists the types of marks (MarkTypeInfo) that are valid for that marking period (TermInfo). | |||
@ | RefId | M | A GUID that identifies an instance of the object. This RefId is new for 2.7M and MUST be supported like other objects that have a RefId (i.e. it is the key for the object). The alternate keys MUST continue to be supported. | IdRefType |
@ | SectionInfoRefId | M | The Id (GUID) that uniquely identifies the SectionInfo object that this item refers to. | IdRefType |
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that these Mark Values apply to. | IdRefType |
TermMarkLists | M | ActionList (MarkInfoList/@TermInfoRefId) | ||
TermMarkLists/MarkInfoList | MR | The grading-related information for a section, repeating for each marking period (TermInfo) in which the section reports Marks. | List | |
@ | TermInfoRefId | M | The Id (GUID) that identifies the marking period that the following marks are recorded in. | IdRefType |
@ | SIF_Action | O |
In a | values:
|
TermMarkLists/MarkInfoList/ MarkInfoRefId | MR | The Id (GUID) that identifies a mark that this class uses for grading. | IdRefType | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This is an object that a LMS or other application will utilize to provide grades about students in a section to a grade book. A grade book is often used to collect various assignment scores or test scores for students in a class or section and then calculate various grades or marks that are printed on report cards. When a LMS is also being used in a LEA, additional information is gathered by the LMS and some of this information needs to be available to the grade book to facilitate calculation of the report card grades or marks (i.e. StudentSectionMarks). This object is available to facilitate communication of the final grade from the LMS to the grade book.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |||||
---|---|---|---|---|---|---|---|---|
StudentGrade | This object contains the final grade for a student in a section. | |||||||
@ | RefId | M | The Id (GUID) that uniquely identifies this object. | RefIdType | ||||
StudentPersonalRefId | M |
The Id (GUID) that uniquely identifies the | IdRefType | |||||
SectionInfoRefId | M |
The Id (GUID) that uniquely identifies the | IdRefType | |||||
SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the school that these values apply to. | IdRefType | |||||
SchoolYear | M |
School year for which this information is applicable, expressed as the four-digit year in which the school year ends (e.g., | SchoolYear | |||||
Grade | M |
This is the one grade given for this student and section. At least one numeric, percentage or letter must be provided as defined in the fields below. If Grade/Numeric is entered, Grade/OutOf , Grade/Low and Grade/High must also be entered.
| ||||||
Grade/Percentage | C | The grade percentage for this grade (0.00-100.00). | xs:decimal
| |||||
Grade/Numeric | C |
The raw numeric value for this grade. If this is provided, the OutOf , Low and High must be entered.
| xs:decimal | |||||
Grade/OutOf | C |
This is the high value equivalent to 100% without extra points or extra credit (e.g. if a student received 3.5 out of 4, 4 would be the Grade/OutOf value and 3.5 would be the Grade/Numeric value).
| xs:decimal | |||||
Grade/Low | C | Lowest grade value in the range for the numeric grade. | xs:decimal | |||||
Grade/High | C |
Highest grade value in the range for the numeric grade. NOTE: This could be higher than the Grade/OutOf value.
| xs:decimal | |||||
Grade/Letter | C | The letter grade value for this grade. If this is provided, the numeric value or percentage value must also be entered in order to provide a numeric value for the grade to be utilized in any computations. | xs:token | |||||
Grade/Narrative | O | The free form text narrative for this grade. | xs:string | |||||
SIF_Metadata | O | SIF_Metadata | ||||||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object provides attendance for a student in the context of a SectionInfo object. This object is used by all agents in a zone that provide period attendance, but don't have the logic to determine whether or not they have sufficient rights to override attendance from another user or system. Agents that represent a system that can validate attendance based on, among other things, its source, should subscribe to StudentPeriodAttendance events to collect "suggested" attendance changes from the zone, and should then publish "accepted" attendance changes as OfficialStudentPeriodAttendance events. A rejected change would result in an event that reverts the system that generated the rejected event back to its previous state or to some other state that represents the correct "official" attendance.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |
---|---|---|---|---|
StudentPeriodAttendance | This object provides attendance for a student in the context of a SectionInfo object. This object is used by all agents in a zone that provide period attendance, but don't have the logic to determine whether or not they have sufficient rights to override attendance from another user or system. Agents that represent a system that can validate attendance based on, among other things, its source, should subscribe to StudentPeriodAttendance events to collect "suggested" attendance changes from the zone, and should then publish "accepted" attendance changes as OfficialStudentPeriodAttendance events. A rejected change would result in an event that reverts the system that generated the rejected event back to its previous state or to some other state that represents the correct "official" attendance. | |||
@ | RefId | M | RefIdType | |
@ | StudentPersonalRefId | M | The GUID of the student that this attendance applies to. | IdRefType |
@ | SectionInfoRefId | M | The GUID of the section that this attendance applies to. | IdRefType |
@ | SchoolInfoRefId | M | The school where the attendance was recorded. Somewhat redundant, needed for requests. | IdRefType |
@ | Date | M | The date of the attendance event. | xs:date |
TimetablePeriod | C | The period within which attendance is being reported, e.g. "4D". Conditional on the SectionInfo object having MeetingTime elements. If one or more are defined for the Section, this element is required. | xs:normalizedString | |
TimeIn | O | The time the student entered or returned to this class. | xs:time | |
TimeOut | O | The time the student left this class. | xs:time | |
AttendanceCode | M | The local attendance code. | xs:token | |
@ | AttendanceCodeInfoRefId | M | IdRefType | |
AuditInfo | M | An audit trail to help determine who entered this attendance event and when. | ||
AuditInfo/CreationUser | M | Information about which staff member created this attendance record. | ||
@ | Type | M | The role of the staff member for that created this attendance record. | values:
|
AuditInfo/CreationUser/UserId | M | Unique identifier of the user that created the attendance record. This will depend on the user and the source. The preferred identifier would be a RefId for a StaffPersonal, StudentContact, or StudentPersonal Object. However, the user may not be associated with any of these SIF objects. In that case a unique Id given by the source should be used. | xs:normalizedString | |
AuditInfo/CreationDateTime | M | The date and time of this attendance record was created. | xs:dateTime | |
AttendanceComment | O | This element contains the comments that are relevant to this attendance record. | xs:string | |
SIF_Metadata | O | SIF_Metadata | ||
SIF_ExtendedElements | O | SIF_ExtendedElements |
This object contains the marks entered for a student in a class section for a specific marking period.
SIF_Events are reported for this object.
Element/@Attribute | Char | Description | Type | |||||||
---|---|---|---|---|---|---|---|---|---|---|
StudentSectionMarks | This object contains the marks entered for a student in a class section for a specific marking period. | |||||||||
@ | RefId | M | A GUID that identifies an instance of this object. This RefId is new for 2.7M and MUST be supported like other objects that have a RefId (i.e. it is the key for the object). The alternate keys MUST continue to be supported. | RefIdType | ||||||
@ | StudentPersonalRefId | M | The Id (GUID) that uniquely identifies the StudentPersonal object that this item refers to. | IdRefType | ||||||
@ | SectionInfoRefId | M | The Id (GUID) that uniquely identifies the SectionInfo object that this item refers to. | IdRefType | ||||||
@ | TermInfoRefId | M | The Id (GUID) that identifies the marking period that the following marks are recorded in. | IdRefType | ||||||
@ | SchoolInfoRefId | M | The Id (GUID) that uniquely identifies the School that these Mark Values apply to. | IdRefType | ||||||
IsFinal | M | Indicates if the grades are "Final" from the perspective of the teacher or school. Does not mean that change events will not occur for this item. | xs:boolean | |||||||
MarkList | M | A list of marks received for this student in this section. For each Mark entry, at least one of the sub-elements must be specified. | List | |||||||
MarkList/Mark | MR | Outer wrapper for marks reported for this section, in this term. | ||||||||
@ | MarkInfoRefId | M | The Id (GUID) that identifies a mark that was given for this student. | IdRefType | ||||||
MarkList/Mark/Percentage | C | The percent score for this mark (0.00 - 100.00). | xs:decimal
| |||||||
MarkList/Mark/Numeric | C | The raw numeric score for this mark. | xs:decimal | |||||||
MarkList/Mark/Letter | C | The letter grade for this mark. | xs:normalizedString | |||||||
MarkList/Mark/Narrative | C | The free form text narrative for this mark. | xs:string | |||||||
SIF_Metadata | O | SIF_Metadata | ||||||||
SIF_ExtendedElements | O | SIF_ExtendedElements |