The following entities are included in the School Calendar domain:
TABLE OF CONTENTS
Entity: Calendar
An asterisk (*) indicates a required element for successful synchronization of the entity. This documentation outlines the supported mappings for various data entities, identifying the supported fields within Aeries for each entity and noting any unsupported elements. Additionally, it provides a sample JSON payload demonstrating the structure.
| Ed-Fi Data Element | Aeries Page | Label & Aeries Table.Field | Standard v3.c/v4.x | Standard v5.x |
| Entity Reference - See Education Organization Domain > School Entity | - | - | ✔ Supported | ✔ Supported |
| CalendarCode / String | School Options | Code LOC.CD | ✔ Supported | ✔ Supported |
| - Uses the School Code + CAL | - | - | ||
SchoolYear | - | - | ✔ Supported | ✔ Supported |
| - Uses the current school year using the Day Table- | - | - | ||
CalendarTypeDescriptor | - | - | ✔ Supported | ✔ Supported |
| - Hard-coded to 'School' | - | - | ||
| GradeLevelDescriptor | Not supported at this time. Calendars are not associated with grade levels. | ✘ Not Supported | ✘ Not Supported | |
| Special Notes: -School must have a Calendar; information in these fields is populated by adding a "School Calendar" and adding any school holidays. -System will send a single "Calendar" for each school enabled to sync. | ||||
| Sample of JSON Payload | ||||
{ "calendarCode": "700CAL", "schoolReference": { "schoolId": 700 }, "schoolYearTypeReference": { "schoolYear": 2025 }, "calendarTypeDescriptor": "uri://ed-fi.org/CalendarTypeDescriptor#School" } |
Entity: Calendar Date
| Ed-Fi Data Element | Aeries Page | Label & Aeries Table.Field | Standard v3.x/v4.x | Standard v5.x |
| Entity Reference - See Education Organization Domain > School Entity | - | - | ✔ Supported | ✔ Supported |
| Entity Reference - See School Calendar Domain > Calendar Entity | - | - | ✔ Supported | ✔ Supported |
| Date | Calendar | DAY.DT | ✔ Supported | ✔ Supported |
| CalendarEventDescriptor | Calendar | DAY.HO | ✔ Supported | ✔ Supported |
-$ Staff Development Day = '#Teacher Only Day' -%Minimum Day = '#Student Late arrival/early dismissal -# School Holiday = '#Holiday' -Any Day without an event = '#Instructional Day' -+ Parent Conference = '#Other' | - | - | ||
| Special Notes: -School must have a Calendar, information in these fields are populated by adding a "School Calendar" and adding any school holidays. -System will send a record for every day in the "School Calendar" | ||||
| Sample JSON Payload | ||||
{ "calendarEvents": [ { "calendarEventDescriptor": "uri://ed-fi.org/CalendarEventDescriptor#Instructional day" } ], "date": "2024-10-11", "calendarReference": { "calendarCode": "700CAL", "schoolId": 700, "schoolYear": 2025 } } | ||||
Entity: Grading Period
| Ed-Fi Data Element | Aeries Page | Label & Aeries Table.Field | Standard v3.x/v4.x | Standard v5.x |
Entity Reference - See Education Organization Domain > School Entity | - | - | ✔ Supported | ✔ Supported |
| GradingPeriodDescriptor | Multiple Mark Headings & Descriptions | State Code GRP.C1-C12 | ✔ Supported | ✔ Supported |
| Ed-Fi Mapping | Code Set Gradeing Period Descriptor (GRP.C1) | ✔ Supported | ✔ Supported | |
| PeriodSequence / Number | - | - | ✔ Supported | ✔ Supported |
| SEQ 1-12 | - | - | ||
| SchoolYear | - | - | ✔ Supported | ✔ Supported |
| Based on GRP Begin Date | - | - | ||
| BeginDate | Multiple Mark Headings and Descriptions | GRP.B1-B12 | ✔ Supported | ✔ Supported |
| EndDate | GRP.E1-E12 | ✔ Supported | ✔ Supported | |
TotalInstructionalDays / Number | - | - | ||
| Uses Begin & End Date to calculate the Total InstructionalDays | ✔ Supported | ✔ Supported | ||
| Special Notes: -These dates must exactly match what is in the "Terms" Table/Page | ||||
| Sample JSON Payload | ||||
{ "gradingPeriodDescriptor": "uri://ed-fi.org/GradingPeriodDescriptor#First Semester", "periodSequence": 5, "schoolReference": { "schoolId": 700 }, "schoolYearTypeReference": { "schoolYear": 2025 }, "beginDate": "2024-07-15", "endDate": "2024-12-13", "totalInstructionalDays": 108 } | ||||
Entity: Session
| Ed-Fi Data Element | Aeries Page | Label & Aeries Table.Field | Standard v3.x/v4.x | Standard v5.x |
| Entity Reference - See Education Organization Domain > School Entity | - | - | ✔ Supported | ✔ Supported |
| Entity Reference - See School Calendar Domain > Grading Period Entity | - | - | ✔ Supported | ✔ Supported |
| SchoolYear | - | - | ✔ Supported | ✔ Supported |
| - Uses the information in the Terms Table to establish the proper School Year | - | - | ||
SessionName / String | - | - | ✔ Supported | ✔ Supported |
| School Year + TermDescriptor | - | - | ||
| AcademicWeek | - | - | ✘ Not Supported | ✘ Not Supported |
| BeginDate | Terms | Start Date TRM.D1 | ✔ Supported | ✔ Supported |
| EndDate | End Date TRM.D2 | ✔ Supported | ✔ Supported | |
| TermDescriptor | Ed-Fi Mappings | Code Set Term Descriptor (TDF.ST0) | ✔ Supported | ✔ Supported |
| TotalInstructionalDays / Number | - | - | ✔ Supported | ✔ Supported |
| Based on TRM.D1 and TRM.D2 | - | - | ||
| Special Notes: | ||||
| Sample JSON Payload | ||||
{ "sessionName": "2025 First Quarter", "schoolReference": { "schoolId": 700 }, "schoolYearTypeReference": { "schoolYear": 2025 }, "beginDate": "2024-07-15", "endDate": "2024-10-04", "gradingPeriods": [ { "gradingPeriodReference": { "gradingPeriodDescriptor": "uri://ed-fi.org/GradingPeriodDescriptor#First Nine Weeks", "periodSequence": 1, "schoolId": 700, "schoolYear": 2025 } } ], "termDescriptor": "uri://ed-fi.org/TermDescriptor#First Quarter", "totalInstructionalDays": 58 } | ||||