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 | CEDS Id/URL | 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 | DocumentSourceType | ||
LearningStandardItemList | O | References to LearningStandardItems or LearningStandardDocuments directly. | LearningStandardItemListType | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
This object provides score information about a particular assignment.
SIF_Events are reported for this object.
Element/@Attribute | Char | CEDS Id/URL | 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, ScorePointsFloat, ScorePercent, ScoreLetter or ScoreEmptyReason be present. | xs:unsignedInt | ||
ScorePointsFloat | C | The score represented as points and partial points. Conditionally required that one or more of ScorePoints, ScorePointsFloat, ScorePercent, ScoreLetter or ScoreEmptyReason be present. | xs:float | ||
ScorePercent | C | The score represented as a percent. Conditionally required that one or more of ScorePoints, ScorePointsFloat, ScorePercent, ScoreLetter or ScoreEmptyReason be present. | xs:decimal | ||
ScoreLetter | C | The score represented as a letter grade. Conditionally required that one or more of ScorePoints, ScorePointsFloat, ScorePercent, ScoreLetter or ScoreEmptyReason be present. | xs:string | ||
ScoreEmptyReason | C | 000934 https://ceds.ed.gov/element/000934 | Code that represents why the assignment is not scored using any of the other methods. Conditionally required that one or more of ScorePoints, ScorePointsFloat, ScorePercent, ScoreLetter or ScoreEmptyReason be present. | xs:token | |
ScoreDescription | O | Text description of the score. | xs:string | ||
LearningStandardItemList | O | References to LearningStandardItems or LearningStandardDocuments directly. | LearningStandardItemListType | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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. | SchoolYearType | ||
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_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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. | SchoolYearType | ||
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). | MarkValuePercentageType | ||
Numeric | M | Indicates whether a raw numeric score is accepted. | MarkValueNumberType | ||
Letter | M | Indicates whether a letter Mark is accepted. | MarkValueLetterType | ||
Narrative | M | If present, indicates that a free-form text narrative is accepted. | MarkValueNarrativeType | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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. | Extension of 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 | CEDS Id/URL | 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 | TermMarkListsType | |||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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., | SchoolYearType | ||
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.
| StudentGradeGradeType | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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. | AttendanceCodeType | ||
AuditInfo | M | An audit trail to help determine who entered this attendance event and when. | StudentAttendanceAuditInfoType | ||
AttendanceComment | O | This element contains the comments that are relevant to this attendance record. | xs:string | ||
InstructionalDeliveryMode | O | How instruction was delivered. | InstructionalDeliveryModeType | ||
ExpectationsMet | O | If true, he student met the expectations required by the organization marking attendance to be considered fully present. | xs:boolean | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |
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 | CEDS Id/URL | 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. | StudentSectionMarkListType | ||
SIF_Metadata | O | SIF_MetadataType | |||
SIF_ExtendedElements | O | SIF_ExtendedElementsType |