Calendar Dates (New Mexico v3.5)

Tool Search: Ed-Fi

This entity represents a set of dates associated with an organization.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

When a Day is created with the Instruction check box checked or a Day Event that is mapped to an Ed-Fi Code is added to a day.

  • Days can be set either manually or by the Day Reset tool.
  • Day Events can be set either manually or by the Multi Day Event Wizard.
  • Do not send a record if the Calendar Exclude checkbox is checked.

  • Do not send a record if the School Exclude checkbox is checked.
  • Do note send a record if Summer School checkbox is checked.
Put

When fields that are not part of the natural key are changed.

DeleteTo delete this resource, all Day Events must be deleted and the Instructional check box needs to be unchecked.

Calendar Events - a put will be completed if there is more than 1 event on a day and 1 is being updated.

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
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.
DeleteIf a resource is toggled to 'OFF" after data has sent and an action is performed that would trigger a delete, that data will remain in the ODS until a resync is done.
ResyncIf a Calendar Event 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 Event 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.

ActionTrigger
Post/Delete

Natural Key change:  If a 2nd schedule structure is added after data is sent, the first Calendar record will need to be Deleted/Posted with new Calendar Code logic to be Calendar ID + Schedule Structure ID.

  • If a calendar or schedule structure is moved via script, all data send to the ODS will remain and the Delete tool will need to be used to remove all data sent.

  • If the Calendar Dates resource is toggled 'OFF" and a natural key change is made to the Calendar, the Calendar Dates record will be deleted.
DeleteCascading Deletes: This resource will delete if a calendar is marked as exclude after dependent data has been sent or a 2nd Schedule Structure is added after 1st Calendar is sent.


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
Calendar Event DescriptorsDay Detail/Event Type


Identity Mapping Object Key

This table describes the Identity Mapping Object Key of this object.

campusObjectTypeObject Key Data Source
DaydayID


Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
day/dayeventPost/Put/DeleteThe primary table used for sending data for this resource.

Object Data Elements

This table describes data elements sent within the Calendars resource.

Data Element LabelBusiness RequirementBusiness RulesM, C or O

Data Source GUI Path

Database Field
idThe unique identifier of the resource.
M

CalendarReference

A reference to the related School resource.

Reports the fields that are part of the Natural Key for the Calendars resource .M

date 

Month, day, and year of the date being reported. 

Reports the Date being reportedMSystem Administration> Calendar> Calendar> Days> Dateday.date
calendarEventsThe type of scheduled or unscheduled event for the day.
  1. Reports the data from the Day or Day Event for the Date being reported.
  2. See Array section below for data logic for each field.

M

Array Data Elements

Click here to expand...

Data Element Label

Business Requirement

Business Rules

M, C or O

Data Source GUI Path

Database Field

Calendar Event Descriptor

The type of scheduled or unscheduled event for the day.

  1. Reports the Ed-Fi Code mapped to 'Instructional Day' if Instruction check box is checked on a day and where school is in session
    • Else, reports the Ed-Fi Code if mapped from the Day Event.
    • Reports only "Instructional Day" or the Extended day descriptors (ELTP, K5p, ELTP+K5P)
    • Else do not report
  2. If Instruction is not checked and there is not a day event mapped to an Ed-Fi Code, do not report a record

Note:  Descriptors include values from both uri://ed-fi.org/CalendarTypeDescriptor and uri://nmped.org/CalendarEventDescriptor

 M

System Administration> Calendar> Calendar> Days> Day Detail> Instruction

OR

System Administration> Calendar> Calendar> Day Event

day.instruction

OR

dayevent.type

Type/Descriptor

Click here to expand...

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

Code Valueshort DescriptionName Space
Emergency dayEmergency dayuri://ed-fi.org/CalendarEventDescriptor
HolidayHolidayuri://ed-fi.org/CalendarEventDescriptor
Instructional dayInstructional dayuri://ed-fi.org/CalendarEventDescriptor
Make-up dayMake-up dayuri://ed-fi.org/CalendarEventDescriptor
OtherOtheruri://ed-fi.org/CalendarEventDescriptor
Student late arrival/early dismissalStudent late arrival/early dismissaluri://ed-fi.org/CalendarEventDescriptor
Weather dayWeather dayuri://ed-fi.org/CalendarEventDescriptor
Teacher only dayTeacher only dayuri://ed-fi.org/CalendarEventDescriptor
StrikeStrikeuri://ed-fi.org/CalendarEventDescriptor
Non-instructional dayNon-instructional dayuri://ed-fi.org/CalendarEventDescriptor
ELTPELTP Day/Hoursuri://nmped.org/CalendarEventDescriptor
K5PK5 Plus Day/Hoursuri://nmped.org/CalendarEventDescriptor
ELTP+K5PBoth ELTP and K5P Dayuri://nmped.org/CalendarEventDescriptor