Tennessee Ed-Fi Data v3.1 - Calendars

Classic View: System Administration > Ed-Fi

Search Terms: Ed-Fi

The Local Education Agency Calendar resources reports District Calendar information.

Object Triggering

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

A Calendars record will be created for each Calendar where:

  • Type = D: District
  • Number >= 1
When a new Calendar is created and saved via the Calendar Wizard.
Do not send a record if the Calendars resource is toggled 'OFF' in the Calendars Resource Preferences.
PutWhen fields that are not part of the natural key are changed:
  • calendar Type
  • calendar Number
  • Student Day (instructional minutes)
  • Teacher Day (minutes)
When the Instruction checkbox is modified the instructionalDays and calendarFundingPeriod need to be recalculated.

When the following day event types have been ADDED OR REMOVED from the calendar, instructionalDays must be re-calculated and the calendarFundingPeriod array must be recalculated

  • SI: Stockpile Inclement Weather
  • SP: Stockpile Professional Development
  • CS: Calendar Start
  • CE: Calendar End
Delete/Post

If any fields part of the natural key are changed:

  • Instructional Program Number
  • School Number
  • calendarTypeDescriptor
  • _ext.tdoe.submittedForSchoolYearTypeReference.SchoolYear
  • _ext.tdoe.submittedByEducationOrganizationReference.educationOgranizationID

School Exclude, Calendar Exclude, Resource Toggle and Resync Logic

This table describes the School Exclude, Calendar Exclude, Resource Toggle and Resync logic of this object.

ActionTrigger
NoneNo data will send if the School or Calendar is marked as Exclude.
DeleteIf the Calendar is marked as exclude after the Calendar or any dependent data is sent, the calendar and all dependent data will delete upon a resync even if the resource is toggled 'OFF'.
NoneIf a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
ResyncIf a Calendar record is in the Ed-Fi Identity Mapping table and not in the ODS, it will be deleted from the Ed-Fi Identity Mapping table.
ResyncIf a Calendar record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it will be deleted from the ODS.
ResyncIf a mapping is changed in Resource Preferences, a resync will need to be done to reflect the changes.


Natural Key Changes, Cascading Updates, and Deletes Logic

This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.

ActionBusiness Rule
PostShould a calendar that previously excluded become reportable, all Calendar Dates tied to the calendar should also report. See the Calendar Date Resource.
DeleteShould a calendar that previously reported become excluded, all Calendar Dates tied to the formerly reported calendar should also be deleted. See the Calendar Dates Resource.


Scope Year Logic

This table describes scope year logic of this object.

Logic

Calendar Dates will only send for the school year to which they are aligned.

  • Data will only send for years that have valid configuration.


Resource Preferences

This table describes the Resource Preferences of this object.

Data Element LabelMapping Needed
calendarTypeDescriptorcalendar.type


Object Data Elements

Data Element Labels in bold are part of the Natural Key and are required data elements for Data to send to Ed-Fi.

Data Element Label Business Requirement Business RulesM, C or O

Data Source GUI Path

Database Field
Calendar Code

The Instructional Program Number: Reports the number to uniquely identify the instructional program with the school.

If Instructional Program Number equals null or blank, populate “99”.


Otherwise,

populate Instructional Program Number

M

System Administration > Calendar > Calendar > Instructional Program Number

customCalendar.value

schoolReference

Reports the following:

  • District ID - Reports the TN Department of Education assigned District Number.
  • School ID - Report the TN Department of Education assigned School Number


District Number + School Number

M

System Administration > Resources > District Information > State District Number


System Administration > Resources > School > State School Number

District.number

School.number

SchoolYearType

Reference


The School Year tied to the configured year.

Populate the End Year of the school year tied to the configured year.

M

System Administration > Ed-Fi > Ed-Fi Configuration > Connection > School Year

System Administration > Calendar > School Years > End Year

SchoolYear.endYear
calendarType
Descriptor

Indicates the type of Instructional Calendar.


Current Calendar Year is defined as the start year of the school year tied to the calendar.


Identifies the calendar date of the first occurrence of Day Event Type "AS". If the date is scheduled BEFORE August 1st of the current calendar year, populate "Yearlong".


Otherwise, populate "Traditional".

MN/AN/A
gradeLevels

Indicates the grade level associated with the Calendar


Optional, does not report.ON/AN/A
_ext.tdoe.localEducation
AgencyCalendar
Reference
A reference to the related Local Education Agency Calendar (District Calendar) resource.

Reports the calendar Number.

MSystem Administration > Calendar > Number
_ext.tdoe.stockpile
ProfessionalDevDays

The number of days a school has designated as stockpile professional days when the LocalEducationAgency calendar does not declare stockpiling.

For the calendar, sum the Day Event duration of all day events of type "SP".


If the sum does not equal a number that can be divided evenly by 100, report blank.


Otherwise, report the quotient.

MSystem Administration > Calendar > Calendar > Days > Type
_ext.tdoe.instructional
Days

The number of days for classroom instruction.


Sum of the total amount of Days marked Instruction for a total.


Identifies the days with the following day event types and updates the total by 1 if the day is NOT marked instruction:

  • SI (Stockpile Inclement Weather)
  • SP (Stockpile Professional Development Days)
M

System Administration > Calendar > Calendar > Days > Instruction


System Administration > Calendar > Calendar > Days > Type


_ext.tdoe.student
Day

The number of minutes in a standard full time day for a student, including lunch.

For the calendar, populate the value in Student Day.

MSystem Administration > Calendar > Calendar > Student DayCalendar.studentDay
_ext.tdoe.teacher
Day

The number of minutes in a standard full time day for a teacher, including lunch.

For the calendar, populate the value in Teacher Day.

MSystem Administration > Calendar > Calendar > Teacher DayCalendar.teacherDay
_ext.tdoe.usesBlock
ScheduleIndicator

Indicates if this school calendar is using block scheduling.

Populate "false".M

_ext.tdoe.springBlock
BeginDate

If this calendar uses block scheduling, the first date of the spring block.

Optional, does not report.
O

_ext.tdoe.calendar
FundingPeriod

The begin and end dates of each funding period associated with this calendar.

See array logic below.

MSystem Administration > Calendar > Calendar > Days > Instructioncalculated
_ext.tdoe.submittedFor
SchoolYearTypeReference
.SchoolYear
Key for the School Year.

Using the End Date tied to the calendar, reports the year.


MSystem Administration > Calendar > Calendar > End DateschoolYear.endYear
_ext.tdoe.submittedBy
EducationOrganization
Reference.education
OgranizationID
The identifier assigned to an education organization.

State District Number + State School Number


M

System Administration > Resources > School


Sys admin > resources > district info

school.number


Arrays

Grade Levels

Data Element Label

Business Requirement

Business Rules

M, C or O

Localized Logic

Data Source GUI Path

Database Field

gradeLevelDescriptor

Indicates the GradeLevel associated with the Calendar.

  1. Report all unique Grade Levels for the Calendar/Schedule Structure that are mapped to an Ed-Fi Grade Level:
    1. Do not report if the Grade Level is in a Calendar marked as Exclude.
  2. If a grade level is not mapped, do not report.
 MMN

System Administration> Calendar> Calendar> Grade Grade Levels

gradelevel.name

Type/Descriptor

This table describes the Ed-Fi Value mapped and reported for Calendar Type Descriptor:

Code ValueDescriptionNamespace
Short Description
Student SpecificStudent Specificuri://ed-fi.org/CalendarTypeDescriptor
Student Specific
IEPIEPuri://ed-fi.org/CalendarTypeDescriptor
IEP