Student School Associations (Tennessee v5.3)

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.

ActionTrigger
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.

  • Do not send records if student has multiple active enrollments in the same School / Calendar.
  • 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 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.

DeleteWhen 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

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.
PutIf 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'.
ResyncIf 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.
ResyncIf 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.
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.

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 DescriptorsEnrollment Start Status
Exit Withdraw Type DescriptorsEnrollment End Status

Identity Mapping Object Key

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

campusObjectType

Object Key Data Source

EnrollmentenrollmentID

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.

personPost/DeleteStudent ID in Student Reference
graduationPutClass of School Year Type Reference
programsPutGraduation Plan Reference
programparticipationPutGraduation Plan Reference

Object Data Elements

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

Data Element LabelBusiness RequirementBusiness RulesM, 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.   
  1. Report the enrollment start date.
MStudent Information> General> Enrollments> Start Dateenrollment.startdate
calendar
Reference
A reference related to the Calendar resource.
  1. Report the Calendar reference for the calendar in which the student is enrolled that is being reported.
ElementFieldLogic
State School Number / State District NumberschoolIdState District Number + State School Number
Instructional Program NumbercalendarCode

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

Else

Populate Instructional Program Number

Format: 2 character left zero padded integer


End YearschoolYearPopulate the End Year of the school year tied to the configured year



classOfSchool
YearReference
A reference to the related to the Class of School YearDoes not report


classOfSchool
YearType
Reference  
 The year the student is expected to graduate. Report the year selected in Student Info > General > Graduation > NCLB Cohort End Year.
  1. If NCLB Cohort End Year = Null, do not report.
C

graduationPlan
Reference
A reference to the related GraduationPlan resource.

Does not report.

O

school
Reference  
 A reference to the related School resource. 
  1. District Number + School Number





schoolYearType
Reference  
The school year in which the student is being reported.
  1. Reports the end year of the calendar.
M

student
Reference  
 A reference to the related Student resource. 
  1. 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. 
  1. 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. 
  1. 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. 
  1. Report the Ed-Fi Code from the Grade Level mapping for the grade selected on the student's enrollment.
  2. If a mapping is not available, the record will error.
MStudent 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. 
  1. 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. 
  1. Report the Ed-Fi Code Value mapped to the Start Status selected.
  2. If blank, do not report.
OStudent Information> General> Enrollments> Start Statusenrollment.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 
  1. Report the enrollment end date.
OStudent Information> General> Enrollments> End Dateenrollment.enddate
 exitWithdrawType
Descriptor 
 A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table. 
  1. Report the Ed-Fi Code Value from the End Status selected.
  2. If blank, do not report.
OStudent Information> General> Enrollments> End Statusenrollment.endstatus
 primarySchool  Indicates if a given enrollment record should be considered the primary record for a student. If omitted, the default is true. 
  1. Report 'True' if Service Type = P: Primary.
  2. Else, report 'False'.
OStudent Information> General> Enrollments> Service Typeenrollment.type
associatedPrimarySchool

The following EIS 041 Student Enrollment definitions apply:

  • Primary District ID - Report the District ID of the student's primary or 'home' school
  • Primary School ID - Report the ID of the school providing service, when not students primary/home school

If Service Type = S: Partial, report District ID + School ID of the most recent enrollment with a Service Type = P: Primary.
  1. Primary enrollment must be in the same school year.

O

studentSchoolAssociation
CharacteristicDescriptors

Optional, does not report.O

studentSchoolAssociation
InstructionalGradeDescriptors

The following EIS 043 Student Instructional Grade definitions apply:

  • Instructional Grade Assignment - Report the instructional grade to which the student is assigned during the instructional service period
  • Instr Grade Assignment Date - Report the date the student was assigned to the instructional grade

See Array Logic below.MStudent Information > General > Enrollments
StudentSchoolAssociation
FundingStatusDescriptor

The following elements of the Funding Status Descriptor are mapped to EIS 042 Student Ineligibility Funding Status:

  • fundingStatusDescriptor
  • fundingStatusBeginDate
  • fundingStatusEndDate

Optional, does not report.O

instructionalServiceDescriptors

This element is mapped to EIS 081 Student TA Instructional Services


Optional, does not report.

O

SupportServiceDescriptors

This element is mapped to EIS 081 Student TA Support Services


Optional, does not report.

O

studentSchoolAssociationStandardDays

The following EIS 047 Student Standard Day definitions apply:

  • Student Standard Day - Report the number of minutes for a full time student of this grade
  • Student Std Day Effective Date - Report the date the student standard day became effective

See Array Logic below.O

submittedforSchoolYearTypeReferenceKey for School Year

Using the End Date tied to the calendar of the student's enrollment, report the year


MSystem Administration > Calendar > Calendar > End Date

schoolYear.endYear

submittedByEducationOrganization
Reference.educationOgranizationID
The identifier assigned to an education organizationPopulate the State District Number + State School Number of the student's enrollmentM

System Administration > Resources > District Info, School


school.number

 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. Optional, does not report.O

 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.

Optional, does not report.

O




 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. 

Optional, does not report

O

etag




Array Data Elements

Data ElementBusiness RequirementBusiness RulesM, C or OData SourceDatabase Field
gradeLevelDescriptor

The following EIS 043 Student Instructional Grade definitions apply:

  • Instructional Grade Assignment - Report the instructional grade to which the student is assigned during the instructional service period

From the state grade table, populate the code associated to the instructional grade.


OStudent Information > General > Enrollments > GradeEnrollment.grade
beginDate

The following EIS 043 Student Instructional Grade definitions apply:

  • Instr Grade Assignment Date - Report the date the student was assigned to the instructional grade

Populate Enrollment Start DateOStudent Information > General > Enrollments > Start DateEnrollment.startDate
endDate
Optional, does not reportO

Standard Days

Data ElementBusiness RequirementBusiness RulesM, C or OData SourceDatabase Field
totalInstructionalMinutes

The following EIS 047 Student Standard Day definitions apply:

  • Student Standard Day - Report the number of minutes for a full time student of this grade

If the student has an enrollment of Service Type equal to P:Primary,

using the calendar of the student's enrollment populate Student Day


ELSE


Do not populate


O
System Administration > Calendar > Calendar > Student Day
Calendar.studentDay
effectiveDate

The following EIS 047 Student Standard Day definitions apply:

  • Student Std Day Effective Date - Report the date the student standard day became effective

Populate the start date of the student's enrollment.


Format must be "CCYYMMDD"



O
Census > People > Enrollment > Start Date
Enrollment.startDate

Type/Descriptor

Click here to expand...

Entry Grade Level Descriptors

Code ValueDescriptionName SpaceShort Description
Adult EducationAdult Educationuri://ed-fi.org/GradeLevelDescriptorAdult Education
Early EducationEarly Educationuri://ed-fi.org/GradeLevelDescriptorEarly Education
Eighth gradeEighth gradeuri://ed-fi.org/GradeLevelDescriptorEighth grade
Eleventh gradeEleventh gradeuri://ed-fi.org/GradeLevelDescriptorEleventh grade
Fifth gradeFifth gradeuri://ed-fi.org/GradeLevelDescriptorFifth grade
First gradeFirst gradeuri://ed-fi.org/GradeLevelDescriptorFirst grade
Fourth gradeFourth gradeuri://ed-fi.org/GradeLevelDescriptorFourth grade
Grade 13Grade 13uri://ed-fi.org/GradeLevelDescriptorGrade 13
Infant/toddlerInfant/toddleruri://ed-fi.org/GradeLevelDescriptorInfant/toddler
KindergartenKindergartenuri://ed-fi.org/GradeLevelDescriptorKindergarten
Ninth gradeNinth gradeuri://ed-fi.org/GradeLevelDescriptorNinth grade
No grade levelNo grade leveluri://ed-fi.org/GradeLevelDescriptorNo grade level
OtherOtheruri://ed-fi.org/GradeLevelDescriptorOther
PostsecondaryPostsecondaryuri://ed-fi.org/GradeLevelDescriptorPostsecondary
Preschool/PrekindergartenPreschool/Prekindergartenuri://ed-fi.org/GradeLevelDescriptorPreschool/Prekindergarten
Second gradeSecond gradeuri://ed-fi.org/GradeLevelDescriptorSecond grade
Seventh gradeSeventh gradeuri://ed-fi.org/GradeLevelDescriptorSeventh grade
Sixth gradeSixth gradeuri://ed-fi.org/GradeLevelDescriptorSixth grade
Tenth gradeTenth gradeuri://ed-fi.org/GradeLevelDescriptorTenth grade
Third gradeThird gradeuri://ed-fi.org/GradeLevelDescriptorThird grade
Twelfth gradeTwelfth gradeuri://ed-fi.org/GradeLevelDescriptorTwelfth grade
UngradedUngradeduri://ed-fi.org/GradeLevelDescriptorUngraded

Entry Type Descriptors

Code ValueDescriptionNamespaceShort Description
TransferTransferuri://ed-fi.org/EntryTypeDescriptorTransfer
New to education systemNew to education systemuri://ed-fi.org/EntryTypeDescriptorNew to education system
Next year schoolNext year schooluri://ed-fi.org/EntryTypeDescriptorNext year school
OtherOtheruri://ed-fi.org/EntryTypeDescriptorOther
Re-entryRe-entryuri://ed-fi.org/EntryTypeDescriptorRe-entry

Exit Withdraw Type Descriptors

Code ValueDescriptionNamespaceShort Description
CompletedCompleteduri://ed-fi.org/ExitWithdrawTypeDescriptorCompleted
Died or is permanently incapacitatedDied or is permanently incapacitateduri://ed-fi.org/ExitWithdrawTypeDescriptorDied or is permanently incapacitated
DropoutDropouturi://ed-fi.org/ExitWithdrawTypeDescriptorDropout
End of school yearEnd of school yearuri://ed-fi.org/ExitWithdrawTypeDescriptorEnd of school year
Enrolled in a high school diploma programEnrolled in a high school diploma programuri://ed-fi.org/ExitWithdrawTypeDescriptorEnrolled in a high school diploma program
ExpelledExpelleduri://ed-fi.org/ExitWithdrawTypeDescriptorExpelled
GraduatedGraduateduri://ed-fi.org/ExitWithdrawTypeDescriptorGraduated
IncarceratedIncarcerateduri://ed-fi.org/ExitWithdrawTypeDescriptorIncarcerated
Invalid enrollmentInvalid enrollmenturi://ed-fi.org/ExitWithdrawTypeDescriptorInvalid enrollment
Involuntarily RemovedInvoluntarily Removeduri://ed-fi.org/ExitWithdrawTypeDescriptorInvoluntarily Removed
No showNo showuri://ed-fi.org/ExitWithdrawTypeDescriptorNo show
OtherOtheruri://ed-fi.org/ExitWithdrawTypeDescriptorOther
Reached maximum ageReached maximum ageuri://ed-fi.org/ExitWithdrawTypeDescriptorReached maximum age
TransferredTransferreduri://ed-fi.org/ExitWithdrawTypeDescriptorTransferred
WithdrawnWithdrawnuri://ed-fi.org/ExitWithdrawTypeDescriptorWithdrawn

Residency Status Descriptors

Code ValueDescriptionNamespaceShort Description
Resident of admin unit and school areaResident of administrative unit and usual school attendance area.uri://ed-fi.org/ResidencyStatusDescriptorResident of administrative unit and usual school attendance area.
Resident of admin unit that crosses statesResident of an administrative unit that crosses state boundaries.uri://ed-fi.org/ResidencyStatusDescriptorResident of an administrative unit that crosses state boundaries.
Resident of admin unit, but other school areaResident of administrative unit, but of other school attendance area.uri://ed-fi.org/ResidencyStatusDescriptorResident of administrative unit, but of other school attendance area.
Resident of another stateResident of another state.uri://ed-fi.org/ResidencyStatusDescriptorResident of another state.
Resident of this state, but not of this admin unitResident of this state, but not of this administrative unit.uri://ed-fi.org/ResidencyStatusDescriptorResident of this state, but not of this administrative unit.