Education Organization Calendar Interchange - v2.1
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.