This association relates students to their parents, guardians,. or caretakers.
Object Triggering Logic
This table describes logic for triggering syncing of this object.
Action
Trigger
Post
When the Guardian check box is checked on the Relationships tab.
The guardian does NOT have to be a member of the same household as the student to report.
Ed-Fi does not have relationship start or end dates, if a relationship is started anytime within a school year, the record will be added for that year.
Start Date must be blank or on or before school year end date defined in the School Years editor.
End Date must be blank or after school year end date defined in the School Years editor.
Report the person from the related pair that does not have an enrollment for the Parent Reference and the person that has an enrollment as the student reference.
If the student is a guardian of themselves (emancipated) then report the student as both the Parent and the Student.
If both people have a current enrollment, report the person with the higher age as the Parent.
If age cannot be determined, do not report a record.
A record will not send if the student they are associated with has an enrollment in a calendar or school marked as Exclude.
Put
When any field not part of the natural key is changed:
Emergency Contact Status
Parent or Student is removed from the household
Delete
When the Guardian check box is unchecked, relationship is end dated or deleted.
Ed-Fi does not have relationship start or end dates. If a relationship is ended within a school year, the record will be deleted for that year.
End Date must be blank or after school year end date defined in the School Years editor.
Delete
Records will delete when a student has only one Student School Association record for a specific School and Year that record is deleted.
(Note: If a new Student School Association record is created, existing records will not re-post, a resync must be completed to resend the data).
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.
Action
Trigger
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.
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
Trigger
Delete/Post
Natural Key Changes If an Ed-Fi ID changes, a delete/post will occur with the cascading deletes from the Ed-Fi ID Change triggers.
Delete
Cascading Deletes: There are no dependent resources.
Scope Year Logic
This table describes scope year logic of this object.
Business Rules
A parent record will report when the person is the guardian of a student with an enrollment aligned to a scoped year.
The related pair start date must be null or on/before the scope year end date to report.
The related pair end date must be null or on/after the scope year end date to report.
Data will only send for the years that have valid configuration.
A resync must be completed on the resource when a new scope year is connected in order for this data to send.
When using data in Campus that has an effective date, the following logic will be applied to determine the scope year(s) to report the data to.
Current Year: The records start date must be on or before today's date and the records end date must be on or after today's date.
Previous Years: The record's start date must be on or before the school year's end date and the record's end date must be after the school year's end date defined in the School Years editor. If blank, the default date of 6/30/xxxx is used.
Future Years: The record's start date must be on or before the schools year's start date and the record's end date must be on or after the school year's start date defined in the School Years editor. If blank, the default date of 7/01/xxxx is used.
Resource Preferences
This table describes the Resource Preferences of this object.
Data Element Label
Mapping Needed
Relationship
Relation Descriptor
Identity Mapping Object Key
This table describes the Identity Mapping Object Key of this object.
campusObjectType
Object Key Data Source
RelatedPair
personID1-personID2 (personID1 is student, personID2 is parent)
Event Queue Detail
This table describes the Event Queue Detail of this object.
Campus Table
Ed-Fi Action
Fields
relatedPair
Post/Put/Delete
The primary table used for sending data for this resource.
Object Data Elements
This table describes data elements sent within the Student Parent Parent Association resource. 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 Rules
M, C or O
Location
id
The unique identifier of the resource.
M
parentUniqueId
A reference to the related Parent resource.
Reports DistrictID + PersonID.
M
Census > People > Demographics
System Administration > Resources > District Information
person.personID district.Number
studentUniqueId
A reference to the related Student resource.
Reports the reference from the Student record for the student being reported.
M
contactPriority
The numeric order of the preferred sequence or priority of contact.
Does not report, not collected in Campus.
O
contactRestrictions
Restrictions for student and/or teacher contact with the individual (e.g., the student may not be picked up by the individual).
Does not report, not collected in Campus.
O
emergencyContactStatus
Indicator of whether the person is a designated emergency contact for the student.
Reports True if there is a number entered in the Emergency Priority field for the parent being reported.
Otherwise, report False.
O
Census > People > Relationships > Emergency Priority
relatedpair.seq
primaryContactStatus
Indicator of whether the person is a primary parental contact for the student.
Reports True if there is only 1 guardian being reported.
If more than one guardian report the guardian with the earliest start date.
If Start dates are the same or NULL on one or more guardians, report the person with the lowest personID.
Otherwise, report False.
O
Census > People > Relationships > Guardian
relatedpair.guardian
relationDescriptor
The nature of an individual's relationship to a student. For example: Father, Mother, Step-Father, Step-Mother, Foster Father, Foster Mother, Guardian
Reports the Ed-Fi Code from the Ed-Fi Relation Type field that is mapped .
If no mapping, do not report.
O
Census > People > Relationships > Relationship
relatedpair.name
etag
A unique system-generated value that identifies the version of the resource.
