Skip to end of metadata
Go to start of metadata


The Student Gradebook interchange describes student gradebook entries. Gradebook entries are assignments and students’ results on those assignments. The assignments themselves may be linked to learning standards or learning objectives. 

Like all standard Ed-Fi interchanges, this schema references the Ed-Fi Core XSD and can be extended using the Ed-Fi Extensions Framework. See the Ed-Fi Data Standard: Developers' Guide for more information.

Use Cases

The Student Gradebook Interchange can be used to:

  1. Exchange assignments created by teachers and optionally linked to learning standards or learning objectives.

  2. Exchange students’ performance on assignments.

Model Details

The following figure shows a logical view of the Student Gradebook Interchange schema:



The following table describes the primary entities of which the Student Gradebook Interchange is composed. 

SectionReferenceProvides reference information for Section to be used within the gradebook interchange.
GradebookEntryThis entity represents an assignment, homework, or classroom assessment to be recorded in a gradebook.
StudentGradebookEntryThis entity holds a student's grade or competency level for a gradebook entry.
LearningObjectiveThis entity represents identified learning objectives for courses in specific grades.

Extended References

This interchange includes the following Extended References. 

Extended Reference NameDescription
ClassPeriodReferenceRequired. The class period during which the Section meets.
CourseOfferingReferenceRequired. The course offering taught in the Section.
MandatingEducationOrganizationReferenceOptional. Relates the entity mandating the use of the content standard.
GradingPeriodReferenceOptional. Identifies the grading period for the GradebookEntry.
LearningStandardReferenceOptional. LearningStandard associated with the GradebookEntry.
LocationReferenceRequired. The location, typically a classroom, where the Section meets.
SchoolReferenceRequired. Relates the School associated with the AttendanceEvent.
StudentSectionAssociationReferenceRequired. Relates the student and section associated with the GradebookEntry.

Descriptor Dependencies

This interchange references the following Ed-Fi Descriptors, thus requiring them to have been defined using the Descriptors interchange prior to this interchange. For more information on the Ed-Fi Descriptor Pattern, see the Ed-Fi Data Standard - Developers' Guide.

Descriptor NameDescription
AcademicSubjectDescriptorRequired. The description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language).
CompetencyLevelDescriptorOptional. The CompetencyLevel assessed for the student for the referenced LearningObjective.
CountryDescriptorOptional. This descriptor defines the name and code of the country.

Required. The grade level for which the LearningObjective or LearningStandard is targeted.

GradingPeriodDescriptorOptional. The name of the period for which grades are reported, the objective is targeted.
StudentIdentificationSystemDescriptorOptional. A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a student.

The following link is a ZIP archive containing the XSD for the Student Gradebook Interchange v2.0 along with the Ed-Fi Core XSD:

A ZIP archive containing all v2.0 Ed-Fi Standard Interchange Schema can be found in the Download Directory.


  • No labels