Tool Search: Ed-Fi
This association relates students to their parents, guardians, or caretakers.
Object Triggering Logic
| Action | Trigger |
|---|---|
| Post | When the Guardian checkbox is marked on the Relationships tab.
|
| Put | When any field not part of the natural key is changed:
|
| Delete | When the Guardian checkbox is not marked, the relationship is end dated or deleted.
|
| Delete | Records are deleted 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 do not re-post. A resync must be completed to resend the data). |
School Exclude, Calendar Exclude, Resource Toggle and Resync Logic
| Action | Trigger |
|---|---|
| None | If a resource is toggled to 'OFF' after data has sent, all sent data remains in the ODS but no new data sends. |
| Resync | If a record is in the Ed-Fi Identity Mapping table and not in the ODS, it is 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 is deleted from the ODS. |
| Resync | If a mapping is changed in Resource Preferences, a resync needs to be done to reflect the changes. |
Natural Key Changes, Cascading Updates, and Deletes Logic
| Action | Trigger |
|---|---|
| Delete/Post | Cascading Deletes: The logic for an Ed-FI ID change updates all resources impacted by this change. |
Scope Year Logic
| Business Rules |
|---|
A parent record reports when they are a guardian to a student with an enrollment aligned to a scoped year.
|
When using data in Campus that has an effective date, the following logic is applied to determine the scope year(s) to which to report the data.
|
Resource Preferences
Data Element Label | Mapping Needed |
|---|---|
| Relationship | Relation Descriptor |
Identity Mapping Object Key
| campusObjectType | Object Key Data Source |
|---|---|
| RelatedPair | personID1-personID2 (personID1 is student, personID2 is parent) |
Event Queue Detail
| Campus Table | Ed-Fi Action | Fields |
|---|---|---|
| relatedPair | Post/Put/Delete | The primary table used for sending data for this resource. |
| households | Put | LivesWith |
Object Data Elements
| Data Element Label | Business Requirement | Logic | M, C or O | Location |
|---|---|---|---|---|
id | The unique identifier of the resource. |
| M | |
| parentReference | A reference to the related Parent resource. | Reports the reference from the Parent record for the parent being reported. | M | |
| studentReference | A reference to the related Student resource. | Report the reference from the Student record for the student being reported. | M | |
| contactPriority | Indicates the numeric order of the preferred sequence or priority of contact. | Reports Emergency Priority of relationship. | O | Census > People > Relationships |
| 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. Data not collected in Campus. | O | |
| emergencyContactStatus | Indicator of whether the person is a designated emergency contact for the student. | This is optional. Does not report. | O | Census > People > Relationships > Emergency Priority relatedpair.seq |
| livesWith | Indicator of whether the student lives with the associated parent. | This is optional. Does not report. | O | Census > People > Households |
| primaryContactStatus | Indicator of whether the person is a primary parental contact for the student. | This is optional. Does not report. | O | Census > People > Relationships > 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. |
| O | Census > People > Relationships > Relationship relatedpair.name |
| LegalGuardian | This is optional. Does not report. | O | ||
| etag | A unique system-generated value that identifies the version of the resource. | O |
