Education Organization Calendar Interchange - v2.1
- Ian Christopher
- Becky McKnight
The Education Organization Calendar interchange carries school calendar information. It can be used to exchange school calendar data, including instructional days, sessions, and grading periods.
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 XML Design & Implementation Guidelines for more information.
Use Cases
The Education Organization Calendar Interchange can be used to:
- Exchange dates indicating which days are instructional days, holidays, or teacher-only days.
- Exchange session start dates and end dates.
- Exchange grading period definitions.
Model Details
The following figure shows a logical view of the Education Organization Calendar Interchange schema:
Entities
The following table describes the primary entities of which the Education Organization Calendar Interchange is composed.
Name | Description |
---|---|
Session | A term in the school year, generally a unit of time into which courses are scheduled, instruction occurs and by which credits are awarded. Sessions may be interrupted by vacations or other events. |
GradingPeriod | This entity represents the time span for which grades are reported. |
Calendar | A set of dates associated with an organization. |
CalendarDate | The type of scheduled or unscheduled event for the day. |
AcademicWeek | This entity represents the academic weeks for a school year, optionally captured to support analyses. |
Extended References
This interchange includes the following Extended References.
Extended Reference Name | Description |
---|---|
SchoolReference (in AcademicWeek) | Required. Relates the academic week to an existing School. |
SchoolReference (in Calendar) | Required. Reference to the School associated with the Calendar. |
SchoolReference (in GradingPeriod) | Required. Provide user information to lookup and link to an existing school record. |
SchoolReference (in Session) | Required. Relates the Session to the school. |
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 XML Schema - Enumerations and Descriptors.
Descriptor Name | Description |
---|---|
CalendarEventDescriptor | Required. This descriptor holds the types of scheduled or unscheduled event for the day (e.g., Instructional day, Teacher only day, Holiday, Make-up day, Weather day, Student late arrival/early dismissal day). |
CalendarTypeDescriptor | Required. This descriptor defines the calendar types. |
GradeLevelDescriptor | Optional. This descriptor defines the set of grade levels. The map to known Ed-Fi enumeration values is required. |
GradingPeriodDescriptor | Required. This descriptor defines the name of the period for which grades are reported. The mapping of descriptor values to known Ed-Fi enumeration values is required. |
TermDescriptor | Required. This descriptor defines the term of a session during the school year (e.g., Fall Semester). |
The following link is a ZIP archive containing the XSD for the Education Organization Calendar Interchange v2.1 along with the Ed-Fi Core XSD and a Sample XML Data File:
Interchange-EducationOrgCalendar-Bundle.zip
A ZIP archive containing all v2.1 Ed-Fi Standard Interchange Schema can be found in the Download Directory.