Student School Association (Core v3.X)

Tool Search: Ed-Fi

This association represents the school in which a student is enrolled.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

Action	Trigger
Post	When a new enrollment is saved for a student. A record will report for each distinct enrollment in a School and Enrollment Start Date. When a student has two enrollments in the same School, Calendar & Schedule Structure with the same start date, report from the enrollment service type in the following order: P: Primary Enrollment S: Partial/Ancillary N: Special Ed Services When a student has two Primary enrollments in the same school with the same start date, post the record with the highest enrollment ID. When an enrollment with a higher priority is deleted, the enrollment with lower priority will post a new record. Do not send records if the Calendar Exclude check box is checked in the calendar the student is enrolled. Do not send records if the School Exclude check box is checked in the calendar the student is enrolled. Do not send a record if the No Show check box is checked.
Post	When the start date for an enrollment is changed. When an enrollment with a lower priority is changed, data will not send.
Put	When an enrollment is updated for a student. When a change is made to the Graduation > NCLB Cohort End Year field. When a student is assigned to a Graduation or CTE Program or the start and/or end dates are modified. When a student's start status is changed. When a student's end status is changed. When a student's grade level is changed. When a student's End Action is changed. When a student's School Choice checkbox is checked or unchecked. When a student's Resident District or Service District fields are changed. When a students Service Type is changed. When the Calendar reference is changed due to a Natural Key update on the Calendars resource.
Delete	When an enrollment is deleted. When a student has two enrollments in the same school for the same start date, records with lower priority will not trigger a delete.
Delete	When the start date of an enrollment is changed.
Delete	When the No Show check box is checked.

Resource Toggle and Resync Logic

This table describes the Resource Toggle and Trigger logic of this object.

Action	Business Rule
None	If a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
Put	If the natural key of the Calendar Reference is changed, a put will be done to update the Calendar Reference even if the Student School Association resource is turned 'OFF'.
Resync	If a 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.
Resync	If a 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.
Resync	If 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.

Action	Business Rule
Post/Delete	Natural Key changes: If the School Number/Ed-Fi School Number changes, a delete/post will occur with the cascading deletes from the School ID Change triggers. If an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger. If the enrollment start date changes, all dependent resources will be deleted and reposted. If a dependent resource is turned off, all dependent resources will be deleted and not reposted.
Delete	Cascading Deletes: If the Student School Association is deleted, all dependent resources will be deleted. Student Parent Associations, Student Education Organization Associations, Student Section Associations, Graduation Plans, Student Program Associations, Student CTE Program Associations, Student Special Education Program Associations, Student Title 1 Part A Program Associations, Student Academic Records, Course Transcripts, Grades, Student Discipline Incident Associations, Discipline Actions, Student Cohort Associations, Student School Attendance Events, Student Section Attendance Events

Action

Business Rule

Post/Delete

Natural Key changes:

If the School Number/Ed-Fi School Number changes, a delete/post will occur with the cascading deletes from the School ID Change triggers.
If an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger.
If the enrollment start date changes, all dependent resources will be deleted and reposted. If a dependent resource is turned off, all dependent resources will be deleted and not reposted.

Delete

Cascading Deletes: If the Student School Association is deleted, all dependent resources will be deleted.

Student Parent Associations, Student Education Organization Associations, Student Section Associations, Graduation Plans, Student Program Associations, Student CTE Program Associations, Student Special Education Program Associations, Student Title 1 Part A Program Associations, Student Academic Records, Course Transcripts, Grades, Student Discipline Incident Associations, Discipline Actions, Student Cohort Associations, Student School Attendance Events, Student Section Attendance Events

Scope Year Logic

This table describes scope year logic of this object.

Logic
The record will send to the scope year for the school year the enrollment is associated with.
Data will only send for the years that have valid configuration.

Resource Preferences

This table describes the Resource Preferences of this object.

Data Element Label	Mapping Needed
Entry Type Descriptors	Enrollment Start Status
Exit Withdraw Type Descriptors	Enrollment End Status

Identity Mapping Object Key

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

campusObjectType	Object Key Data Source
Enrollment	enrollmentID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus Table	Ed-Fi Action	Fields
enrollment	Post/Put/Delete	The primary table used for sending data for this resource.
person	Post/Delete	Student ID in Student Reference
graduation	Put	Class of School Year Type Reference
programs	Put	Graduation Plan Reference
programparticipation	Put	Graduation Plan Reference

Object Data Elements

This table describes data elements sent within the Student School Association resource.

Data Element Label	Business Requirement	Business Rules	M, C or O	Data Source GUI Path	Database Field
id	The unique identifier of the resource.		M
entryDate	The month, day, and year on which an individual enters and begins to receive instructional services in a campus.	Report the enrollment start date.	M	Student Information> General> Enrollments> Start Date	enrollment.startdate
calendar Reference	A reference related to the Calendar resource.	Report the Calendar reference for the calendar in which the student is enrolled that is being reported.	O
classOfSchool YearType Reference	The year the student is expected to graduate.	Report the year selected in Student Info > General > Graduation > NCLB Cohort End Year. If NCLB Cohort End Year = Null, do not report.	C
graduationPlan Reference	A reference to the related GraduationPlan resource.	Report the associated Graduation Plan when a student is assigned to a Graduation Program or Career Tech Program that is eligible to report to Ed-Fi. The Program Participation record must overlap the enrollment(s) that are aligned to the Student School Association record(s) being reported. Report the Graduation Plan School year that is aligned to the student's NCLB Cohort End Year. If the student does not have a NCLB Cohort End Year, do not report a record. If the student has both a CTE & Graduation Plan, report the Graduation Plan. If the student has more than 1 Graduation Plan, report the plan with the most recent start date.	O
school Reference	A reference to the related School resource.	Reports the fields that are part of the Natural Key for the School resource.	M
schoolYearType Reference	The school year in which the student is being reported.	Reports the end year of the calendar.	O
student Reference	A reference to the related Student resource.	Report the reference for the student being reported.	M
educationPlans	An unordered collection of student School Association Education Plans. This association represents the school in which a student is enrolled.	This is optional, does not report.	O
employedWhile Enrolled	An individual who is a paid employee or works in his or her own business, profession, or farm and at the same time is enrolled in secondary, postsecondary, or adult education.	This is optional, does not report.	O
entryGradeLevel Descriptor	The grade level or primary instructional level at which a student enters and receives services in a school or an educational institution during a given academic session.	Report the Ed-Fi Code from the Grade Level mapping for the grade selected on the student's enrollment. If a mapping is not available, the record will error.	M	Student Information> General> Enrollments> Grade
entryGradeLevel ReasonDescriptor	A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table.	This is optional, does not report.	O
entryType Descriptor	A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table.	Report the Ed-Fi Code Value mapped to the Start Status selected. If blank, do not report.	O	Student Information> General> Enrollments> Start Status	enrollment.startstatus
exitWithdraw Date	The month, day, and year of the first day after the date of an individual''s last attendance at a campus (if known), the day on which an individual graduated, or the date on which it becomes known officially that an individual left school. NEDM: Exit/Withdraw Date	Report the enrollment end date.	O	Student Information> General> Enrollments> End Date	enrollment.enddate
exitWithdrawType Descriptor	A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table.	Report the Ed-Fi Code Value from the End Status selected. If blank, do not report.	O	Student Information> General> Enrollments> End Status	enrollment.endstatus
primarySchool	Indicates if a given enrollment record should be considered the primary record for a student. If omitted, the default is true.	Report 'True' if Service Type = P: Primary. Else, report 'False'.	O	Student Information> General> Enrollments> Service Type	enrollment.type
repeatGrade Indicator	An indicator of whether the student is enrolling to repeat a grade level, either by failure or an agreement to hold the student back.	Look at the student's last enrollment record prior to the enrollment that is reporting and report the following: Report 'True' of End Action is = R: Retain. Report 'False' if the End Action = P: Promote, D: Detain or NULL. The prior enrollments start date must be before the reporting enrollment's start date.	O	Student Information> General> Enrollments> End Action	enrollment. endAction
residencyStatus Descriptor	An indication of the location of a persons legal residence relative to (within or outside of) the boundaries of the public school attended and its administrative unit.	Report 'Resident of admin unit and school area' if the Resident and Serving District fields are either NULL or = to the reporting district. This can be any combination of NULL or populated (ex. Serving District can be NULL and Resident District = to reporting District). Report 'Resident of admin unit, but other school area' when the Serving District is not = to Reporting District. The Resident District must be NULL or = to the reporting district to report. If not, then report blank. Report 'Resident of this state, but not of this admin unit' when the Resident District is not = Reporting District. The Serving District must be NULL or = to the reporting district to report. If not, then report blank.		Student Information> General> Enrollments>	enrollment.residentdistrict and/or enrollment.servingdistrict
schoolChoice Transfer	An indication of whether students transferred in or out of the school did so during the school year under the provisions for public school choice in accordance with Title I, Part A, Section 1116.	Reports 'True' when the checkbox is checked. Reports 'False' when the checkbox is not checked.	O	Student Information> General> Enrollments> School Choice	enrollment. schoolChoiceProgram
etag

Type/Descriptor

Click here to expand...

Entry Grade Level Descriptors

Code Value	Description	Name Space	Short Description
Adult Education	Adult Education	uri://ed-fi.org/GradeLevelDescriptor	Adult Education
Early Education	Early Education	uri://ed-fi.org/GradeLevelDescriptor	Early Education
Eighth grade	Eighth grade	uri://ed-fi.org/GradeLevelDescriptor	Eighth grade
Eleventh grade	Eleventh grade	uri://ed-fi.org/GradeLevelDescriptor	Eleventh grade
Fifth grade	Fifth grade	uri://ed-fi.org/GradeLevelDescriptor	Fifth grade
First grade	First grade	uri://ed-fi.org/GradeLevelDescriptor	First grade
Fourth grade	Fourth grade	uri://ed-fi.org/GradeLevelDescriptor	Fourth grade
Grade 13	Grade 13	uri://ed-fi.org/GradeLevelDescriptor	Grade 13
Infant/toddler	Infant/toddler	uri://ed-fi.org/GradeLevelDescriptor	Infant/toddler
Kindergarten	Kindergarten	uri://ed-fi.org/GradeLevelDescriptor	Kindergarten
Ninth grade	Ninth grade	uri://ed-fi.org/GradeLevelDescriptor	Ninth grade
No grade level	No grade level	uri://ed-fi.org/GradeLevelDescriptor	No grade level
Other	Other	uri://ed-fi.org/GradeLevelDescriptor	Other
Postsecondary	Postsecondary	uri://ed-fi.org/GradeLevelDescriptor	Postsecondary
Preschool/Prekindergarten	Preschool/Prekindergarten	uri://ed-fi.org/GradeLevelDescriptor	Preschool/Prekindergarten
Second grade	Second grade	uri://ed-fi.org/GradeLevelDescriptor	Second grade
Seventh grade	Seventh grade	uri://ed-fi.org/GradeLevelDescriptor	Seventh grade
Sixth grade	Sixth grade	uri://ed-fi.org/GradeLevelDescriptor	Sixth grade
Tenth grade	Tenth grade	uri://ed-fi.org/GradeLevelDescriptor	Tenth grade
Third grade	Third grade	uri://ed-fi.org/GradeLevelDescriptor	Third grade
Twelfth grade	Twelfth grade	uri://ed-fi.org/GradeLevelDescriptor	Twelfth grade
Ungraded	Ungraded	uri://ed-fi.org/GradeLevelDescriptor	Ungraded

Entry Type Descriptors

Code Value	Description	Namespace	Short Description
Transfer	Transfer	uri://ed-fi.org/EntryTypeDescriptor	Transfer
New to education system	New to education system	uri://ed-fi.org/EntryTypeDescriptor	New to education system
Next year school	Next year school	uri://ed-fi.org/EntryTypeDescriptor	Next year school
Other	Other	uri://ed-fi.org/EntryTypeDescriptor	Other
Re-entry	Re-entry	uri://ed-fi.org/EntryTypeDescriptor	Re-entry

Exit Withdraw Type Descriptors

Code Value	Description	Namespace	Short Description
Completed	Completed	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Completed
Died or is permanently incapacitated	Died or is permanently incapacitated	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Died or is permanently incapacitated
Dropout	Dropout	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Dropout
End of school year	End of school year	uri://ed-fi.org/ExitWithdrawTypeDescriptor	End of school year
Enrolled in a high school diploma program	Enrolled in a high school diploma program	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Enrolled in a high school diploma program
Expelled	Expelled	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Expelled
Graduated	Graduated	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Graduated
Incarcerated	Incarcerated	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Incarcerated
Invalid enrollment	Invalid enrollment	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Invalid enrollment
Involuntarily Removed	Involuntarily Removed	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Involuntarily Removed
No show	No show	uri://ed-fi.org/ExitWithdrawTypeDescriptor	No show
Other	Other	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Other
Reached maximum age	Reached maximum age	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Reached maximum age
Transferred	Transferred	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Transferred
Withdrawn	Withdrawn	uri://ed-fi.org/ExitWithdrawTypeDescriptor	Withdrawn

Residency Status Descriptors

Code Value	Description	Namespace	Short Description
Resident of admin unit and school area	Resident of administrative unit and usual school attendance area.	uri://ed-fi.org/ResidencyStatusDescriptor	Resident of administrative unit and usual school attendance area.
Resident of admin unit that crosses states	Resident of an administrative unit that crosses state boundaries.	uri://ed-fi.org/ResidencyStatusDescriptor	Resident of an administrative unit that crosses state boundaries.
Resident of admin unit, but other school area	Resident of administrative unit, but of other school attendance area.	uri://ed-fi.org/ResidencyStatusDescriptor	Resident of administrative unit, but of other school attendance area.
Resident of another state	Resident of another state.	uri://ed-fi.org/ResidencyStatusDescriptor	Resident of another state.
Resident of this state, but not of this admin unit	Resident of this state, but not of this administrative unit.	uri://ed-fi.org/ResidencyStatusDescriptor	Resident of this state, but not of this administrative unit.